SNAX/HLS Application Programming Manual

SCOBOLX Applications
SNAX/HLS Programming Standards
1–4 104707 Tandem Computers Incorporated
A verb reply contains the standard reply header (REPLY-HEADER) followed by the
building block(s) needed for the given verb reply, as shown in Table 1-2.
Table 1-2. Additional Building Blocks of Replies
Verb Name Building Blocks to Use After REPLY-HEADER
OPEN-SESSION OPEN-SESSION-REPLY
CLOSE-SESSION
PREPARE-TO-CLOSE
RECEIVE-CONTROL RECEIVED-DATA-TEMPLATE LEN*
RECEIVE-CONTROL-WAIT RECEIVED-DATA-TEMPLATE LEN*
RECEIVE-DATA RECEIVED-DATA-TEMPLATE LEN DATA*
REQUEST-SEND-STATE
SEND-DATA SEND-DATA-REPLY
SEND-STATUS
CONVERT-ERROR-CODE CONVERT-ERROR-CODE-REPLY
SEND-AND-RECEIVE-DATA (Cannot occur)
GET-ATTRIBUTES GET-ATTRIBUTES-REPLY LEN DATA*
SET-ATTRIBUTES
HLS-CALL-USER HLS-CALL-USER-REPLY LEN DATA*
HLS-ALLOCATE
HLS-OPEN HLS-OPEN-REPLY
HLS-DEALLOCATE
HLS-CLOSE
HLS-RESPOND
HLS-FLOW-CONTROL
The LEN and DATA components (marked above with an asterisk [*]) indicate the data
definitions you supply. The following example shows such a definition for a reply
data area.
01 LEN PIC 9999 COMP VALUE 0.
01 DATA
05 USER-DATA PIC X
OCCURS 0 TO max TIMES
DEPENDING ON LEN.
Your program would supply a value of max equal to the maximum number of bytes
that can arrive. This value should be at least 256 (to receive a general input message).
The upper limit is determined by the Tandem NonStop Kernel and your Pathway
environment configuration.