DELETEVRS: Deleting vital record specifications

Purpose

Before you begin: To use the RMM DELETEVRS subcommand, you need CONTROL access to the STGADMIN.EDG.VRS resource profile to delete vital record specifications.

Use the DELETEVRS subcommand to delete a vital record specification. Specify the DSNAME operand to delete a data set vital record specification. To request that a vital record specification that matches both job name and data set name is deleted, specify JOBNAME and DSNAME. Specify the VOLUME operand to delete a volume vital record specification. Specify the NAME operand to delete a NAME vital record specification. When you delete a vital record specification in a chain, DFSMSrmm does not check whether it points to another vital record specification (with the NEXTVRS operand), or whether it is pointed to by another vital record specification.

When a vital record specification is deleted, no data set or volume information is changed. During the next vital records processing run, DFSMSrmm uses only the remaining vital record specifications to apply policies. If the data set or volume matches to another remaining vital record specification, DFSMSrmm applies those policies. If the data set or volume does not match to any vital record specifications, and is no longer retained by a vital record specification, the data sets are eligible for expiration processing.

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.

Format


>>-+-DELETEVRS-+------------------------------------------------>
   '-DS--------'   

>--+-DSNAME(data_set_name_mask)-+-----------------------+-+----><
   |                            '-JOBNAME(jobname_mask)-' |   
   +-NAME(VRS_name)---------------------------------------+   
   '-VOLUME(full_or_generic_volume_serial)----------------'

Parameters

DSNAME(data_set_name_mask)

Specifies a data set name mask defined in a vital record specification. You can specify a fully qualified, generic or GDG base data set name. The name is 1 to 44 characters in length and enclosed in quotes if any special characters are included. If the data set name is not enclosed in quotes, your TSO PROFILE PREFIX value is applied. This operand is required and must immediately follow the DELETEVRS subcommand.

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.

You can also specify an SMS management class name, a vital record specification management value, or the reserved data set name masks,ABEND, DELETED, or OPEN. An SMS management class name or a vital record specification can be eight alphanumeric characters, beginning with an alphabetic character, and must follow standard z/OS® data set naming conventions. This name must be a single qualifier, and is already assigned by your installation.

For example, specify DSNAME('M99000').

DSNAME is mutually exclusive with the NAME and VOLUME operands.

JOBNAME(jobname_mask)

Specifies a specific jobname or a jobname mask. A job name is one-to-eight alphanumeric characters or $, #, or @. Job name must start with an alphabetic character, $, #, or @. Use % to match any one character and * to match any character string in the mask. This operand is optional. Specify JOBNAME if you want to delete a vital record specification with a jobname mask.

NAME(VRS_name)

Specifies the one-to-eight alphanumeric or national character name of a vital record specification. DFSMSrmm does not check to see if this vital record specification is linked to another vital record specification. NAME is mutually exclusive with the DSNAME and VOLUME operands.

VOLUME(full_or_generic_volume_serial)

Specifies the serial number of the volume for which a vital record specification is defined. You can specify a full or a generic volume serial number. A full volume serial number is one-to-six alphanumeric, national, or special characters. A generic volume serial number is one-to-five alphanumeric, national, or special characters followed by an asterisk. Enclose it in single quotation marks if it contains any special characters.

VOLUME is mutually exclusive with the DSNAME and NAME operands.

Task: Delete the volume vital record specification for the volume 8E1U02.

Command:

  RMM DELETEVRS VOLUME(8E1U02)

Task: Delete a data set vital record specification that retained all backup data grouped by the creating job name.

Command:

  RMM DELETEVRS DSNAME('**.BACKUP') JOBNAME(*)

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.