CHANGEVRS: Changing information about a vital record specification

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.