Job Control Statements

Utilities and Procedures › CTSSYNC - 3495/3494 Tape Library Data Server Synchronization Utility › Job Control Statements

Job Control Statements

//stepname EXEC PGM=CTSSYNC,PARM='parm'
//STEPLIB DD DISP=SHR,DSN=CAI.CTAPLINK
//SYSPRINT DD SYSOUT=*     *NOTE 1
//ERREPORT DD SYSOUT=*     *NOTE 2
//EXPORT DD DSN=EXPORT.TAPE.LIST,   *NOTE 3 *NOTE 6
  UNIT=VTAPE,TRTCH=NOCOMP,DISP=(,CATLG)
//IMPORT  DD DSN=IMPORT.TAPE.LIST,   *NOTE 4 *NOTE 6
  UNIT=VTAPE,TRTCH=NOCOMP,DISP=(,CATLG)
//SYSIN DD *      *NOTE 5
(control statements here)
/*

Note 1:

The SYSPRINT DD is optional. If coded, CTSSYNC writes the standard (or full) report to this file. The standard report produces a detail list of the requested commands for each volume and the results of those requests. When the command is for a range of volumes a line is listed for each volume. For SYNC commands the results of the tape management query is also shown.

Note 2:

The ERREPORT DD is optional. If coded, an errors-only report is produced. This report is in same format as the standard report.

Note 3:

The EXPORT DD is required for use by the EXPORT command. CTSSYNC writes all the files required by the 3494/VTS for an EXPORT operation to the virtual tape defined by this DD statement. If no export commands are specified, then this DD is NOT used. Do not specify 'VOL=(,RETAIN)' on this DD statement. See Note 6.

Note 4:

The IMPORT DD is required for use by the IMPORT command. CTSSYNC writes all the files required by the 3494/VTS for an IMPORT operation to the virtual tape defined by this DD statement. If no import commands are specified, then this DD is NOT used. Do not specify 'VOL=(,RETAIN)' on this DD statement. See Note 6.

Note 5:

The SYSIN DD is optional. The commands can be entered by using the SYSIN control statements, or by coding them as parameters after the PARM= statement, or by passing a parameter list with the use of register 1. Commands are free-form, but the entire command line must be on a single line between columns 1 and 71. Spaces and commas are delimiters. Comments must have the form /* comment text */. They can appear anywhere within a command or on a line by themselves.

Note 6:

Do not specify 'VOL=(,RETAIN)' on this DD statement. Specifying VOL=(,RETAIN) will cause the IMPORT/EXPORT list volume to remain on the tape drive. The robot does not consider the list volume available if it is mounted, so the IMPORT/EXPORT invoked by CTSSYNC will fail.

Note 7:

The CTSSYNC utility cannot be used with 3495/3494 BTLS devices.