Previous Topic: Data Set Name Control StatementNext Topic: Vault Pattern Control Statement

Utilities › TMSVMEDT Utility—Validate the Vault Pattern Description Data Set › Control Statement Specification › VOLUME or Cataloged Data Set Name Control Statements

More information:

Job Control Statements

VOLUME or Cataloged Data Set Name Control Statements

The VOLUME (VOL=) and Cataloged Data Set Name (CDSN=) control statements designate specific volumes or volume sets that are to be moved to an off-site location without regard to the rules specified in Data Set Name control statements (DSN=).

1   5

VOL=vvvvvv[-vvvvvv,keyword=value]

1    6

CDSN=ddd

Keyword Definitions

RTS=xxx

Specifies when to select stacking volumes for vault movement. IMMED is the default. If you specify RTS=IMMED or if you omit RTS=, you specify the volumes for vault movement when one or more active data sets are found. If xxx is FULL, you select stack volumes for vault movement only when the Realtime Stacking component of CA 1 flagged the volumes as full. You can specify the RTS= parameter only on the VOL= control statement. The parameter is ignored for nonstack volumes. The TMC volume record TMFLAG5 bit x'80' (keyword STF) indicates that the volume is a stack volume. TMFLAG4 bit x'01' (keyword SNO) indicates that the volume is full and no further stacking is to be done.

The VOLUME or Cataloged Data Set Name control statements differ from the Data Set Name control statements in three ways.

  1. The VOLUME (VOL=) or Cataloged Data Set Name (CDSN=) control statements identify explicit volumes to be shipped to a single vault location. These explicit rules take precedence over Data Set Name (DSN=) control statements and are used in cases where a specific volume needs to be sent offsite. If the CDSN= control statement is used, a catalog lookup is performed and the statement is turned into a VOL= statement internally for the volume that is returned from the MVS catalog. If the VOL= statement (either explicitly stated or implied) is part of a multivolume chain, all volumes in the chain are moved together. If the CDSN= control statement is used, use an explicit data set name. For Generation Data Groups (GDGs), either specify the explicit GDG number, or the relative generation. The current generation is obtained from the catalog when TMSVMEDT is run, causing a new volser to be selected for vaulting. As a result, the previous VOLSER is returned from the vault. If the VOLSER requested is already vaulted, it is moved to the vault associated with the VOL= or CDSN= statements.

    Note: If you specify CDSN=, the specified data set name is not cataloged, and you do not specify the IGNERRS parameter, a U4000 abend occurs.

  2. The RTS keyword is the only extra keyword that you can use with the VOLUME control statement. By definition, only the specified volumes are sent off-site or left off-site, regardless of the abend indicator or jobname. The Cataloged Data Set Name control statement does not support any keywords.
  3. Movement is only to the first off-site location that the following Vault Pattern control statements specify. The volumes remain at that location until you remove the VOLUME or Cataloged Data Set Name control statement from the VPDD. When you remove the VOL= or CDSN= statement, the volser is moved back to the library. If the DSN on the tape matches another rule, the DSN is moved to that vault location.

Example:

VOL=123456                    Volume 123456 and all volumes chained
                              to it will be moved to the off-site
                              location that is specified in the
                              first Vault Pattern control statement
                              following this statement.

VOL=111122-111133             The volume range of 111122 through
                              111133 will be sent to the vault.

VOL=445000-446000,RTS=IMMED   The volumes in range 445000 through
           or                 446000 with one or more active data
VOL=445000-446000             sets are to be selected for movement
                              to the vault. Stack volumes with one
                              or more files are vaulted immediately,
                              that is, they do not have to be marked
                              full before vaulting.

VOL=200100-200200,RTS=FULL    Volumes in the range 200100 through
                              200200 with the stack bit on (TMFLAG5
                              x'80', keyword STF) will be selected
                              for vault movement only if the full bit
                              (TMFLAG4 bit x'01', keyword SNO) is
                              also on. Volumes in the range with the
                              stack bit off will be selected for vault
                              movement if the volume contains one
                              or more active data sets.

CDSN=PAYROLL.MASTER.G0018V00  The volume that generation 18 of the
                              PAYROLL.MASTER file resides on, and all
                              volumes chained to it, will be moved to
                              the off-site location that is specified
                              in the first Vault Pattern control
                              statement following this statement.

Notes: