DISPLAY and PRINT command options

You can use the DISPLAY (and PRINT) commands to display the values of any initialization parameters plus some additional information.

Some of the parameters that provide additional information support generic names. You specify generic names using the following wildcard characters:
  • An * (asterisk symbol ). Use this anywhere in the parameter value to represent from 0 to 8 characters of any value. For example, CICSH* to represent all the CICS® APPLIDs in a CICSplex identified by the letter H.
  • A % (per cent symbol). Use this anywhere in the parameter value to represent only one character of any value. For example, CICS%T* to represent all the TOR APPLIDs in all CICSplexes.

The parameters supported by the DISPLAY and PRINT commands are as follows:

APPLIDS
Display the APPLID and MVS™ system name for every CICS region that currently has a recoverable connection to the pool. This command returns information not only for the server to which the MODIFY command is issued, but for all other servers connected to the same pool.

This keyword can be abbreviated to APPLID, APPLS or APPL.

APPLID={applid|generic}
Display the APPLID and MVS system name for each region that currently has a recoverable connection to the server's pool, and whose APPLID matches applid or generic. This command returns information not only for the server to which the MODIFY command is issued, but for all other servers connected to the same pool.
applid
Use this for a specific APPLID, which should match only one region in the sysplex.
generic
Use a suitable generic value when you want to obtain information about several regions.

If applid or generic is not specified, the server treats this as equivalent to the command DISPLAY APPLIDS.

This keyword can also be specified as APPLIDS, APPLS or APPL.

ARMREGISTERED
Shows whether ARM registration was successful (YES or NO).
CONNECTIONS
Display the jobnames and applids of the regions currently connected to the server to which the command is issued.

This keyword can be abbreviated to CONN.

TABLES
Display the names of all tables currently allocated in the pool.
TABLE={name|generic_name}
Display information about the attributes and status of a specific table, or of a set of tables whose names match the generic name.

If no table name is specified, this is treated as equivalent to DISPLAY TABLES.

TABLEUSERS
Display the CICS APPLIDs of the regions that are currently using each of the tables currently defined in the pool.

This keyword can be abbreviated to TABLEU.

TABLEUSERS={name|generic_name}
Display the CICS APPLIDs of the regions that are currently using the specified table, or using each of the set of tables whose names match the generic name.

If no table name is specified, this is treated as equivalent to DISPLAY TABLEUSERS.

This keyword can be abbreviated to TABLEU

UOWIDS
Display the applids of all regions that currently have unresolved recoverable units of work, together with the number of units of work that are currently in doubt, or are in the process of being committed or backed out. The information displayed does not include units of work that have not yet started the resolution process; that is, units of work that are still in flight.

This keyword can be abbreviated to UOWS.

UOWIDS={applid|generic_applid}∨{applid.*|generic_applid.*}
Display, for the specified regions if they currently have unresolved recoverable units of work, information about those units of work. The information displayed does not include units of work that have not yet started the resolution process; that is, units of work that are still in flight. The information returned depends on the form of operand used.
applid|generic_applid
This form of operand displays the number of units of work that are currently in doubt, or are in the process of being committed or backed out.

If you specify applid, the server displays UOW information for a specific APPLID, which should correspond to only one region in the sysplex.

If you specify generic_applid the server displays UOW information for all the APPLIDs that match the generic APPLID specified.

applid.*|generic_applid.*
This form of operand displays:
  • The state and local UOWID of each individual unit of work, followed by
  • A summary of the number of units of work that are currently in doubt, or are in the process of being committed or backed out.

If you specify applid.*, the server displays the UOW information for a specific APPLID, which should correspond to only one region in the sysplex.

If you specify generic_applid.*, the server displays UOW information for all the APPLIDs that match the generic APPLID specified.

This keyword can be abbreviated to UOWS.

UOWID=applid.uowid
Display the state of an individual unresolved unit of work, identified by its applid and local unit of work ID (UOWID). Enter the local UOWID as 16 hexadecimal digits.

This keyword can be abbreviated to UOW.