SNAX/HLS Application Programming Manual

RECEIVEDATA Verb
Application Prototyping and Simulation (APS) System
104707 Tandem Computers Incorporated 6–45
RD: RECEIVE-DATA
Verb (F5)
The RECEIVE-DATA request causes the top element of the receive-queue for the APS
session to be retrieved and displayed. If there is no message on the receive queue, the
APS screen hangs until data is available. If this situation causes a deadlock, use the
HLSCOM QMSG command to send an interrupt message to the APS application.
There are three formats for verb replies to RECEIVE-DATA:
1. A RECEIVE-DATA-REPLY structure to deliver session-partner messages and
other information.
2. A SEND-DATA-REPLY structure to deliver both positive and negative responses
from the session partner. See the SEND-DATA verb description for details.
3. Queued completions, noting the actual completion of a verb previously reported
as RC-FORTHCOMING. Consult the description of the individual verb reply for
details.
APS displays the appropriate reply screen automatically. Figure 6-15 shows a sample
screen.
Figure 6-15. RECEIVE-DATA Screen
T9089C00 SNAX/HLS Application Prototype Simulator (APS) 15 Jul 91 a20
Request: receive_data Session ID: 6
Reply: receive_data
Return code: 0
System error: 0
User error: 0
Retry Action: 0 not_applicable
Recovery Tags RDQ ESS TIP Comp DRI Data type Length
00001 - 00001 N N N Y 1 partner_data 17
User data: This is a message
Request complete
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16
OS PC CS RC RD ST SD SS SR GA SA Send Prnt Hex RSet Exit
User Aloc Open Clos Deal Resp Flow RCWT Rcov Exit