Transporting Applications in Object Form › Object Transport Utility (IDUTOTRN) › How to Use the Object Transport Utility (z/OS or VSE)

How to Use the Object Transport Utility (z/OS or VSE)

Control statements, described later, are available to perform the various transport functions at the sending and receiving sites.

At the sending site, use the SELECT SYSTEM control statement to select the CA Ideal system associated with the programs you are transporting. Then use UNLOAD statements to copy the program onto a tape. Each UNLOAD copies:

• Program including all of its panels
• Application including a program, all CA Ideal subprograms required to run it, and their respective panels
• DB2 application plan and associated packages

The panels include prefix, suffix, and help panels. The unload step reads the object module for each program and panel or the source module for each plan and package specified in the UNLOAD control statements from the selected system's VLS library and writes it to the transport file. You can issue more than one UNLOAD in a run. You must re‑issue the SELECT SYSTEM only when the system changes.

At the receiving site, use the LOAD control statements to read the programs, panels, packages, and plans from the transport file. As with the unload step, you must SELECT the appropriate systems before programs are loaded. The systems at the sending and the receiving sites must be the same names. VLS library names are read from the Datadictionary. The object modules are written to the VLS libraries of the receiving system. You can load all of the programs, packages, or plans that were unloaded to the transport file with one LOAD ALL statement. Alternatively, you can load each application, program, package, or plan on the transport file individually.

During the load and unload steps, programs, packages, and plans are enqueued to protect against simultaneous update.

During the load step or in a separate step, you can use the PRINT INDEX control statement to print an index of the programs on the transport file. The listing includes a description that you can add during the unload step. Any non‑ideal subprograms required are listed with the index.

The SYSPRINT output from the Object Transport Utility shows the Datadictionary version number and date and time of compile for CA Ideal programs involved in an UNLOAD or LOAD, and the date and time stamp identifying when an UNLOAD job was run. Non‑ideal subprograms required by transported programs are listed as a reminder. You are responsible for transporting non‑ideal subprograms to the receiving system.