ALLDUMPS and BACKUPCONTENTS: Determining existence of dumps or listing incremental backup contents

Explanation: ALLDUMPS and BACKUPCONTENTS(nn) are optional parameters you specify to determine the existence of all full-volume dumps and to determine the contents of the user volume at the time of incremental backup.

ALLDUMPS
is specified to determine the existence of all volume dumps and on which dump volumes the dumps exist for a single level 0 or migration level 1 volume. The following information is provided for each selected dump:
  • Source volume serial number
  • Copy pool dump generations
  • Dump class
  • Dump date
  • Dump time
  • Dump relative generation number
  • Dump expiration date
  • Volume serial numbers of the set of volumes containing the dump
BACKUPCONTENTS(nn)

when used with the PRIMARYVOLUME(volser) parameter, is specified to list the contents of the user volume when the latest or next-to-latest backup of (volser) was made. For nn, substitute a 0 or 1 to indicate whether the latest or the next to latest backup volume table of contents (VTOC) is listed. A 0 (zero) indicates the latest. A 1 (one) indicates the next latest.

The listing is from the requested VTOC data set. If 0 is specified, the listing represents the contents of the user volume at the time when the last incremental backup was done.

BACKUPCONTENTS, when used with the PRIMARYVOLUME(volser) parameter, is not processed for volumes that have not been incrementally backed up by DFHSM 2.3.0 or a subsequent release. This happens because the VTOC copy data set is not on a migration level 1 volume for incremental volume backups performed by previous releases of DFSMShsm. With the PRIMARYVOLUME, the listing can include data sets that are not eligible for incremental backup by DFSMShsm. In addition to information provided for this variation of the command, the following information is provided:
  • Data set name
  • Data set organization
  • Date of last reference to data set
  • Data set creation date

Defaults: If you do not specify a 0 or 1 for nn, the default is 0 (list the latest backup VTOC copy data set). If you specify any value other than 0 or 1, the default is 0.

Note:
  1. BACKUPCONTENTS is meaningful only when volser is specified with the PRIMARYVOLUME parameter.
  2. The BACKUPCONTENTS parameter is not equivalent to the DUMPCONTENTS parameter.
  3. BACKUPCONTENTS is ignored when DUMPVOLUME is specified.
  4. ALLDUMPS is valid with PRIMARYVOLUME and VOLUME when specified with volser and with BCDS.
  5. Since DFSMShsm does not handle partitioned data set members individually, the entire partitioned data set will be listed.