DELETEDATASET: Deleting data set information

Purpose

Before you begin:

To use the RMM DELETEDATASET subcommand, you need CONTROL access to the STGADMIN.EDG.MASTER resource profile.
To use the RMM DELETEDATASET FORCE subcommand, you need CONTROL access to the STGADMIN.EDG.MASTER resource profile and UPDATE access to the STGADMIN.EDG.FORCE resource profile.

Use the DELETEDATASET subcommand to delete data set information recorded by DFSMSrmm. DFSMSrmm also uncatalogs the data set and any other data sets recorded on the same volume that have higher data set sequence numbers. You specify the data set name and the serial number of the volume where the data set resides.

You must also specify a sequence number if the data set for which you are deleting information is not the first data set on the volume. If you do not specify a sequence number, DFSMSrmm assumes that the data set is the first file on the volume. Unless the data set for which you are deleting information is the last data set on the volume, DFSMSrmm deletes information about all subsequent data sets on the volume.

Restriction: You cannot delete any data set on a volume when DFSMSrmmhas recorded information about the data set during O/C/EOV processing.

Format


>>-+-DELETEDATASET-+--data_set_name--VOLUME(volume_serial)------>
   '-DD------------'                                         

>--+----------------------------------------------+------------->
   |          .-1-----------------------------.   |   
   '-FILESEQ(-+-physical_file_sequence_number-+-)-'   

>--+-----------+-----------------------------------------------><
   |       (1) |   
   '-FORCE-----'

Notes:

Specify the FORCE operand to delete a data set for a volume where information was recorded by DFSMSrmm during O/C/EOV processing. You must have CONTROL access to the STGADMIN.EDG.MASTER security resource and UPDATE access to the STGADMIN.EDG.FORCE security resource to use the FORCE operand.

Parameters

data_set_name

Specifies the name of the data set being deleted. 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 DELETEDATASET 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.

FILESEQ(physical_file_sequence_number)

Specifies the relative position of the data set on the volume. The minimum allowable decimal value is 1. The maximum allowable decimal value is 65535.

The default value is 1.

FILESEQ can be abbreviated as SEQ.

FORCE

Specifies to override the restriction that information that DFSMSrmm recorded during O/C/EOV processing cannot be changed. Using FORCE allows you to delete data set information that DFSMSrmm recorded during O/C/EOV processing. To use this operand you must have CONTROL access to STGADMIN.EDG.MASTER security resource and UPDATE access to STGADMIN.EDG.FORCE security resource.

VOLUME(volume_serial)

Specifies the serial number of the volume where the data set resides. A volume serial number is one-to-six alphanumeric, national, or special characters. Enclose it in single quotation marks if it contains any special characters. A volume serial number is required.

Task: Delete information about all data sets residing on volume 8E1U01. The data set PREFIX.MYDATA.DATA is the first data set on the volume.

Command:

  RMM DELETEDATASET 'PREFIX.MYDATA.DATA' VOLUME(8E1U01)

Task: Delete information about a data set named PREFIX.MYDATA.DATA that is the fourth data set on volume 8E1U01, and also delete information about all subsequent data sets on the volume.

Command:

  RMM DELETEDATASET 'PREFIX.MYDATA.DATA' VOLUME(8E1U01) SEQ(4)

If prefix is your own TSO PROFILE PREFIX, you can enter:

  RMM DELETEDATASET MYDATA.DATA VOLUME(8E1U01) SEQ(4)

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.