SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-24
PREPARE-TO-RECEIVE Verb
Otherwise, the return code indicates the new state of the conversation.
SNAX/APC rejects a CO request if the synchronization level of the conversation
is NONE.
FL
This specifies that SNAX/APC is to transmit the contents of the local LU’s send
buffer to the partner TP and then place the conversation in the Receive state.
The PREPARE-TO-RECEIVE verb completes as soon as the local LU’s send
buffer is transmitted; no confirmation is required.
SL
This specifies that the type of PREPARE-TO-RECEIVE request to be performed
is to be based on the synchronization level specified for this conversation.
If the synchronization level is NONE (N), SNAX/APC transmits the contents of
the local LU’s send buffer to the partner TP and then places the conversation in
the Receive state. The PREPARE-TO-RECEIVE verb completes as soon as the
local LU’s send buffer is transmitted; no confirmation is required. This is
functionally equivalent to a PREPARE-TO-RECEIVE request with PR-TYPE
set to FL (FLUSH).
If the synchronization level is CONFIRM (C), SNAX/APC transmits the
contents of the local LU’s send buffer to the partner TP and then requests
confirmation from the partner TP. The PREPARE-TO-RECEIVE verb does not
complete until the partner TP responds to the request for confirmation. If the
partner TP responds to the request for confirmation affirmatively, the
conversation is placed in the Receive state. Otherwise, the return code indicates
the new state of the conversation. This is functionally equivalent to a
PREPARE-TO-RECEIVE request with PR-TYPE set to CO (Confirm).
If the synchronization level is SYNCPT (S), the request is rejected with error
RCD-IMPROPER-SYNCLEVEL.
RESERVED-1
This field must contain the value 0 or a space (ASCII 32).
PR-LOCKS
This field must be blank (ASCII 32) if PR-TYPE is FL or PR-TYPE is SL and the
synchronization level of the conversation is N (None).
PR-LOCKS must contain an S if PR-TYPE is CO or PR-TYPE is SL and the
synchronization level of the conversation is C (Confirm).
SNAX/APC does not support the long lock (PR-LOCK set to L) specified by the LU
6.2 definition.