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.
- 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.