MODIFY irlmproc,STATUS command (z/OS IRLM)

The MODIFY irlmproc,STATUS command displays information for one or more subsystems connected to the IRLM that is specified using irlmproc .

Each subsystem connected to the specified IRLM is listed, including subsystem name, status, work unit, lock information, the current values of the IRLM TIMEOUT, and DEADLOCK parameter values. Additionally, you can list an IRLM's ID and service level. For a specified IRLM, you can display the current storage allocated, as well as the greatest amount of storage that was allocated since the last time this IRLM was started.

Abbreviation: F

Environment

This command can be issued only from a z/OS® console.

Data sharing scope: Group or member

Authorization

The command requires an appropriate level of z/OS authority.

Syntax

Option descriptions

irlmproc

Specifies the IRLM that is to process the command.

irlmx

Specifies which IRLM's status is to be displayed. irlmx is the concatenation of the IRLM subsystem name and IRLM member ID as specified in the IRLM startup procedure (Db2 installation panel DSNTIPI). An example is DJ2A2 (the member ID is 2).

ALLD

Requests the Db2 subsystem name and status of a Db2 that is identified to an IRLM. In a data sharing group, this command lists information about all Db2 subsystems that are currently identified to an IRLM, assuming that the IRLM on which the command is issued is connected to the data sharing group. You can determine if the IRLM is connected by issuing a MODIFY irlmproc,STATUS command and checking that the output shows SCOPE=GLOBAL.

If a Db2 is down and holds retained locks, that Db2 is also displayed. However, the IRLM that is displayed with that Db2 can vary depending on several circumstances:

Normally, it is the last IRLM to which the Db2 subsystem identified.
If a rebuild of the lock structure occurred after the retained locks were created, the IRLM with the lowest member ID at the time the rebuild occurred is displayed.
If a group restart is occurring and one Db2 subsystem is recovering on behalf of another Db2 subsystem, the IRLM that is displayed is the one associated with the Db2 subsystem doing the peer recovery. For example, if DB1A is doing a peer recovery of DB2A, the display might show the following information:
```
NAME  STATUS ... IRLM_NAME
DB1A  UP         IRLA
DB2A  DOWN       IRLA
```

ALLI

Requests the IRLM subsystem name, ID, status, and service level. In a data sharing group, this command lists information about all IRLM subsystems in the data sharing group, assuming that the IRLM on which the command is issued is connected to the data sharing group. You can determine if the IRLM is connected by issuing a MODIFY irlmproc,STATUS command and checking that the output shows SCOPE=GLOBAL.

In a list of IRLM subsystems in a data sharing group, the name of the IRLM that is the global deadlock manager is followed by an asterisk (*).

If an IRLM is down, it is displayed only if its associated Db2 subsystem is down and holds retained locks. The IRLM that is displayed can vary depending on several circumstances:

Normally, it is the last IRLM to which the Db2 subsystem identified.
If a rebuild of the lock structure occurred after the retained locks were created, the IRLM with the lowest member ID at the time the rebuild occurred is displayed.
If the failed Db2 subsystem had recovery done on its behalf by another Db2 subsystem, the IRLM that is displayed is the one associated with the Db2 subsystem that did the peer recovery.

MAINT

For this IRLM only, displays the maintenance levels of IRLM load module CSECTS in a two-column format.

STOR

For this IRLM only, displays the current and maximum allocation for CSA, ECSA, and private extended storage.

TRACE

Requests information about IRLM subcomponent trace types. Information includes whether a subcomponent trace type is active, how many trace buffers are used by the trace, and whether the component trace external writer is active for the trace.

Output

Output from the command is presented in a DXR message. The command options determine which DXR message is used.

Usage notes

Messages:: If irlmx is not specified, or if this IRLM is in a non-data-sharing environment, message DXR101I is issued. That message lists each subsystem connected to the IRLM specified by irlmx , with an indication as to whether the connection is active.
Displaying IRLM IDs: If irlmproc is started specifying SCOPE=GLOBAL, the second line of the display indicates the IRLM IDs of the IRLM subsystems.

Examples

Example 1: Enter the following command on the z/OS system console:

MODIFY IRTPROC,STATUS

Response on the z/OS system console:

DXR101I IR2T001 STATUS SCOPE=LOCAL
DEADLOCK:0500
        SUBSYSTEMS IDENTIFIED                PT01
        NAME      T/OUT    STATUS    UNITS     HELD      WAITING     RET_LKS
        DSNT1     0010      UP       0005      0010      0002        0

Explanation: The operator on the z/OS system has requested information about the Db2 systems connected to the IRLM identified by the IRLM procedure named IRTPROC.

If the IRLM is SCOPE=GLOBAL on the irlmproc and is not connected to any group, the status message shows:

DXR101I IR21001 STATUS SCOPE=DISCON DEADLOCK: dddd SUBSYSTEMS IDENTIFIED
NAME   T/OUT  STATUS UNITS HELD WAITING RET_LKS 
ssname zzz    wun    reh   rew  rtlks

Use the information in message DXR101I to interpret the output.

Example 2: Assume that you have a data sharing group. Enter the following command on the system console:

MODIFY DB1GIRLM,STATUS,ALLD

The response on the system console is as follows:

11.11.07 STC00061  DXR102I DJ1G001 STATUS                             C
        SUBSYSTEMS IDENTIFIED                
        NAME     STATUS    RET_LKS   IRLMID  IRLM_NAME  IRLM_LEVL 
        DB1G     UP              0    001      DJ1G        2.022
        DB2G     UP              0    002      DJ2G        1.022
    DXR102I End of display

Explanation: The output shows all the Db2 subsystems that are connected to IRLMs in this data sharing group (the group to which the IRLM processing the request belongs).

Use the information in message DXR102I to interpret the output.

Example 3: To display information about a specific member of a data sharing group, enter the following command:

MODIFY DB1GIRLM,STATUS,DJ1G002

Response on system console is as follows:

11.11.21 STC00061 DXR102I DJ1G001 STATUS                          C
        SUBSYSTEMS IDENTIFIED
        NAME     STATUS    RET_LKS  IRLMID  IRLM_NAME   IRLM_LEVL
        DB1G     UP              0   002      DJ1G         2.022
     DXR102I End of display

Explanation: This output shows information similar to the output that is shown in example 1, but this command specifies a specific IRLM in the data sharing group.

Use the information in message DXR102I to interpret the output.

Example 4: Again, assume data sharing is in effect. Enter the following command on the system console:

MODIFY DB1GIRLM,STATUS,ALLI

The response on the console is as follows:

11.11.00 STC00061  DXR103I DJ1G001 STATUS                          C
        IRLMS PARTICIPATING IN DATA SHARING GROUP FUNCTION LEVEL=1.022
        IRLM_NAME IRLMID STATUS LEVEL  SERVICE  MIN_LEVEL MIN_SERVICE
          DJ1G      001    UP   2.022  HIR2220    2.022     HIR2220
          DJ2G      002    UP   1.022  PQ52360    1.012     PN90337
    DXR103I End of display

Explanation: The output shows the IRLMs that are participating in this data sharing group (the group which includes the IRLM processing the request).

Use the information in message DXR103I to interpret the output.

Example 5: Assume that this command is issued in a non-data-sharing environment. Enter the following command on the system console:

MODIFY DB1GIRLM,STATUS,ALLI

The response on the console is as follows:

11.11.03 STC00082  DXR103I DJ1G001 STATUS                            C
        IRLMS PARTICIPATING IN DATA SHARING GROUP FUNCTION LEVEL=2.022
        IRLM_NAME IRLMID STATUS LEVEL SERVICE MIN_LEVEL MIN_SERVICE
          DJ1G      001    UP   2.022 HIR2220   1.022     PQ523690
     DXR103I End of display

Explanation: The output shows information only for the specified IRLM. The group function level that is shown is the function level for the specified IRLM.

Use the information in message DXR103I to interpret the output.

Example 6: Enter the following command on the system console:

MODIFY IR21PROC,STATUS,STOR

The response on the console is as follows:

DXR100I IR21021 STOR STATS                             
      PC: YES  LTEW:n/a LTE:      M RLE:          RLEUSE:                       
      BB PVT:  1495M  AB PVT (MEMLIMIT):  16383P                               
      CSA USE: ACNT:     0K  AHWM:     0K  CUR:   312K  HWM:   312K            
              ABOVE 16M:    16    312K     BELOW 16M:     0      0K            
              AB CUR:              25M     AB HWM:             150M       
      PVT USE:   BB CUR:  4377K        AB CUR:     5M                           
                 BB HWM:   1.5M        AB HWM:    12M                     
      CLASS   TYPE  SEGS     MEM   TYPE  SEGS     MEM   TYPE  SEGS     MEM      
      ACCNT    T-1     2      4M    T-2     1      1M    T-3     1      4K      
      PROC     WRK     4     20K    SRB     1      1K    OTH     1      1K      
      MISC     VAR     8   4310K    N-V    12    323K    FIX     1     24K
      ********************************************************************
*                 IRLM Subpool Storage Stat                        *
********************************************************************
POOLNAME    PTYPE     STORAGE  #SEGMENTS  #ELEM/S  #EXPN    #CMPR
pname       ptype       pstor      psegs   pelems   pexpn    pcmpr
DXR100I  END OF DISPLAY

Explanation: The example shows that current storage allocated for IRLM is 312 KB, and the greatest amount that has been allocated since the last time IRLM was started is also 312 KB. The storage for the locking structures (RHB and RLB) is contained within IRLM private storage.

Use the information in message DXR100I to interpret the output.

Example 7: Enter the following command on the system console:

MODIFY PR21PROC,STATUS,TRACE

The command displays the following output on the system console:

DXR179I PR21034 TRACE USAGE
TRACE BUFFER STORAGE IN USE:   256 KB
MAXIMUM NUMBER OF TRACE BUFFERS ALLOWED PER TRACE TYPE:   10
TRACE TYPE   ACTIVE   BUFFERS IN USE   CTRACE WRITER
----------   ------   --------------   -------------
   SLM          N            0               N
   XIT          Y            2               N
   XCF          N            0               N
   DBM          N            0               N
   EXP          Y            1               N
   INT          Y            1               N

Explanation: This example shows that the storage currently allocated for IRLM tracing is 256 KB, the maximum number of trace buffers allowed per trace type is set to 10, and the external CTRACE writer is not active.

Use the z/OS TRACE CT command to activate or deactivate traces. You cannot turn off the EXP and INT traces. The XIT (for data sharing), EXP, and INT traces are automatically activated when you start IRLM. All traces are automatically activated with IRLMPROC TRACE=YES.

The trace size for each buffer is 64 KB. Use the MODIFY irlmproc,SET,TRACE= nnn command to change the maximum number of trace buffers.

Use the information in message DXR179I to interpret the output.

Example 8: Enter the following command on the system console:

MODIFY IR21I,STATUS,MAINT

The command displays the following output on the system console:

 DXR104I IR21240 MAINTENCE LEVELS                                
     LMOD.Csect     MaintLv   Date       Csect    APAR     DATE    
 DXRRLM00.DXRRL010  PQ35083 02/22/00    DXRRL020  PQ35083 02/22/00 
          DXRRL030  PQ27464 08/18/99    DXRRL040  PQ35083 02/22/00

Explanation: The output shows the maintenance levels of IRLM load module CSECTS in a two-column format.

Use the information in message DXR104IDXR104I to interpret the output.