gtpg2m4pGeneral Macros

TPPCC PREPARE_TO_RECEIVE

Use the TPPCC general macro with the PREPARE_TO_RECEIVE verb specified to change the conversation from send to receive state in preparation to receive data. The change to receive state is completed as part of this verb. The execution of this verb includes the function of the FLUSH or CONFIRM verb.

Format




label
A symbolic name can be assigned to the macro statement.

PREPARE_TO_RECEIVE
Directs the TPPCC macro to perform the PREPARE_TO_RECEIVE 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.

TYPE
Specifies the type of PREPARE_TO_RECEIVE to be done on this conversation. The allowed values are:

CONFIRM
Performs the function of the CONFIRM verb. When the PREPARE_TO_RECEIVE request completes successfully, the conversation enters receive state.

FLUSH
Performs the function of the FLUSH verb. When the PREPARE_TO_RECEIVE request completes successfully, the conversation enters receive state.

SYNC
Performs the function of the FLUSH verb or the CONFIRM verb based on the synchronization level of the conversation. If the synchronization level is NONE, a FLUSH is performed. If the synchronization level is CONFIRM, a CONFIRM is performed.

LOCKS
SHORT is the only allowed value. This parameter has meaning only when the CONFIRM option is used on TYPE and causes control to be returned only after the confirmation reply has been received. TPF does not support the LONG option defined by the LU 6.2 architecture.

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 PREPARE_TO_RECEIVE,                X
                RESID=EBW004,                      X
                TYPE=SYNC,                         X
                LOCKS=SHORT,                       X
                RCODE=(R5)