BACKUP VVDS

Use BACKUP VVDS to perform a backup of the VVDS of an ICF catalog structure.

You can request VVDS backup of a single volser, a range of volsers by mask, or all volumes in one or more storage groups. You can request the command to perform structure and integrity diagnostics of each VVDS prior to backup.

Syntax

Read syntax diagramSkip visual syntax diagramBACKUPVVDS(,dsnamevolservolsermask)INClude-Storagegroup(,stgrpstgrpmask)(,dsnamevolservolsermask)INClude-Storagegroup(,stgrpstgrpmask)OutDataset(,dsn)OutFILE(,ddname)SIMulateAccept-Diagnose(W)Accept-Diagnose(WEI)NODiagnose-VVDSDiagnose-VVDSDIAGnose-error-LIMit(16nn)Ignore-Diagnose-WarningDISPosition(Old)DISPosition(OldShr)EXClude-Storagegroup(,stgrpstgrpmask)EXClude-VVDS(,dsnamevolservolsermask)MeSsaGe-TeXT(FULL)MeSsaGe-TeXT(FULLNONE)PRinT(NONE)PRinT(NONEDATACOMPONENTNAME)NOREServeREServeVERBOSETERSE

BACKUP VVDS Command Syntax

Keywords

VVDS
specifies one or more VVDSs to backup by fully qualified or masked volume serial numbers.
INCLUDE-STORAGEGROUP
specifies one or more storage group names or storage group masks to backup.
OUTDATASET
You must allocate the data set(s) prior to running the BACKUP command. The data set(s) are allocated DISP=OLD. The DCB information is BLKSIZE=0, LRECL=32756 and RECFM=VB.
OUTFILE
specifies the JCL DD statement that contains the file specifications for the output backup file. This parameter allows you to allocate and define some of the physical file characteristics of the file at the time of the backup instead of in advance (as for OUTDATASET). Do not include any DCB information in the JCL.
SIMULATE
specifies that you want to trial the backup without actually performing it.
ACCEPT-DIAGNOSE
controls the continued processing of the backup based on the results of DIAGNOSE. The valid values are:
  • W—allows the backup to continue when warning messages (IDCAMS RC=4 or less) are issued. This is the default.
  • E—allows the backup to continue when error messages (IDCAMS RC=8 or less) are issued.
  • I—allows the backup to continue when informational messages (IDCAMS RC=0) are issued.
NODIAGNOSE-VVDS
specifies that an IDCAMS DIAGNOSE VVDS command is not run prior to running the BACKUP command.
DIAGNOSE-VVDS
specifies that an IDCAMS DIAGNOSE VVDS command is invoked prior to running the BACKUP command. IDCAMS DIAGNOSE is a catalog structure integrity checking tool. IDCAMS DIAGNOSE VVDS reads the entire VVDS, checking the integrity of every record, cell, and data field within it. The inter-cell relationships are checked, and cell relationship information among records is verified to ensure correctness and completeness. Since the COMPAREDS keyword is not specified, the associated BCS entries are not included in the diagnosis.
Note: If the DIAGNOSE operation indicates that there are structural errors, backup processing continues or terminates based on what is specified for ACCEPT-DIAGNOSE.
DIAGNOSE-ERROR-LIMIT
specifies the maximum number of errors generated by the IDCAMS DIAGNOSE command with the ERRORLIMIT keyword. The argument value specified must be numeric, and in the range 0 (zero) to 2,147,483,647, inclusive. The default is 16.
IGNORE-DIAGNOSE-WARNING
controls the result of the IDCAMS DIAGNOSE command when it terminates with a return code of 4 - only Warning messages issued. The actual IDCAMS return code is always shown in the Summary Report. If the IDCAMS return code is 4 and ACCEPT-DIAGNOSE(W) is specified, a warning message is issued and the product terminates with a return code of 4 if there are no other errors. If IGNORE-DIAGNOSE-WARNING is specified, a warning message will not be issued and the product will terminate with a return code of 0 if there are no other errors.
DISPOSITION
indicates the disposition value to use for the allocation of the input object.
  • OLD—issues the allocation with a disposition of OLD. This is the default.
  • SHR—issues the allocation with a disposition of SHR.
EXCLUDE-STORGAGEGROUP
specifies one or more storage group names or storage group masks to exclude from the backup. Only those objects that were originally included on the INCLUDE-STORAGEGROUP keyword can be excluded from the backup.
EXCLUDE-VVDS
specifies one or more fully qualified or masked volume serial numbers to exclude from the backup. Only those objects that were originally included on the VVDS keyword can be excluded from the backup.
MESSAGE-TEXT
controls the volume of IDCAMS messages printed during the backup. The valid values are:
  • FULL—indicates that all IDCAMS DIAGNOSE messages are to be displayed.
  • NONE—indicates that all IDCAMS DIAGNOSE messages are to be suppressed.
PRINT
specifies the level of printing to SYSPRINT during backup processing. Valid values are:
  • NONE—specifies that records are not printed during BACKUP processing. This is the default.
  • DATA—prints the component name and data of every processed record.
  • COMPONENTNAME—prints the component name of every processed record.
NORESERVE
indicates that access is not blocked and updates may occur during BACKUP processing.
RESERVE
indicates that access is blocked, preventing any updates during BACKUP processing.
VERBOSE
print all informational messages for each object processed. This is the default.
TERSE
print no informational messages for each object processed.

Usage notes

None.