SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-23
PREPARE-TO-RECEIVE Verb
PREPARE-TO-RECEIVE Verb
The local TP issues the PREPARE-TO-RECEIVE verb to change its state from the Send
state to the Receive state. This prepares the local TP to receive data from the partner TP
with a subsequent RECEIVE-AND-WAIT verb or RECEIVE-IMMEDIATE verb. The
local TP must be in the Send state to issue the PREPARE-TO-RECEIVE verb.
Request Details
REQ-UOW-CODE
This field must contain the value 1010, which identifies the PREPARE-TO-
RECEIVE verb.
PR-TYPE
This field specifies the type of the PREPARE-TO-RECEIVE request to be
performed. The different types are:
CO
This specifies that SNAX/APC is to transmit the contents of the local LU’s send
buffer to the partner TP and then request 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.
Request Format
?SECTION PREP-TO-RECEIVE-REQ,TANDEM
01 PREP-TO-RECEIVE-REQ.
02 PR-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 PR-PARAMETERS.
03 PR-TYPE PIC X(2).
88 PR-TYPE-CONFIRM VALUE IS "CO".
88 PR-TYPE-FLUSH VALUE IS "FL".
88 PR-TYPE-SYNC-LEVEL VALUE IS "SL".
03 RESERVED-1 PIC X(1).
03 PR-LOCKS PIC X(1).
88 PR-LOCKS-NO-LOCK VALUE IS " ".
88 PR-LOCKS-SHORT-LOCK VALUE IS "S".
Reply Format
?SECTION PREP-TO-RECEIVE-REP,TANDEM
01 PREP-TO-RECEIVE-REP.
02 PRR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.