SNAX/HLS Application Programming Manual

SCOBOLX Applications
SNAX/HLS Programming Standards
1–2 104707 Tandem Computers Incorporated
By judicious use of these variables, your program can avoid specific numeric
references to SNAX/HLS data types when analyzing the responses to receive type
verbs RECEIVE-DATA, RECEIVE-CONTROL, or RECEIVE-CONTROL-WAIT.
Section RETURN-CODE-DEFINITIONS
Use the following statement within the working storage section of the data division to
include the RETURN-CODE-DEFINITIONS section of the copybook in your program:
copy RETURN-CODE-DEFINITIONS of HLSDDS.
Using a series of equates, this section defines return-code values for the return-code
names. For example, the following equate defines 0 as the value assigned to RC-OK:
77 RC-OK pic 9(4) comp value 0.
By judicious use of these variables, your program can avoid specific numeric
references to SNAX/HLS return codes.
Section VERBS
The VERBS section defines the structure of SNAX/HLS requests and replies suitable
for use on the server link. Use the following statement within the working storage
section of the data division to include the VERBS section of the copybook in your
program:
copy VERBS of HLSDDS.
Because SCOBOLX does not allow symbolic constants, a copybook cannot define
varying-length data areas. The definitions in this section serve as building blocks that
your program uses to build requests and analyze replies. The defined structures do
not include data-area definitions (which your program must therefore supply).
A verb request contains a standard request header (REQUEST-HEADER or HLS-
REQUEST-HEADER) followed by the building block(s) needed for the given verb.
Each verb request consists of one, two, or three parts, as shown in Table 1-1.