gtpg2m4oGeneral Macros

TPPCC POST_ON_RECEIPT

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

Return Conditions

Programming Considerations

Examples

SYMB100   TPPCC POST_ON_RECEIPT,                   X
                RESID=(R6),                        X
                FILL=LL,                           X
                LENGTH=EBW040,                     X
                RCODE=EBW064