The Data Set Name control statement identifies explicit or pattern masked data set names to be controlled by VMS. This control statement is required and must begin in position 1 with DSN=ddd. The data set name (ddd) may be from 1 to 44 characters. If the data set name contains special characters (other than masking characters), it must be enclosed within single quotes, such as 'ABC$'. If any of the special characters in the data set name match a masking character, the character must be immediately preceded by a back slash (\). If you are specifying the entire data set name for a GDG do not put a "-" at the end to mask the "GnnnnVnnn" portion on the n ame. Reference the Programming Guide for complete details. Valid pattern masking characters do not need to be enclosed in single quotes. Any valid pattern mask may be specified for the data set name. You can specify any number of DSN= statements on a Vault Pattern control statement describing the desired movement.
You can optionally use keywords to reduce the number of entries in the VPD and change the movement criteria. For Generation Data Groups (GDGs), do not specify the generation/version number or relative generation because VMS does not consider the generation number during processing. If you wish to treat ABARs created tapes the same as GDGs, the system option ADGDG should be set to YES. This option allows the pseudo GDGs (CnnVnnnn) to be treated the same as regular GDGs (GnnnnVnn). The format for the Data Set Name control statement is:
1 5
DSN=ddd[,keyword,...,keyword]
Keyword Definitions
Select data set even if the Closed by Abend indicator is on.
A complete, qualifying creating job name. The job name may be from one to eight characters and must be the complete job name, or pattern masking may be used. If the job name contains special characters (#, @, $, and so on), do not enclose it in delimeters. Only data sets created by job jjj are to be vaulted.
Vault separately by complete data set name the tapes that meet index criteria. This keyword is only meaningful when the DSN value is a high-level character string (ddd-). This does not apply to unique generations of a GDG under the same DSN.
Vault by creating job name. Multiple jobs that create the same data set will have a separate retention based on the job name. This keyword cannot be used with JOB=jjj.
VMS must recalculate the vaulting requirements for the data set because the requirements have changed. Remove the REDEFINED keyword once the new vaulting environment is established. If the REDEFINED keyword is left on a statement once redefinition has occurred, it creates extra overhead in VMS processing time and can result in unnecessary reslotting of volumes.
Note: When using REDEFINED to change vault location IDs, be sure to have the old and new vault IDs in the VAULTS= statement. If the old ID is removed prior to the REDEFINED, the tapes in that location are ignored by the TMSVMEDT.
Reverse movement through the vaults if earlier cycles are permanently removed from vault storage. Remove the BACKWARD keyword once the cycles are reset.
Examples:
DSN ABC is controlled by VMS.
DSN ABC, if created by job jjj, is controlled by VMS.
ABC are the leading characters of the matching DSN, and all tapes with this match are controlled by VMS.
Each DSN under the ABC- character string is controlled separately. SEPDSN is meaningful only when the DSN value is a high-level character string.
Each creating job name for DSN ABC is controlled separately. If both JOB= and SEPJOB are specified, SEPJOB is ignored. SEPJOB can be used with SEPDSN.
The vault pattern is being changed and should be recalculated with the next VMS execution. Remove this option once the change is established.
A tape has been prematurely and permanently removed from a vault, and the pattern should be recalculated to fill in the empty slot. Remove this option once the change is established.
|
Copyright © 2013 CA Technologies.
All rights reserved.
|
|