Use the TPPCC general macro with the TEST verb specified to test the
conversation for a specified condition. The results of the test are
indicated in the return code.
Format
- label
- A symbolic name can be assigned to the macro statement.
- TEST
- Directs the TPPCC macro to perform the TEST verb function.
- RESID
- Specifies the symbolic name of a field or a register pointing to a
field. This is a 4-byte field in which the resource ID is
supplied. This resource ID must be the one assigned on the initial
ALLOCATE for this conversation or one that was assigned by an incoming
ATTACH.
- TEST
- Specifies the type of test to be performed. The valid types
are:
- POSTED
- Specifies to test whether the conversation has been posted.
- RTSRCVD
- Specifies to test whether the REQUEST_TO_SEND notification has been
received from the remote transaction program.
- RCODE
- Specifies the symbolic name of a field or a register pointing to a
field. This is a 6-byte field in which the return code is
placed. The return code consists of a 2-byte primary return code
followed by a 4-byte secondary return code. The actual values returned
are listed in Return Conditions.
Entry Requirements
- The conversation must be in one of the following states, depending on the
type of test requested:
- Type
- State required
- POSTED
- receive
- RTSTRCVD
- send or receive.
- See Entry Requirements for the entry requirements relating to the TPPCC macro in
general.
Return Conditions
Programming Considerations
- If you specify a register for a keyword value, the register must be
enclosed in parentheses and in the range R1-R7.
- The value supplied in RESID must be the resource ID returned by the
ALLOCATE verb or one that was assigned by an incoming ATTACH.
- The TEST=POSTED option is valid only when the conversation is in
receive state.
- The TEST=POSTED option is used in conjunction with the POST_ON_RECEIPT
verb. The use of POST_ON_RECEIPT and TEST allows a program to continue
its processing while waiting for information to become available. The
TPF transaction program issues POST_ON_RECEIPT for one or more conversations
and then issues TEST for each conversation to determine when information is
available to be received.
- For the TEST=POSTED option, the return code indicates whether posting is
active, whether the conversation has been posted, and whether the information
available is data or not. The TPF transaction program must issue the
RECEIVE verb to receive the information for a conversation that has been
posted.
- The TEST=POSTED option returns LU62RC_LLRCV_UNSUCESFUL if the conversation
has not been posted.
- Posting is active for a conversation on which the POST_ON_RECEIPT verb has
been issued and posting has not been reset or cancelled. See TPPCC POST_ON_RECEIPT for more information on posting.
- The TEST=RTSRVCD option returns LU62RC_OK if the REQUEST_TO_SEND has been
received. Otherwise, the REQUEST_TO_SEND indication has not been
received from the remote transaction program and LU62RC_LLRCV_UNSUCESFUL is
returned.
- To enter receive state, the local transaction program must
issue the appropriate verb, such as RECEIVE or PREPARE_TO_RECEIVE, when the
REQUEST_TO_SEND indication is received.
- See Programming Considerations for the programming considerations relating to the TPPCC
macro in general.
Examples
SYMB100 TPPCC TEST, X
RESID=(R6), X
TEST=RTSRCVD, X
RCODE=EBW064