Displaying connection status and in-flight tasks

We can use the CKQC DISPLAY command to display limited information about the current connection and CICS tasks from either the CICS command line or from a CICS application program. The information from this command is returned in a message CSQC453I, as shown in Figure 38. This message contains:

• The name of the queue manager

• The status of the connection

• The number of in-flight tasks that are still using the connection

Figure 38. Message showing the status of a connection

CSQC453I VICY06 CSQCDSPL Status of connection to JAC2 is Connected. 2
tasks are in-flight

To obtain more detailed information, use the CICS adapter control panels. See Displaying details of a connection from the CICS adapter control panels and Displaying CICS tasks from the CICS adapter control panels.

 

From the CICS command line

We can use the CKQC DISPLAY command, shown in Figure 39, from the CICS command line.

Figure 39. Displaying the status of a connection

CKQC DISPLAY

Figure 38 shows a typical response to this command. The response messages are sent to your CICS terminal.

 

From a CICS application program

Figure 40 shows the LINK command for displaying the status of a connection from a CICS application program.

Figure 40. Linking to the adapter program CSQCDSPL from a CICS program

EXEC CICS LINK PROGRAM('CSQCDSPL') INPUTMSG('CKQC DISPLAY')

Figure 38 shows a typical output from this command. The response messages are sent to the CKQQ queue (the transient data queue).

The COMMAREA option can be used instead of INPUTMSG, but only when the program is run at PLT time.