Use the TPPCC general macro with the POST_ON_RECEIPT verb specified to
cause the conversation to be posted when available information can be received
by the transaction program. The information can be data or conversation
information. The WAIT verb should be issued after this verb in order to
wait for posting to occur. Or TEST can be issued after this verb in
order to determine when posting has occurred.
Format
- label
- A symbolic name can be assigned to the macro statement.
- POST_ON_RECEIPT
- Directs the TPPCC macro to perform the POST_ON_RECEIPT 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. The resource ID must be the resource ID assigned on the
initial ALLOCATE for this conversation or one that was assigned by an incoming
ATTACH.
- FILL
- LL specifies that posting occurs when a complete or truncated logical
record is received, or when a part of a logical record is received that is at
least equal in length to that specified on the LENGTH parameter. TPF
does not support the BUFFER option defined by the LU 6.2
architecture.
- LENGTH
- Specifies the symbolic name of a field or a register pointing to a
field. This is a 2-byte field in which the minimum amount of data the
program must receive before the conversation can be posted is supplied.
Use this parameter along with the FILL parameter to determine when to post the
conversation for the receipt of data. If you omit this parameter, the
conversation is posted when a complete logical record is received or other,
nondata information is received (such as CONFIRM or
PREPARE_TO_RECEIVE).
- 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 receive state.
- See Entry Requirements for the entry requirements relating to the TPPCC macro in
general.
Return Conditions
- The results of the verb are indicated by the value returned in
RCODE. The valid return codes are listed in the following section,
"Return Codes".
- See Return Conditions for the return conditions relating to the TPPCC macro in
general.
- The following table contains a list of the primary and secondary return
codes that can be returned to the program that issued the POST_ON_RECEIPT
verb. A complete list of return codes and their definitions can be
found in Table 11 and in Table 12.
Symbolic Name
| Primary Code
| Secondary Code
|
LU62RC_OK
| 0000
|
|
LU62RC_PARAMETER_CHECK
| 0001
|
|
LU62RC_PK_BAD_TCBID
| ....
| 00000001
|
LU62RC_PK_BAD_CONVID
| ....
| 00000002
|
LU62RC_INVALID_LENGTH
| ....
| 00000006
|
LU62RC_STATE_CHECK
| 0002
|
|
LU62RC_SKPOSTR_BADSTATE
| ....
| 00000092
|
LU62RC_TPF_ABEND
| FFFF
|
|
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.
- This verb is intended for use in conjunction with the WAIT or TEST
verb. Use this verb followed by a WAIT verb to allow a transaction
program to perform synchronous receiving from multiple conversations.
For each conversation, the program issues this verb and then issues the WAIT
verb. This causes the conversations to wait until information is
available to be received.
Use this verb followed by a TEST verb to allow a transaction program to
continue its processing and test the conversation to determine when
information is available to be received.
- Posting becomes active for a conversation when POST_ON_RECEIPT is issued
for a conversation. Posting is reset when one of the following verbs is
issued for a conversation after the conversation is posted, that
is, the conversation is no longer posted, but posting is still active.
- DEALLOCATE
- RECEIVE
- SEND_ERROR
- TEST
- WAIT.
Posting is canceled when one of the following verbs is issued for a
conversation before the conversation is posted, that is, posting is
no longer active.
- Posting occurs when a complete logical record is available for the
conversation, when the amount of data specified on the LENGTH parameter is
available, or when information other than data is received, such as a
confirmation request or an error indication. See the WHAT_RECEIVED
(WHATRCV) parameter of the RECEIVE verb for more information. (See TPPCC RECEIVE.)
- If the LENGTH parameter is used, the maximum length that can be entered is
32,767.
- See Programming Considerations for the programming considerations relating to the TPPCC
macro in general.
Examples
SYMB100 TPPCC POST_ON_RECEIPT, X
RESID=(R6), X
FILL=LL, X
LENGTH=EBW040, X
RCODE=EBW064