LISTCONTROL: Displaying parmlib options and control information

Purpose

Before you begin: To use the RMM LISTCONTROL subcommand:

You need CONTROL access to the STGADMIN.EDG.MASTER resource profile when the STGADMIN.EDG.LISTCONTROL resource profile is not defined.
You need CONTROL access to the STGADMIN.EDG.LISTCONTROL resource profile when the STGADMIN.EDG.LISTCONTROL resource profile is defined.

Use the LISTCONTROL subcommand to display information in the control record of the control data set and information that is defined in the EDGRMMxx parmlib member. Figure 2 shows the information DFSMSrmm displays when you issue the RMM LISTCONTROL subcommand. If you specify LISTCONTROL without any operands, DFSMSrmm displays only the control record information in the control data set.

When you issue the LISTCONTROL CNTL ACTIONS MOVES command when you are running DFSMSrmm client/server support, DFSMSrmm returns information from the control data set on the DFSMSrmm server system. When you issue all other LISTCONTROL commands, DFSMSrmm returns information from the system where the command is issued.

Format


>>-+-LISTCONTROL-+--+--------------------+---------------------->
   '-LC----------'  | .-+---+----------. |   
                    | | '-,-'          | |   
                    | V .-CNTL-------. | |   
                    '---+-NOCNTL-----+-+-'   
                        +-ACTIONS----+       
                        +-NOACTIONS--+       
                        +-LOCDEF-----+       
                        +-NOLOCDEF---+       
                        +-MEDINF-----+       
                        +-NOMEDINF---+       
                        +-MNTMSG-----+       
                        +-NOMNTMSG---+       
                        +-MOVES------+       
                        +-NOMOVES----+       
                        +-OPENRULE---+       
                        +-NOOPENRULE-+       
                        +-OPTION-----+       
                        +-NOOPTION---+       
                        +-PRTITION---+       
                        +-NOPRTITION-+       
                        +-REJECT-----+       
                        +-NOREJECT---+       
                        +-SECCLS-----+       
                        +-NOSECCLS---+       
                        +-STATUS-----+       
                        +-VLPOOL-----+       
                        +-NOVLPOOL---+       
                        '-ALL--------'       

>--+--------------------------+--------------------------------><
   '-SECLEVEL(security_class)-'

Parameters

ACTIONS

Specifies to display information about outstanding volume actions. DFSMSrmm uses these status values:

Pending: An action is outstanding and should be taken.
Confirmed: An action has been confirmed as having been taken.
Complete: Inventory management has been run and all volumes updated to show that the action has been taken.
Unknown: The status of an action cannot be determined.

ALL

Specifies to display all options and rules defined for your installation. Specifying ALL is the same as specifying the operands ACTIONS, CNTL, LOCDEF, MEDINF, MNTMSG, MOVES, OPENRULE, OPTION, PRTITION, REJECT, SECCLS, and VLPOOL. You can use any of these operands with ALL to limit the amount of information displayed: NOCNTL, NOACTIONS, NOLOCDEF, NOMEDINF, NOMNTMSG, NOMOVES, NOOPENRULE, NOOPTION, NOPRTITION, NOREJECT, NOSECCLS, NOVLPOOL.

CNTL

Specifies to display the control record information in the DFSMSrmm control data set, describing the inventory for the removable media library. This information includes inventory management and backup dates, and inventories for rack and bin numbers.

CNTL is the default.

LOCDEF

Specifies to display all locations defined using the LOCDEF command in the EDGRMMxx parmlib member. Default values for built-in storage location names such as LOCAL, DISTANT, REMOTE, and location SHELF are also displayed. Values for specific system-managed libraries are displayed if they are defined in LOCDEF parameters.

MEDINF

Specifies to display the media information definitions that are defined to the installation in the EDGRMMxx parmlib member.

MNTMSG

Specifies to display the mount/fetch message definitions that are currently in use.

MOVES

Specifies to display information about outstanding volume moves. DFSMSrmm uses these status values:

Pending: A move is outstanding and should be completed.
Confirmed: A move has been confirmed as having been completed.
Complete: DFSMSrmm inventory management has been run and all volumes have been updated to show that the move has been completed.
Unknown: The status of a move cannot be determined.

NOACTIONS

Specifies to prevent outstanding volume actions from being listed when you specify LISTCONTROL ALL.

NOCNTL

Specifies to prevent the control record information from being displayed when you specify LISTCONTROL ALL.

NOLOCDEF

Specifies to prevent the location definition information from being displayed when you specify LISTCONTROL ALL.

NOMEDINF

Specifies to prevent media information from being displayed when you specify LISTCONTROL ALL.

NOMNTMSG

Specifies to prevent the mount/fetch message definitions from being displayed when you specify LISTCONTROL ALL.

NOMOVES

Specifies to prevent outstanding volume moves from being listed when you specify LISTCONTROL ALL.

NOOPENRULE

Specifies to prevent the open rule information from being displayed when you specify LISTCONTROL ALL.

NOOPTION

Specifies to prevent system options from being displayed when you specify LISTCONTROL ALL.

NOPRTITION

Specifies to prevent the partitioning information from being displayed when you specify LISTCONTROL ALL.

NOREJECT

Specifies to prevent volumes that are unavailable on the system from being displayed when you specify LISTCONTROL ALL.

NOSECCLS

Specifies to prevent security classes from being displayed when you specify LISTCONTROL ALL.

NOVLPOOL

Specifies to prevent volume pool details from being displayed when you specify LISTCONTROL ALL.

OPENRULE

Specifies to display the open rule definitions that are currently in use.

OPTION

Specifies to display the system options that are currently in use.

PRTITION

Specifies to display the partitioning definitions that are currently in use.

REJECT

Specifies to display rack number and access information about volumes that are unavailable on the system.

SECCLS

Specifies to display the security classes defined for your installation.

SECLEVEL(security_class)

Specifies to display information about a security class. Specify a security class ID. The value one to eight characters and must correspond to one of the security classes defined for your installation.

STATUS

Specifies to display information about DFSMSrmm subsystem address space status, tasks, and queued requests. The information returned is very similar to the results of the operator ‘F DFRMM,QUERY ACTIVE’ command.

Note:

Although the outputs of LISTCONTROL STATUS and QUERY ACTIVE are very similar in terms of the kinds of information displayed, if the two commands are issued simultaneously, the output of the LISTCONTROL STATUS might reflect a slightly later state than the QUERY ACTIVE command, owing to different processing paths for the two commands.
The output of the LISTCONTROL STATUS command will always include at least one active task (LC) for itself.
The STATUS operand is not included with the ALL operand.

VLPOOL

Specifies to display information about pools defined for your installation.

Task: Display information about the DFSMSrmm subsystem, subsystem requests, and task status.

Command:

  RMM LISTCONTROL STATUS

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

Figure 1. Sample LISTCONTROL STATUS output

RMM LC STATUS
 DFSMSrmm status = ACTIVE   Journal = ENABLED  Server listener = ACTIVE
 Local tasks     = 5        Server tasks    = 5                        
       Active    = 2               Active   = 2                        
       Held      = 1               Held     = 1                        
 Queued requests = 0        New requests    = NOTHELD                  
       Nowait    = 0                                                  
       Catalog   = 0                                                  
 Last RESERVE    = 06:17:09 + ENQ                                     
 Debug Setting   = DISABLED                                            
 Trace Levels    = 1,2                                                
 
 Active requests:                                                                     
 Function  System  Task   Name  Started   Token   S IP Status         
 -------- -------- ------------ -------- -------- - ----------------  
 LC                JOB=RMMUSERS 06:17:09 00400009                     
 HSKP              JOB=INVMGMTS 05:29:27 00300002 H                   
 ADD      EZU34    JOB=RMMUSERS 06:15:49 0060000B + READ  < 06:17:09  
 C/S      EZU34    STC=DFRMM    00:00:00 00700001   READ  > 06:16:52

Task: Display your installation's options and rules, restricting the information displayed to the control record information and system options only.

Command:

  RMM LISTCONTROL CNTL OPTION

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

Figure 2. Sample LISTCONTROL CNTL OPTION output

System options:                                                            
PARMLIB Suffix  = KH           Operating mode  = P                         
Control data set name      = RMMUSER.APAR.MASTER                           
Journal file data set name = RMMUSER.APAR.JOURNAL                          
Journal threshold          = 50%               Journal transaction = NO    
Catalog SYSID              = Notset                                        
Scratch procedure name     = EDGXPROC                                      
Backup procedure name      = SUB                                           
IPL date check  = N        Date format    = A       RACF support   = N     
SMF audit       = 0        SMF security   = 0       CDS id         = MZTEST
MAXHOLD value   = 100      Lines per page = 54      System ID      = EZU160
BLP             = RMM      TVEXT purge    = RELEASE Notify         = Y     
                                 days     = 0                              
Uncatalog       = S                                 Message case   = M     
MASTER overwrite= MATCH    Accounting     = J                              
Disp DD name    =          Disp msg ID    = EDG4054I                       
PREACS          = NO       SMSACS         = NO      CMDAUTH OWNER  = YES   
Reuse bin       = CONFIRMMOVE                       CMDAUTH DSN    = NO    
Local tasks     = 1                                 Media name     = 3480  
                                                                           
Retention period: Default = 5     Maximum = NOLIMIT                        
                  Catalog = 12    hours                                 
Use of Management Class Attributes = NONE                               
Retention method: Default = VRSEL                                       
                                                                        
RM(VRSEL) defaults:              RM(EXPDT) defaults:                    
  Retain by         = VOLUME       Retain by          = VOLUME          
  Move By           = VOLUME                                            
  VRS selection     = NEW          LASTREF extra days = 0               
  VRS change        = INFO                                              
  VRSMIN action     = FAIL                                              
  VRSMIN count      = 1                                                 
  VRS job name      = 2                                                 
  GDG duplicate     = BUMP                                              
  GDG cycle by      = GENERATION                                        
                                                                        
VRSDROP action  = INFO     VRSDROP count  = 0              percent = 10 
VRSRETAIN action= INFO     VRSRETAIN count= 0              percent = 80 
EXPDTDROP action= INFO     EXPDTDROP count= 0              percent = 10 
                                                                        
PDA: ON                                                                 
 Block count    = 255      Block size     = 27      Log            = ON 
SMSTAPE:                                                                
 Update scratch = YES      Update command = YES     Update exits   = YES
 Purge          = ASIS                                                  
Client/Server:                                                          
 Subsystem type = STANDARD Port           = 0                           
 Server                    Server tasks   = 0                           
  host name  =                                                          
  IP address =

Task: Display your installation's options and rules excluding control record information and start up options.

Command:

  RMM LISTCONTROL ALL NOCNTL NOOPTION NOLOCDEF

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

Figure 3. Sample LISTCONTROL output - options and rules, excluding control record information and start up options.

Security classes:
 Number  Name      SMF  MSG  Erase  Description
 ------  --------  ---  ---  -----  --------------------------------
 1       CLASS01   N    N    N      FOR SECURITY CLASSIF. TESTING
 2       CLASS02   Y    N    N      FOR SECURITY CLASSIF. TESTING
 3       CLASS03   N    N    Y      FOR SECURITY CLASSIF. TESTING
 4       CLASS04   Y    N    Y      FOR SECURITY CLASSIF. TESTING
 5       CLASS05   N    Y    N      FOR SECURITY CLASSIF. TESTING
 9       UNCLASS   N    N    N      UNCLASSIFIED
 10      IUO       N    N    N      XXX INTERNAL USE ONLY
 11      IC        N    N    N      XXX CONFIDENTIAL
 12      ICR       Y    Y    Y      XXX CONFIDENTIAL RESTRICTED

 Volume Pools:
 Pool   System   RA Ty Expdt Pool     Media    Description
                 CF pe check name     name
 ------ -------- -- -- ----- -------- -------- --------------------------
                      Action Scratch  Overwrite
                      ------ -------  ---------
 *      BTLS110  N  S  N     SCRTCH2  3490     BTLS POOL
                             AUTO     LAST
 P4L33*          N  S  O              TAPE     DIALOGUE VOLUME TESTS
                             MANUAL   ADD
 P4L41*          N  S  O              TAPE     DIALOGUE VOLUME TESTS 1
                             AUTO     MATCH
 P4L42*          N  R  O              TAPE     DIALOGUE VOLUME TESTS 2
                             AUTO     USER
 P4L43*          N  S  O              TAPE     DIALOGUE VOLUME TESTS 3
                             AUTO     LAST
 R2*             N  R  O              TAPE     DIALOGUE RACK TESTS
                             AUTO     USER
 R5*             N  R  O              TAPE     DIALOGUE PRODUCT TESTS
                             AUTO     USER
 S3*             N  S  O              TAPE     DIALOGUE DATASET TESTS
                             AUTO     USER
 TE520*          Y  S  O              3420     TEST T14000 3420S
                             AUTO     LAST
 T1*             N  R  O              3480     DIALOGUE OWNER TESTS
                             AUTO     LAST
 T3*             N  R  O              TAPE     DIALOGUE DATASET TESTS
                             AUTO     LAST
 T4*             N  R  O              TAPE     DIALOGUE VOLUME TESTS
                             AUTO     LAST
 1I501*          Y  S  O              3480     TEST T12000 SPECIFIC
                             AUTO     MATCH
 *               N  S  O              3480     DEFAULT POOL
                             AUTO

Task: Display your installation's partitions.

Command:

  RMM LISTCONTROL PRTITION

Output: DFSMSrmm displays information such as that shown in Figure 4.

Figure 4. Sample LISTCONTROL PRTITION output

Partition Entries:
                        SMT       NOSMT
 Volume or Range Type  Action Action Location
 --------------- ----- ------ ------ --------
 AZ99B0          RMM   ACCEPT ACCEPT SHELF
 A00100:Z99AB0   RMM   IGNORE IGNORE
 *               RMM   IGNORE IGNORE
 AZ99B0          NORMM ACCEPT ACCEPT SHELF
 B00001:B00001   NORMM ACCEPT ACCEPT SHELF
 MW*             NORMM ACCEPT ACCEPT LOC1
 *               NORMM IGNORE IGNORE

Task: Display your installation's OPENRULE entries.

Command:

  RMM LISTCONTROL OPENRULE

Output: DFSMSrmm displays information such as that shown in Figure 5.

Figure 5. Sample LISTCONTROL OPENRULE output

Openrule Entries:
                           Input             Output
 Volume or Range Type  Action Condition   Action Condition
 --------------- ----- ------ ----------- ------ -----------
 A00100:Z99AB0   RMM   REJECT             REJECT
 *               RMM   REJECT             ACCEPT
 B00001:B00001   NORMM REJECT             REJECT SYSID,CATLG
 MW*             NORMM IGNORE SPECIFIC    REJECT
 *               NORMM ACCEPT             ACCEPT

Task: List the data set name masks for a security level defined as IC.

Command:

  RMM LISTCONTROL SECLEVEL(IC)

Output: DFSMSrmm displays information such as shown in Figure 6:

Figure 6. Sample LISTCONTROL SECLEVEL output

Security rules for level 11
 Name  = IC         SMF = N        MSG = N
 Erase = N  Description = XXX CONFIDENTIAL
 Data set name Mask(s)
 --------------------------------------------
 SYS1.IC.IC.**

Task: List the location definitions defined for your installation.

Command:

  RMM LISTCONTROL LOCDEF

Output:

If no location definitions are defined in EDGRMMxx parmlib, then issuing LISTCONTROL LOCDEF produces the output shown in Figure 7.

Figure 7. Sample LISTCONTROL LOCDEF output - No LOCDEFs defined

                                                                                
 Location definitions:                                                          
 Location Def Mgtype  Ltype  Priority AM Medianames                             
 -------- --- ------  ------ -------- -- -------------------------------------  
           N          AUTO     4800   Y                                         
           N          MANUAL   4900   Y                                         
 DISTANT   N          STORE     200   Y                                         
 LOCAL     N          STORE     300   Y                                         
 REMOTE    N          STORE     100   Y                                         
 SHELF     N                   5000   Y

Task: List the media information defined for your installation.

Command:

  RMM LISTCONTROL MEDINF

Output:

DFSMSrmm displays information such as that shown in Figure 8.

Figure 8. Sample LISTCONTROL MEDINF output

Media Information :
                                                         Replace Policy
Name     Media type   Recording format Capacity (MB) Perm  Temp  WMC   Age
-------- ------------ ---------------- ------------- ----- ----- ----- -----
MEDINF_A   1 MEDIA1       1 RECTECHA         10000       1     0     0    35
MEDINF_A   0 *            0 *                    0       5     0     0    20
MEDINF_B   2 MEDIA2       1 RECTECHB        150000       1    20    99  9999
MEDINF_B   2 MEDIA2       0 *                    0       1    20    99  9999
MEDINF_C   6 MEDIA6       6 RECTECHC     999999999       1     0     0    35

If no media information is defined in EDGRMMxx parmlib, then issuing LISTCONTROL MEDINF produces the output shown in Figure 9.

Figure 9. Sample LISTCONTROL MEDINF output - No media information defined

NO INSTALLATION DEFINED MEDIA INFORMATION

Table 1 describes the columns in the LISTCONTROL subcommand output.

Table 1. LISTCONTROL Subcommand output
Column	Description
Location	The location name, in ascending alphanumeric order.
Def	Shows Y or N for whether a LOCDEF command was found for this location.
Mgtype	Shows any MANAGEMENTTYPE setting for the location. Mgtype can be: BINS, NOBINS, or blank. BINS indicates the location is shelf-managed. NOBINS indicates the location is not shelf-managed.
Ltype	Is the location type. AUTO, MANUAL, STORE, or blank for location SHELF. If defined as a storage home location it shows HSTORE.
Priority	Is the current relative priority of the location.
Medianames	Provides all the media names specified for the location.

Figure 10 shows information that DFSMSrmm displays when there are location definitions in place.

Figure 10. Sample LISTCONTROL LOCDEF output - LOCDEFs defined

                                                                                
 Location definitions:                                                          
 Location Def Mgtype  Ltype  Priority AM Medianames                             
1-------- --- ------  ------ -------- -- -------------------------------------  
           N          AUTO     4800   Y                                         
           N          AUTO     4900   Y                                         
 DISTANT   Y  NOBINS  HSTORE   1000   Y  TESTMED1, TESTMED2, TESTMED3           
                                         TESTMED4, TESTMED5, 3480               
 ILOCBIN   Y  BINS    HSTORE   1000   N  TESTMED1, TESTMED2, TESTMED3           
                                         TESTMED4, TESTMED5, 3480               
 ILOCNBIN  Y  NOBINS  HSTORE   1000   N  TESTMED1, TESTMED2, TESTMED3           
                                         TESTMED4, TESTMED5, 3480               
 LOCAL     Y  NOBINS  HSTORE   1000   N  TESTMED1, TESTMED2, TESTMED3           
                                         TESTMED4, TESTMED5, 3480               
 MTL13480  Y          MANUAL    500   Y                                         
 MYLOC     Y          MANUAL   4900   Y                                         
 REMOTE    Y  NOBINS  HSTORE   1000   N  TESTMED1, TESTMED2, TESTMED3           
                                         TESTMED4, TESTMED5, 3480               
 SHELF     Y                   5000   Y

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.