Transporting Applications in Object Form › Object Transport Utility (IDUTOTRN) › Control Statements

Control Statements

Use the following control statements with the Object Transport Utility either at the sending site to select systems, unload programs and panels, record descriptions, and print indexes; or at the receiving site to select systems, load programs, and print indexes.

You can use standard CA Ideal abbreviations.

DESCRIPTION text

You can specify a DESCRIPTION statement before an UNLOAD statement to record a description of what is unloaded. The specified text description is copied to the transport file. Whenever that transport file is used during LOAD or PRINT INDEX processing, the text description prints out. You cannot specify the text in a DESCRIPTION statement beyond column 72 and cannot extend it over more than one line.

    		 {PACKAGE    }
	     {PLAN       }
	LOAD {PROGRAM    } pgmname
    		 {APPLICATION}
    		 {ALL        }

The LOAD statement copies programs, panels, packages, and plans from the transport file to the appropriate program object, and panel VLS libraries, and plan source libraries. With PROGRAM, it loads the previously unloaded program and the associated panels. With APPLICATION, it loads the previously unloaded program and any associated subprograms and panels. With ALL, it loads all applications and programs that were UNLOADed to the Transport file; that is, it copies the entire transport file to the VLS libraries. Applications and programs can only be LOADed if explicitly specified in the UNLOAD statement. For example, assume that the following statements created the transport file:

	SELECT SYSTEM $ID
	UNLOAD APPLICATION PGM1
	UNLOAD PROGRAM PGM3

Assume that PGM1 has a subprogram called PGM2. The only valid LOAD statements are as follows:

	SELECT SYSTEM $ID
	LOAD APPLICATION PGM1

	or

	SELECT SYSTEM $ID
	LOAD PROGRAM PGM3

	or

	LOAD ALL

The statement LOAD PROGRAM PGM2 is invalid since PGM2 is not explicitly specified in the UNLOAD statement. Also, the statements LOAD PROGRAM PGM1 and LOAD APPLICATION PGM3 are invalid.

You can record a description with the unload step. See the DESCRIPTION statement earlier in this section for more information.

PRINT INDEX

The PRINT INDEX statement lists the applications, programs and plans on the transport file. No copying to VLS libraries is done. Each UNLOADed application and program is listed with its component programs and panels.

The listed entries for the CA Ideal programs include the date and time of the last compile and the Datadictionary version number of the program. If the program was last compiled with a release of CA Ideal earlier than 1.2, the version number appears as N/A. Non‑Ideal programs that the applications and programs use are also listed.

• No enqueues are done.
• You can specify PRINT INDEX by itself or with LOAD statements.

SELECT SYSTEM sysid

The SELECT SYSTEM statement identifies the three‑character short system ID for the CA Ideal system associated with programs and applications to UNLOAD or LOAD. In the case of an UNLOAD or LOAD PROGRAM, it identifies the system for that program. In the case of UNLOAD or LOAD APPLICATION, it identifies the system for the program specified in the statement. If that program uses subprograms in other systems, they are also unloaded or loaded.

The SELECT SYSTEM statement applies to all subsequent UNLOAD or LOAD statements until another SELECT SYSTEM identifies a new system.

       	   {PACKAGE   }
    		   {PLAN       }
	UNLOAD {PROGRAM    } name
           {APPLICATION}

The UNLOAD statement copies programs, panels, packages, and plans from VLS program object libraries, panel libraries, and plan source libraries to the transport file. With PROGRAM, it copies the object module for the specified program and all of the panels (including main, prefix, suffix, and help panels) that program needs. With APPLICATION, it copies the object module for the specified program, all of the subprograms needed to RUN that program, and all of the panels used by all of the programs. With PLAN, it copies the source module for the specified DB2 application plan. With PACKAGE, it copies the source module for the specified DB2 package.