3 1 High Speed Partition Export to Tape

3.1 High Speed Partition Export to Tape

Functional Description

Library QTEMP is cleared.

This program receives the identifier of a partition and copies all required data from the LANSA data library to temporary files in library QTEMP.

When all data has been copied to QTEMP a merged list of the following is created. Partition module library, partition default file library, and all other specified libraries. The merged list is then stored in a data area in QTEMP as a "directory" of what should be found on the export tape. This data area is called OS@DIR.

If the partition has IFS objects, the IFS objects are first saved into a save file named IFS_SAVF in QTEMP. This save file is then saved together with all the other objects copied to QTEMP.

All objects from QTEMP are saved to the tape device specified, followed by all libraries in the resulting merged list. Once this operation has completed a message is sent to the system operator asking whether a repeat of all save operations is required (i.e., Do you want another copy?). This allows multiple save tapes to be easily prepared from one export run.

Name OS@P0001 Type ILE Control Language Program Source provided Yes

  Files Used

All files in the <<dtalib>> are used by this job.

Warnings That Apply

• Remember The Golden Rule.

• You must back up <<dtalib>> before using this utility.

• <<osulib>> must be in the library list when running this job.

• The partition specified must exist.

• This routine does not do any security checking.

• No one should be using the partition at the time of export.

• Tapes are not initialized by the export operation.

• This program is best run in batch.

• <<pgmlib>> must be in the library list when running this job.

• If the target release is anything other than *CURRENT, ensure that all objects being saved have been created so that they are compatible with this target release.

Parameters

No Type Len Dec Description 1 Alpha 3   Identifier of partition to be exported. 2 Alpha 10   Name of tape device to be used for export. 3 Alpha 8   Indicates the TGTRLS that the save will use. Valid values include: "*CURRENT" "*PRV" "*VxRyMz" where "VxRyMz" is a valid OS/400 version. If left blank, the target release used is *CURRENT, not the default for the command. 4 Packed 15 5 Number of extra libraries to be saved. 5 Alpha 200   List of 20 x alpha(10) extra libraries. This list and the partition module library and default file library are merged to form the final list of libraries to be saved.

  Examples

Export partition DEM to TAP01 for current target release and no other libraries.

CALL OS@P0001 (DEM TAP01 '*CURRENT' 0 ' ')

Export partition DEM to TAP01 for previous target release and also library <<comlib>>.

CALL OS@P0001 (DEM TAP01 '*PRV' 1 <<comlib>>)

Export partition DEM to TAP01 for target  release V3R7M0 and also libraries <<comlib>> and TEST.

CALL OS@P0001 (DEM TAP01 'V3R7M0' 2 '<<comlib>>      TEST      ')

where six spaces follow <<comlib>> and TEST.