SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-36
RECEIVE-IMMEDIATE Verb
RIR-DATA-AREA
This field contains the data received. If the RECEIVE-IMMEDIATE request
specified FILL-BUFFER (B), this field can include several logical records. If the
RECEIVE-IMMEDIATE request specified FILL-LL (L) and the RIR-DATA-
LENGTH field is less than the logical record length, the buffer can include all or
part of a logical record.
Each logical record begins with a two-byte logical record length field (LL) and, if
applicable, a two-byte General Data Stream (GDS) variable identifier. See the
subsection titled “Data Exchanged Using SNAX/APC” in Section 3 for more
information on General Data Stream variables.
Return Codes
The RECEIVE-IMMEDIATE verb returns one of the following return codes in
REP-RETURN-CODE of RWR-HEADER:
RC-OK
RC-ALLOCATION-ERROR
RC-BACKOUT-NO-RESYNC
RC-BACKOUT-RESYNC
RC-DEALLOCATE-ABEND-PROG
RC-DEALLOCATE-NORMAL
RC-PROGRAM-ERROR-NO-TRUNC
RC-PROGRAM-ERROR-PURGING
RC-PROGRAM-ERROR-TRUNC
RC-RESOURCE-FAIL-NO-RETRY
RC-RESOURCE-FAIL-RETRY
RC-UNSUCCESSFUL
The return code RC-UNSUCCESSFUL indicates that there was no information available
from the partner TP for the RECEIVE-IMMEDIATE verb.
Considerations
•
REQUEST-TO-SEND notification is usually received in the Send state but can be
received in Receive state under one of the following conditions:
•
The local TP just entered Receive state, and the remote TP issued REQUEST-
TO-SEND.
•
The remote TP issued PREPARE-TO-RECEIVE and then issued REQUEST-
TO-SEND before the local program entered Send state.
•
Because the REQUEST-TO-SEND is transmitted as an expedited request, it can
arrive ahead of the request carrying the SEND indication. The local TP cannot
distinguish this condition from the first condition (local TP entered Receive state
as remote issued REQUEST-TO-SEND). However, if the remote TP waits until
it receives information from the local TP before it issues the REQUEST-TO-
SEND, this ambiguity can be avoided.
•
The remote TP issued REQUEST-TO-SEND in Send state.