LISTDATASET: Displaying information about a data set

Purpose

Before you begin: To use the LISTDATASET subcommand:

You need READ access to the STGADMIN.EDG.MASTER resource profile.
In addition, if COMMANDAUTH(DSN) is in effect, you need READ access to the data set name in the DATASET class.
When the RACF® SETROPTS MLNAMES command has been used to activate the name-hiding function, or when COMMANDAUTH(DSN) is in use, to list and search all entries independent of the access granted to the DATASET and TAPEVOL class, you need either CONTROL access to the STGADMIN.EDG.MASTER profile resource or CONTROL access to the STGADMIN.EDG.LIST profile resource.

Related Reading: See z/OS DFSMSrmm Implementation and Customization Guide for information about using the DFSMSrmm parmlib OPTION COMMANDAUTH command and authorizing the use of the DFSMSrmm subcommands.

Use the LISTDATASET subcommand to display information about a single data set defined to DFSMSrmm. You must specify the data set name and the volume serial number where the data set resides. If the data set is not the first data set on the volume, you must also specify a sequence number.

The output from the LISTDATASET subcommand includes:

The creating job name
Data set retention date
Storage group
Storage class
Data class
The matching VRS type:
- DATASET type indicates that the data set is retained by a DSNAME type vital record specification.
- SMSMC type indicates that the data set is retained by a vital record specification that matches its SMS management class.
- VRSMV type indicates that the data set is retained by a vital record specification that matches its VRS management value.
- DSN/MV type indicates that the data set is retained by a DSNAME type vital record specification and a management value VRS defined with WHILECATALOG.
The matching VRS name
Vital record status

Use the SEARCHDATASET subcommand to list all data sets on a volume. See SEARCHDATASET: Creating a list of data sets for more information.

Format


>>-+-LISTDATASET-+--data_set_name--VOLUME(volume_serial)-------->
   '-LD----------'                                         

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

Parameters

data_set_name

Specifies the name of the data set about which you want to view information. 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.

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.

This operand is required and must immediately follow the LISTDATASET subcommand.

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.

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. This operand is required.

Examples

Task: Display information recorded by DFSMSrmm for a data set named NISHINAL.TEST.ORDER that resides on volume BC0047 and is the first data set on the volume.

Command:

  RMM LISTDATASET 'NISHINAL.TEST.ORDER' VOLUME(BC0047) SEQ(1)

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

RMM LISTDATASET TEST.ORDER VOLUME(BC0047)

Output: DFSMSrmm displays output such as that shown in Figure 1:

Figure 1. Sample LISTDATASET output

Data set name = NISHINAL.TEST.ORDER
Volume        = BC0047                Physical file sequence number = 1
Owner         = RMMUSER                           Data set sequence = 1
Create date   = 02/20/2012 Create time = 06:16:06 System ID         = W98MVS1
Expiration date       = 02/20/2012 Original Expir. Date  = 02/20/2012
       Set by         = OCE_RETPD
LASTREF extra days    = 14
Block size            = 80         Block count           = 3456789012
Data set size(KB)     = 256
Physical size(KB)     = 512        Compression           = 3.00          
Percent of volume     = 0          Total block count     = 12345678901234567890
Logical Record Length = 80         Record Format         = FB
Date last written     = 02/20/2012 Date last read        = 02/20/2012
Job name              = RMMUSERJ   Last job name         = RMMUSERJ
Step name             = WRITE1     Last step name        = READ1
Program name          = TAPEIO     Last program name     = IEBGENER
DD name               = TAPE       Last DD name          = SYSUT1
Device number         = 0911       Last Device number    = 0910
Management class      =            VRS management value  =
Storage group         =            VRS retention date    =
Storage class         =            VRS retained          = NO
Data class            =            Closed by Abend       = NO
                                   Deleted               = NO
VRSEL exclude         = NO         Catalog status        = UNKNOWN
Primary VRS details:
       Name           =
       Job name       =            Type                  =
       Subchain NAME  =            Subchain start date   =
Secondary VRS details:
       Value or class =
       Job name       =
       Subchain NAME  =            Subchain start date   =
Security Class   =            Description   =
BES key index    = 0 

Last Change information:                                           
Date             = 02/20/2012  Time = 08:30:59  System  = EZU0000  
User change date = 02/20/2012  Time = 08:30:59  User ID = RMMUSER

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.