z/OS Communications Server: SNA Programmer's LU 6.2 Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using APPCCMD CONTROL=RECEIVE, QUALIFY=ANY|IANY

z/OS Communications Server: SNA Programmer's LU 6.2 Guide
SC27-3669-00

The APPCCMD CONTROL=RECEIVE, QUALIFY=ANY|IANY macroinstructions receive normal information that is available from any conversation that is in continue-any mode.

When data is ready to be received on a continue-any mode conversation, VTAM® copies the data into the data area that is specified on the AREA parameter and if QUALIFY=IANY is specified, completes the macroinstruction. If QUALIFY=ANY is specified, VTAM may wait for additional information to be received before completing the macroinstruction. The conversation identifier for the conversation used to complete the macroinstruction is placed in the CONVID field.

The QUALIFY=IANY version receives normal information that is immediately available from a conversation that is in continue-any mode. VTAM does not wait for additional information before completing this macroinstruction. If there are no conversations in continue-any mode with information available, VTAM issues an RCPRI, RCSEC combination of X'0000', X'0008', NO_INFORMATION_IMMEDIATELY_AVAILABLE.

The APPCCMD CONTROL=RECEIVE, QUALIFY=ANY|IANY macroinstructions allow an application program to monitor several conversations simultaneously with a single macroinstruction.

Typically, an application program uses conversations in continue-any mode to determine which of several conversations has received a transaction to process. However, the application program does not process the transaction while the conversation remains in continue-any mode because the macroinstruction might receive data on another conversation in the middle of a transaction and data may get out of order.

To avoid this problem, an application program can change the conversation from continue-any mode when data is received from that conversation. This ensures that the application program can process an entire transaction at one time. The application program specifies a continuation mode of continue specific on the macroinstruction. When data on a continue-any conversation is met by the QUALIFY=ANY|IANY macroinstruction which also specified CONMODE=CS, the conversation is put into continue-specific mode. The application program can then issue APPCCMD CONTROL=RECEIVE, QUALIFY=SPEC|ISPEC to finish processing the transaction.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014