Template Programming Interface Guide › Restore Job Template Files › INPUT Record

INPUT Record

REQUIRED

In a VOLSEARCH restore job template file, use the INPUT record to specify the volser and copy number of a tape from which to restore data. The volser should be one of the first volsers from one of the streams in the most recent backup that falls within the time period the job specifies. The record can also specify the data set sequence number (DSSN) of a data set that contains data for the job to restore and the media and density of the tape.

If this record does not specify the density or media for a tape, CA VM:Backup determines the density and media to use.

At least one INPUT record that defines the primary input tape is required in a file. A file can include multiple INPUT records, but you can specify each parameter only once for each tape copy. You can include more than one parameter on an INPUT record; however, you can specify each parameter only once for each record.

INPUT number {“Parms”}

Parms: 

  DSSN number
| MEDIA type
| DENSITY densityname
| VOLSER volser

Definitions

number

Specifies the copy number for the input tape. You can enter primary or 0 for the primary copy, and 1, 2, 3, or 4 for the other copies. The number does not have to match the copy number assigned during the backup job.

DSSN number

Specifies the DSSN of a data set on the input tape that contains data the job is to restore. The default is 1. You must specify 1 for number. Authorized clients can enter an integer from 1 through 9999 for number.

MEDIA type
DENSITY densityname

Specifies the media type, recording density, or both for the input tape. For values, see the section Enhanced Device Recognition Support in the chapter "Managing Tape and DASD Resources" in the System Programmer Reference Guide.

If MEDIA is specified but not DENSITY, the job uses the default density (underlined ) for the specified media type. If DENSITY is specified but not MEDIA, the job uses the media type listed above for the specified density name.

If any density other than 38K, 6250, 1600, or 800 is specified for a DASDtape, the tape is actually written at a density of 38K.

VOLSER volser

Specifies the volser of the input tape.

Example

You want to specify a 38K density cartridge named BACK04 as the first tape of a stream in the most recent backup that falls within the time period specified in a VOLSEARCH restore job. Include the following INPUT record in the VOLSEARCH restore job template file:

INPUT 0 VOLSER BACK04 MEDIA CART DENSITY 38K