Querying the current status of a conversation

The APPCCMD CONTROL=TESTSTAT macroinstruction provides a variety of status information about a conversation to the application. The application is able to query the information on a specific conversation, as well as for all conversations for a particular ACB.

Types of information returned by this macroinstruction include the following items:

CONVID of the conversation being reported.
Amount of the normal data waiting to be received, including the LL field and the LL remainder.
Amount of expedited data waiting to be received.
Whether a REQUEST_TO_SEND indication is waiting to be received.
Whether the conversation is in CA mode for receiving normal information.
Whether the conversation is in CA mode for receiving expedited information.
State of the conversation reported. (The conversation state is reported only when QUALIFY=SPEC|ISPEC is specified.)

The APPCCMD CONTROL=TESTSTAT, QUALIFY=ALL|IALL macroinstructions return status information from any active conversation for the specified ACB. The APPCCMD CONTROL=TESTSTAT, QUALIFY=ALL macroinstruction returns any status that is immediately available. If no information is currently available, the LU waits until status information is received before completing. The APPCCMD CONTROL=TESTSTAT, QUALIFY=IALL macroinstruction also returns status on any immediately available information, but if no information is currently available, the macroinstruction completes with an RCPRI, RCSEC combination of X'0000', X'0008' NO_IMMEDIATELY_AVAILABLE_INFORMATION.

The APPCCMD CONTROL=TESTSTAT, QUALIFY=SPEC|ISPEC macroinstructions provide status information for a specific conversation. The APPCCMD CONTROL=TESTSTAT, QUALIFY=SPEC macroinstruction returns any information immediately available. If no information is immediately available, the LU waits for this information before the macroinstruction completes. The APPCCMD CONTROL=TESTSTAT, QUALIFY=ISPEC macroinstruction returns status information that is immediately available. If no information is available, the macroinstruction completes with an RCPRI, RCSEC combination of X'0000', X'0008' NO_IMMEDIATELY_AVAILABLE_INFORMATION.

For more information on the APPCCMD CONTROL=TESTSTAT, refer to the macroinstructions in z/OS Communications Server: SNA Programmer's LU 6.2 Reference.