VBACKUP/VRECOVER › VBACKUP Function › VBACKUP Command and Parameters

VBACKUP Command and Parameters

The VBACKUP command syntax is:

VBACKUP	DSNENQ=,RESERVE=,RETPD=,EXPDT=,RPT=,LSTAR,PACK

DSNENQ=

This parameter defaults to SHR, which will issue an enqueue for every data set on the volume. If CA Disk cannot obtain an enqueue, it will continue processing, but will issue a message to identify the data set, and set the Flag1 field in the DSNINDEX record to X'01' to indicate that the volume was backed up without complete enqueue integrity. This parameter is ignored for Offline VBACKUPs and the setting of the Flag1 field in the DSNINDEX record will depend on the value of the RESERVE= parameter.

If this parameter is set to NONE, CA Disk will not issue enqueues for the data sets, but will set the Flag1 field in the DSNINDEX record to X'01' to indicate the lack of integrity.

RESERVE=

This parameter defaults to YES, which causes CA Disk to issue a hardware reserve and VTOC enqueue. If this parameter is set to NO, CA Disk will not issue the hardware reserve and the VTOC enqueue, and the DSNINDEX record Flag1 field is flagged as X'01' to indicate the lack of integrity.

RETPD=

This parameter and the EXPDT parameter are mutually exclusive and have the same meaning as the identical parameters used for data set-level processing.

Specify a one- to five-digit number to indicate a retention period to be assigned to the volume-level archive data sets. If this parameter is omitted, a default retention period value is obtained from sysparm RETRETPD.

Note: The expiration date for the ARCHVOL is determined by the sysparm DYNEXPDT, described in DYNEXPDTE99365 in the Systems Guide.

For more information, see the section Year 2000 Considerations in the chapter "General Information."

EXPDT=

This parameter and the RETPD parameter are mutually exclusive and have the same meaning as the identical parameters used for data set-level processing.

Specify an expiration date in an accepted CA Disk format to designate the period of time the data set will remain archived. If this parameter is omitted, a default retention period value is obtained from sysparm RETRETPD.

Note: The expiration date for the ARCHVOL is determined by the sysparm DYNEXPDT, described in DYNEXPDTE99365 in the Systems Guide.

For more information, see the section Year 2000 Considerations in the chapter "General Information."

RPT=

Specify this parameter with a value of MAP to produce a report for each DASD volume processed. This report will include information such as data set names and extents. If you specify a value of NONE, which is the default value, no report will be produced.

LSTAR

If this parameter is supplied, the volume-level backup processing will include only the used tracks in physical sequential and partitioned data sets, as defined by the LSTAR value in each data set's format-1 DSCB.

If this parameter is not supplied, the volume- level backup processing will include all allocated tracks on the DASD volume.

PACK

By default, VBACKUP keeps DASD volumes separated onto their own ARCHVOLS. For example, the following command will create 3 ARCHVOLS:

SCAN REALVOLS
   SELECT VOLUMES=(DASD01,DASD02,DASD03)
      VBACKUP RETPD=180

Specifying this parameter results in multiple DASD volumes being combined onto the same ARCHVOL. For example, by adding PACK to the previous command, all 3 volumes will be backed up onto the same ARCHVOL.

Note: This parameter is ignored when sysparm ARCHPACK, described in ARCHPACKy in the Systems Guide, is specified with a value of N.