/DISPLAY (IMS)

The IMS™ command /DISPLAY displays the status of the connection between IMS and an external subsystem (as well as all application programs communicating with the external subsystem), or the outstanding recovery units that are associated with the subsystem.

Data sharing scope: Member

Authorization

This command requires an appropriate level of IMS authority.

Syntax

                        .-,--------------.              
                        V                |              
>>-/DISPLAY--+-SUBSYS-+---subsystem-name-+-+--------+----------><
             |        '-ALL----------------'        |   
             |                 .-,--------------.   |   
             |                 V                |   |   
             '-OASN--SUBSYS--+---subsystem-name-+-+-'   
                             '-ALL----------------'

Option descriptions

One of the following options is required:

SUBSYS

Identifies the subsystems to display information about.

subsystem-name , …: Specifies one or more subsystems.
ALL: Displays information about all subsystems.

OASN SUBSYS

Displays the outstanding recovery units (origin application schedule numbers, or OASN) associated with the external subsystems. The OASN is assigned by IMS when it schedules an application into a dependent region. That, coupled with the IMS ID, becomes the recovery token for units of work distributed to other subsystems.

subsystem-name , …: Specifies one or more subsystems to display information about.
ALL: Displays the outstanding recovery units associated with all external subsystems.

Output

The command recognition character (CRC) is displayed for each external subsystem. Subsystem status is one of the following conditions:

CONNECTED: An IMS control region or dependent region has successfully connected to the external subsystem. At this point, the two systems can begin a normal dialog.
NOT CONNECTED: The external subsystem is in an idle state. That is, either it has not been the object of the /START SUBSYS command, or the external subsystem initialization exit routine indicated not to connect.
CONNECT IN PROGRESS: The connection process for the specified subsystem is in progress.
STOPPED: The specified subsystem has been stopped with the /STOP SUBSYS command. All region connections to the specified external subsystem have been terminated.
STOP IN PROGRESS: The /STOP SUBSYS command is in progress. Before it completes successfully, all active connections to the specified subsystem from all IMS regions must be quiesced.
INVALID SUBSYSTEM NAME = subsystem-name: The indicated subsystem name has not been defined to the IMS subsystem PROCLIB member. Add the subsystem definition to the subsystem member and issue the /START SUBSYS command.
SUBSYSTEM subsystem-name NOT DEFINED BUT RECOVERY OUTSTANDING: The indicated subsystem name has not been defined to IMS in the external subsystem PROCLIB member, but IMS still has outstanding recovery elements from a previous execution when the name was known. To resolve the recovery element problem, either add the indicated subsystem definition to the external subsystem PROCLIB member and then issue the /START SUBSYS command, or issue the /DISPLAY OASN SUBSYS command to determine the identification of the OASNs and then manually resolve the recovery elements by issuing the /CHANGE SUBSYS RESET command.
TERM IN PROGRESS: An internal termination of the subsystem is underway. This type of termination was instigated by IMS abnormal condition processing, an external subsystem exit, or the external subsystem.

A thread between an IMS dependent region and an external subsystem is created when an application program in the region establishes a connection to the external subsystem. The status of threads to an external subsystem is listed under the status of the subsystem. The absence of a list of threads under a connected subsystem indicates that no threads to the specified subsystem have been established.

Thread status can be one of the following conditions:

CONNECTED(CONN): An IMS control region or dependent region has successfully connected to the external subsystem.
ACTIVE: An IMS application program has established communication with an external subsystem.

The absence of a PSB name for a thread indicates that a connection to the external subsystem exists, but an application program is not currently occupying the region. The presence or absence of an LTERM name indicates whether a region is message-driven.

Note: The preceding description of the /DISPLAY command is a partial description only.

Examples

Example of displaying the status of connections between IMS and all subsystems

Issue the following command to display the status of all connections with IMS:

/DISPLAY SUBSYS ALL

Output similar to this output is generated:

SUBSYS    CRC    REGID    PROGRAM    LTERM    STATUS
SSTR      ?                                   CONN
                   1      DDLTLM17   PTERM01  CONN,ACTIVE
                   2      DDLTLM06   PTERM02  CONN
*85202/065933*