Displaying resource recovery services (RRS) information

Use the DISPLAY RRS command to display status information about RRS coordinated transactions to the system console and SYSLOG. You can also use automation to parse the output and trigger alerts.

The command supports the following parameters:
Restrictions:
  1. The DISPLAY RRS command is not a performance path.
  2. Trying to process more than 1500 URs may exceed the DISPLAY RRS internal work area. When the area is exceeded, the following conditions are expected:
    • D RRS,UR will terminate with:
      ATR605I DISPLAY RRS COMMAND TRUNCATED, SOME DATA NOT AVAILABLE
    • D RRS,UREX will process all the data in the work area issuing message ATR624I and will terminate with: 
      * Data truncated. DISPLAY RRS work area exceede
      or 
      * Data truncated. DISPLAY RRS secondary work area exceeded
    • D RRS,URST is not affected by the number of URs.
  3. Trying to process lots of URs may exceed the CONSOLE buffer. Message CNZ3011I will be issued and the output will be truncated when the buffer is exceeded. The number of lines written before truncation is based on a buffer limit specified at IPL in the CONSOLxx member. However, the data will appear in the system log without being truncated.
D RRS 
 
D RRS[,UR[ ,SUMMARY|,SUM|,S|,DETAILED|,D]uroptions]
     [,UR[,FAMILY|,F]urfamoptions]
     [,RM[ ,SUMMARY|,SUM|,S|,DETAILED|,D]rmoptions]
     [,URSTATUS|,URSTsysoptions]
     [,UREXCEPTION|,UREXsysoptions]
     [,L=a|name|name-a]
     
 uroptions:                                       
[,URID=ur-identifier]		
[,STATE=FLT|SCK|PRP|DBT|CMT|BAK|END|OLA|CMP|FGT]	
[,SYSNAME=system-name]
[,GNAME=logging-group-name]
urfamoptions:                                       
[,URID=ur-identifier]
[,SYSNAME=system-name]
[,GNAME=logging-group-name]
rmoptions:
[,RMNAME=resource-manager-name]
[,SYSNAME=system-name]
[,GNAME=logging-group-name]
sysoptions:                                       
[,SYSNAME=system-name]
[,GNAME=logging-group-name]
RRS
The system is to display status information about RRS coordinated transactions to the system console and SYSLOG.
UR
Indicates that the system is to display information about RRS coordinated transactions.
SUMMARY or SUM or S
Indicates that the system is to use the summary form of the output (ATR601I). The resulting message contains a list of RRS coordinated transactions that were selected through the optional filter parameters.
A summary UR entry includes the following information:
  • UR identifier
  • System name
  • RRS logging group name
  • UR state
  • UR type - protected or unprotected
  • Comment - comments about this UR
DETAILED or D
Indicates that the system is to use the DETAILED form of the output (ATR603I). The resulting message contains detailed information for the particular transaction as indicated by the URID= parameter.

With this output form, The URID= parameter is required and only one particular UR can be selected (no wildcards are allowed). SYSNAME and GNAME cannot use wildcards.

A detailed UR entry includes all the information in a summary report, plus the following information:
  • A list of expression of interests that are associated with the transaction. Each expression of interest includes: URI token, resource manager name, resource manager role, interest type, interest status, interest state, exit status, and duration.
FAMILY or F
Indicates that the system is to display the units of recovery (UR) in the cascaded transaction specified as input. See z/OS MVS System Messages, Vol 3 (ASB-BPX) for more information about message ATR622I.
RM
Indicates that the system is to display information about resource managers that are currently active or were previously active with RRS.
SUMMARY or SUM or S
Indicates that the system is to use the summary form of the output (ATR602I). The resulting message contains a list of resource managers that were selected through optional keyword filter parameters. A summary RM entry includes the following information:
  • Resource manager name
  • Resource manager state
  • System name
  • RRS logging group name
DETAILED or D
Indicates that the system is to use the DETAILED form of the output (ATR604I). The resulting message contains the detailed information for then specified resource manager as indicated by the RMNAME= parameter.

With this output form, the RMNAME= parameter is required and only one particular RM can be selected (no wildcards are allowed). SYSNAME and GNAME can not use wildcards.

A detailed RM entry includes all the information in a summary report, plus the following information:
  • RM token
  • A list of URs associated with the resource manager. The information displayed for each UR is similar to the UR summary information.
URID=ur-identifier
A UR identifier used to limit the number of URs returned for a UR request. For a SUMMARY request, this parameter is optional. If specified, wildcards are allowed (* or ?). If not specified, the UR identifier is not used to filter the returned UR information. For a DETAILED request, this parameter is required and can not contain any wildcards.
STATE=FLT|SCK|PRP|DBT|CMT|BAK|END|OLA|CMP|FGT]
The UR state of the URs to be returned. If not specified, URs in any state are returned.
RMNAME=resource-manager-name
A resource manager name used to limit the number of RMs returned for a RM request. For a SUMMARY request, this parameter is optional. If specified, wildcards are allowed (* or ?). If not specified, the resource manager name is not used to filter the returned RM information. For a DETAILED request, this parameter is required and can not contain any wildcards.
GNAME=logging-group-gname
An RRS logging group name used to limit the amount of returned information. Wildcards (* or ?) are allowed for only the summary form of output. The default is the logging group for the current system.
SYSNAME=system-name
A system name used to limit the amount of returned information. Wildcards (* or ?) are allowed for only the summary form of output. The default is the current system.
URSTATUS or URST
Indicates that the system is to display unit of recovery statistics that includes UR state, UR count, and UR duration time information for in storage URs and does not process any URs found in the log streams. The system is to use message output ATR623I for the information. See z/OS MVS System Messages, Vol 3 (ASB-BPX) for more information about message ATR623I.
UREXCEPTION or UREX
Indicates that the system is to display unit of recovery (UR) information for URs that are in exceptions or waiting for a resource. The system is to use message output ATR624I for the information. If the DISPLAY RRS,UREXCEPTION command fails during processing, messages are issued indicating the problem. In such a situation, failure messages prevent the display of any valid information. See z/OS MVS System Messages, Vol 3 (ASB-BPX) for more information about message ATR624I.
L=a,name, or name-a
Indicates the display area (a), console name (name), or both the console name and the display area (name-a) where the display will be presented. If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.
Parent topic: DISPLAY command