Purpose
Before you begin: To use the RMM CHANGEVRS subcommand, you need CONTROL
access to the STGADMIN.EDG.VRS resource profile to change vital record
specifications.
Use the CHANGEVRS subcommand to update
details of a DSNAME or a NAME vital record specification that is already
defined to DFSMSrmm.
When a vital record specification
is changed, no data set or volume information is changed. During the
next vital records processing run, DFSMSrmm uses the defined vital
record specifications to apply policies. If the data set or volume
matches to the changed vital record specification, DFSMSrmm applies
the changed policies.
When you add, change,
or delete a vital record specification, you should run VRSEL with
the VERIFY option, as described in Maintaining your vital record specifications.
Use the SEARCHVRS subcommand to create lists of vital
record specifications. See SEARCHVRS: Creating a list of vital record specifications for
more information.
Format
>>-+-CHANGEVRS-+------------------------------------------------>
'-CS--------'
>--+-DSNAME(data_set_name_mask)-+-----------------------+-+----->
| '-JOBNAME(jobname_mask)-' |
'-NAME(VRS_name)---------------------------------------'
>--+--------------------------+--------------------------------->
'-COUNT(---days/cycles---)-'
>--+------------------------------+----------------------------->
'-NEXTVRS(---next_VRS_name---)-'
>--+-----------------------+-----------------------------------><
'-TZ({+|-}HH[:MM[:SS]])-'
Parameters
- DSNAME(data_set_name_mask)
- Identifies the type of vital record specification and specifies
the mask of a data set name, management class, or management value
of an existing vital record specification. The mask can have a fully
qualified or a generic name. It can also be one of the reserved words
ABEND, DELETED, or OPEN.
The data set name mask is 1 to 44 characters,
enclosed in quotes if any special characters are included. If the
data set name mask is not enclosed in quotes, PROFILE PREFIX is applied.
This operand is required and must immediately follow the CHANGEVRS
subcommand.
DSNAME is mutually exclusive with the NAME and
VOLUME operands.
Note: DFSMSrmm does not fold data set names to
uppercase letters when you specify quoted data set names. When you
specify data set names or data set name masks, be sure to specify
the correct case for each character. If you create VRS data set name
masks with lowercase or mixed case letters, these will not match to
data sets with all uppercase characters.
- NAME(VRS_name)
- Identifies the vital record specification type and specifies a
name for the vital record specification. A vital record specification
name is eight alphanumeric characters chosen by your installation.
- JOBNAME(jobname_mask)
- Identifies the job name for the vital record specification. A
job name is one-to-eight alphanumeric characters, $, #, or @. You
can specify a specific job name or a job name mask. It can also be
one of the reserved words ABEND, DELETED, or OPEN.
This operand
is optional. You must specify the operand, though, if the vital record
specification you want to change has the JOBNAME operand specified.
If you have data sets with job names that include symbols other
than alphanumeric characters, $, #, or @, use a job name mask to cover
them.
- COUNT(days/cycles)
- Specifies a retention amount, based on the retention type of the
existing vital record specification. Specify COUNT(number_of_days)
to request that DFSMSrmm retains all cycles or copies of a data set.
Specify COUNT(number_of_cycles) to request that DFSMSrmm retains the
number of data set cycles you specify.
The value range for data
set name vital record specification and retention name vital record
specification is 0 to 99999. A value of 99999 indicates that DFSMSrmm
retains all cycles of a data set.
If count() is not specified,
the count value in the existing vital record specification record
is not changed.
DFSMSrmm validates the COUNT value as follows:
- If EXTRADAYS is specified, COUNT must equal STORENUMBER: (STORENUMBER)
= (COUNT).
- Regardless if NEXTVRS and ANDVRS are used, COUNT can be: (STORENUMBER)
<= (COUNT).
- If DAYS or LASTREFERENCEDAYS retention is used: (STORENUMBER)
+ (DELAY) <= (COUNT).
- NEXTVRS(next_VRS_name)
- Specifies the name of the next vital record specification in a
chain of vital record specifications. If you specify the name of a
vital record specification that does not exist, DFSMSrmm uses a dummy
vital record specification with the name '*broken*' instead. This
keeps the volume or data set in its current location.
- TZ({+|-}HH[:MM[:SS]])
- Specifies the time zone offset when date and time values are specified.
The format is {+|-}HH[:MM[:SS]] where:
- +|- is the offset direction. Specify + to indicate that
the offset is East of the zero median (UT). Specify - to indicate
that the offset is West of the zero median (UT). The offset direction
is required.
- HH is hours
- MM is minutes
- SS is seconds
An optional colon (:) separates hours from optional minutes
and optional seconds.
You can specify a time in the range between
00:00:00 to 15:00:00 for HH:MM:SS. MM and SS value range is 00 to
59.
Return codes
See DFSMSrmm return codes and reason codes for DFSMSrmm reason codes.
- 0
- Subcommand completed normally.
- 4
- Warning. Subcommand completed but some operands could have been
ignored or modified. DFSMSrmm sets a reason code.
- 8
- User not authorized.
- 12
- Subcommand ended with an error. DFSMSrmm sets a reason code.
- 16
- Error. The DFSMSrmm subsystem is not active.
- 20
- Error. The data is incomplete or incorrect and the TSO user has
set NOPROMPT.
- 24
- The TSO subcommand is not APF authorized.
- 28
- The user pressed the attention key.