LISTVOLUME: Displaying information about a volume

Purpose

Before you begin: To use the RMM LISTVOLUME 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 first file data set name in the DATASET class. If there is no first file defined to DFSMSrmm and the volume is in master status or user status, you need READ access to the volume in the TAPEVOL 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 LISTVOLUME subcommand to display information that is recorded by DFSMSrmm for a single volume. You must specify a volume serial number. You can optionally limit the amount of information DFSMSrmm displays.

Use the SEARCHVOLUME subcommand to create lists of volumes that are defined to DFSMSrmm. See SEARCHVOLUME: Creating a list of volumes for more information.

Format


                           .-+---+----------.   
                           | '-,-'          |   
                           V                |   
>>-+-LISTVOLUME-+--volser----+------------+-+------------------><
   '-LV---------'            +-ALL--------+     
                             | .-VOL----. |     
                             '-+-ACCESS-+-'     
                               +-STATS--+       
                               '-STORE--'

Parameters

ACCESS: Specifies the access information for the volume. Access information includes owner and user authorization, last change information, access list, and operating system usage.
ALL: Specifies all the information recorded by DFSMSrmm for the volume. Specifying ALL is equivalent to specifying the operands VOL, ACCESS, STATS and STORE.
STATS: Specifies the volume statistics. Volume statistics include the number of data sets on a volume, volume chaining information, and products that reside on the volume.
STORE: Specifies the storage information for the volume. Storage location information includes the current location of a volume, movement information, store data and bin numbers.
VOL: Specifies volume serial information and status. This includes assigned date, status, release actions, security classification, expiration date, and the name of the first data set.
VOL is the default.
volser: Specifies the volume serial number. A fully qualified serial number is one-to-six alphanumeric, national, or special characters. Enclose it in single quotation marks if it contains any special characters. You can only specify a particular volume serial. A volume serial number is required and must follow the LISTVOLUME subcommand.

Task: Request all the information recorded by DFSMSrmm for the encrypted volume with serial number JJC024.

Command:

  RMM LISTVOLUME JJC024 ALL

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

Figure 1. Sample LISTVOLUME output

Volume information:
Volume = JJC024   VOL1  =          Rack  = JJC024    Owner   = RMMUSER
  Type = PHYSICAL         Stacked count  = 0         Jobname = D016216J
  Worldwide ID =                                     WORM    = N
Creation:  Date = 02/16/2012  Time = 07:23:23  System ID = W98MVS2
Assign:    Date = 02/16/2012  Time = 07:23:23  System ID = W98MVS2
                                               User ID   = 
Expiration date = 09/02/2016 Original      =
         set by = OCE_JFCB
Retention date  =            Set retained  = NO
Retention method= VRSEL      
         set by = OCE_DEF
      retain by = FIRSTFILE
Data set name = RMMUSER.TEST.CBR
Volume status:             Hold = N   File 1 Data set seq = 1
Status = USER      Availability =                   Label = SL
Current label version =            Required label version =
Media information:
Density = IDRC  Type = EETC      Format = EEFMT4    Compaction = YES
Special attributes   = NONE      Vendor =
Encryption Key Labels:                                             Method:
1=wcc1                                                             LABEL
2=wcc2                                                             LABEL
Action on release:
Scratch immediate  = N  Expiry date ignore = N
Scratch = Y  Replace = N  Return = N  Init = N  Erase = N  Notify = N
Actions pending:
Scratch = N  Replace = N  Return = N  Init = N  Erase = N  Notify = N
Storage group  =
Loan location  =           Account = T,H,IOM,,,SYSPROG
Old loan loc   =
Description    =
Security class =           Description =

Access information:
Owner access = ALTER   Volume access = NONE
VM use = N   MVS use = Y   IRMM use = N
Access list:

Last Change information:                                           
Date             = 02/16/2012  Time = 08:50:39  System  = EZU0000  
User change date = 02/16/2012  Time = 08:31:00  User ID = D008210  

Statistics:
Number of data sets = 2       Data set recording= ON
Volume usage(MB)= 6           Use count         = 3
Physical(KB)    = 3           Compression       = 3.00
Capacity(MB)    = 59232       Percent full      = 0
Date last read  = 02/16/2012  Date last written = 02/16/2012
Drive last used = 0FA0        Write mount count = 2
Volume sequence = 1           Media name        = 3480
Previous volume =             Next volume       =
Product number  =             Level             = V  R  M
Feature code    =
Error counts:
Temporary read = 0      Temporary write = 0
Permanent read = 0      Permanent write = 0

Store information:
Movement tracking date =                  Intransit = N
In container           =                  Move mode = AUTO

Location:    Current      Destination  Old          Required     Home
Name       = ATL15393                                            ATL15393
Type       = AUTO                                                AUTO
Bin number =
Media name =
Priority   =

Task: Request the volume serial information and access for the volume with serial number 003186.

Command:

  RMM LISTVOLUME 003186 VOL ACCESS

Output: DFSMSrmm displays information such as that shown in Figure 2:

Figure 2. Sample LISTVOLUME output

Volume information:
Volume = 003186   VOL1  = INT001   Rack  = 003186    Owner   = RMMUSER
  Type = PHYSICAL         Stacked count  = 0         Jobname =  
  Worldwide ID =                                     WORM    = N
Creation:  Date = 08/28/2011  Time = 04:49:14  System ID = W98MVS2
Assign:    Date =             Time =           System ID = W98MVS2
                                               User ID   = 
Expiration date = 09/02/2016 Original      =
         set by = OCE_JFCB
Retention date  =            Set retained  = NO
Retention method= VRSEL      
         set by = OCE_DEF
      retain by = FIRSTFILE
Data set name = RMMUSER.TEST.CBR
Volume status:             Hold = N   File 1 Data set seq = 1
Status = USER      Availability =                   Label = SL
Current label version =            Required label version =
Media information:
Density = IDRC  Type = EETC      Format = EEFMT2    Compaction = YES
Special attributes   = NONE      Vendor =
Encryption Key Labels:                                             Method:
1=wcc1                                                             LABEL
2=wcc2                                                             LABEL
Action on release:
Scratch immediate  = N  Expiry date ignore = N
Scratch = Y  Replace = N  Return = N  Init = N  Erase = N  Notify = N
Actions pending:
Scratch = N  Replace = N  Return = N  Init = N  Erase = N  Notify = N
Storage group  =
Loan location  =           Account = T,H,IOM,,,SYSPROG
Old loan loc =
Description    =
Security class =           Description =
Access information:
Owner access = ALTER   Volume access = NONE    Last change = D027182
VM use = N   MVS use = Y
Access list:
RMMUSER   IBMUSER

Last Change information:                                           
Date             = 01/05/2011  Time = 08:50:39  System  = EZU0000  
User change date = 01/05/2011  Time = 08:31:00  User ID = D008210

Task: Request the volume statistics and information about storage for the volume with serial number DSP000.

Command:

  RMM LISTVOLUME DSP000 STATS STORE

Output: DFSMSrmm displays information such as that shown in Figure 3:

Figure 3. Sample LISTVOLUME output

Statistics:
Number of data sets = 32768   Data set recording= ON
Volume usage(MB)= 0           Use count         = 0
Physical(KB)    = 0           Compression       = 0.00
Capacity(MB)    = 0           Percent full      = 0
Date last read  = 11/18/2012  Date last written = 11/18/2012
Drive last used = 0BD9        Write mount count = 0
Volume sequence = 1           Media name        = 3480
Previous volume =             Next volume       =
Product Number  =             Level             = V  R  M
Feature code    =
Error counts:
Temporary read = 0      Temporary write = 0
Permanent read = 0      Permanent write = 0

Store Information:
Movement tracking date =                Intransit    =  N  		
In container           =                Move mode    =  AUTO

Location:    Current      Destination  Old          Required     Home   
Name       = SHELF                                               SHELF  
Type       =    
Bin number = 
Media name = 
Priority   =

Note:

The volume usage value in the volume statistics information is calculated from the DCBBLKSIZE multiplied by the number of blocks. For data sets using block sizes larger than 32K prior to implementation of the large block size interface (LBI), volume usage is 0. The volume usage is an approximation of the number of bytes written by the application.
The use count field displays the number of times that the volume was opened for either read or write operations. DFSMSrmm resets the volume use count field to zero if the volume status is changed from SCRATCH to MASTER or USER.

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.