Template Programming Interface Guide › Backup Job Template Files › OUTPUT Record

OUTPUT Record

REQUIRED

Use the OUTPUT record to specify information about an output tape to which the job is to write data.

At least one OUTPUT record that defines the primary output tape is required in a file. You can include as many OUTPUT records as you need in a file, but you can specify each parameter only once for each tape copy. You can include more than one parameter on an OUTPUT record; however, you can specify each parameter only once for each record.

OUTPUT number {“Keywords”}...

Keywords:

  DSN name
| DSSN number
| EXPDT PERM
| OWNEDBY userid
| POOL poolname
| RETPD number
| VOLSER volser

Definitions

number

Indicates the copy number of the output tape. Specify primary or 0 for the primary copy, and 1, 2, 3, or 4 for the other copies.

DSN name

Specifies the data set name the job is to write in the output volume label. The data set name can contain up to 44 characters, both alphanumeric (A-Z, 0-9) and special characters: period (.), at sign (@), pound sign (#), and dollar sign ($). The default is VMBACKUP.PRIMARY for the primary copy, and VMBACKUP.COPYn for copies 1, 2, 3, and 4, where n is the number of the copy.

Although you can specify up to 44 characters, to conform to OS standard tape label support, only the last 17 characters of the data set name are written to the tape label. If you use CA VM:Tape, the full data set name (up to 44 characters) will be cataloged in the CA VM:Tape TMC, but the tape label will still contain only the last 17 characters.

DSSN number

Specifies the data set sequence number (DSSN) of the data set to which the job is to write backup data. The default is 1. You must specify 1 for number. Authorized clients can specify an integer from 1 through 9999 for number.

Note: The DSSN parameter is available only through TPI. However, using it will not prevent you from managing the job template file through the CA VM:Backup screens.

EXPDT PERM

Indicates that the output tape is a permanent tape. Only authorized clients can specify EXPDT PERM. Jobs created by other users must use the RETPD parameter.

Note: This parameter is available only through TPI and can only be specified by an authorized client.

OWNEDBY userid

Identifies the user ID that owns the output tape. Only authorized clients can specify the OWNEDBY option. If OWNEDBY is not specified, the user ID of the CA VM:Backup service virtual machine owns all tapes used by the job.

Note: This parameter is available only through TPI and can only be specified by an authorized client

POOL poolname

Identifies the resource pool from which the job is to select the output tape. You can use 1-8 alphanumeric characters for poolname. If CA VM:Backup is interfaced with CA VM:Tape and you are specifying a CA VM:Tape pool, you can use up to 16 alphanumeric characters.

RETPD number

Specifies the number of days to retain the tapes created by the back up job. Specify an integer from 0 through 5000 for number. The default is 30.

VOLSER volser

Specifies the volser of the first output tape. Only authorized clients can specify the VOLSER option.