SNAX/HLS Application Programming Manual

1 SNAX/HLS Programming
Standards
104707 Tandem Computers Incorporated 1–1
Although application programs written in any Tandem language can communicate
with SNAX/HLS, the most support is offered for those written in SCOBOLX and TAL.
The following subsections discuss programming standards and conventions relative to
SCOBOLX, TAL, and other languages.
SCOBOLX
Applications
Relative to a SCOBOLX application program, SNAX/HLS can be considered either a
server or a device. The application communicates with SNAX/HLS through the
server link or through the intelligent device interface.
HLSDDS - SCOBOLX
Copybook
The copybook HLSDDS contains data definitions that standardize and simplify access
to SNAX/HLS for SCOBOLX application programs. The copybook provides
definitions for:
Verb names and codes (for the server link)
Return names and codes
Data-type names and codes
Request and reply structures (for the terminal link)
For information on server and terminal links refer to the subsection “Connection
Types” in Section 3, “Sessions.”
The HLSDDS file should never be included in its entirety in your program; only the
required sections should be mentioned in COPY statements.
Section VERB-CODE-DEFINITIONS
Use the following statement within the working storage section of the data division to
include the VERB-CODE-DEFINITIONS section of the copybook in your program:
copy VERB-CODE-DEFINITIONS of HLSDDS.
Using a series of equate statements, this section defines the verb code for each verb
name. For example, the verb code for the OPEN-SESSION request is defined by:
77 VERB-OPEN-SESSION pic 9(4) comp value 1.
By judicious use of these variables, your program can avoid specific numeric
references to SNAX/HLS verbs.
Section DATA-TYPE-DEFINITIONS
Use the following statement within the working storage section of the data division to
include the DATA-TYPE-DEFINITIONS section of the copybook in your program:
copy DATA-TYPE-DEFINITIONS of HLSDDS.
Using a series of equate statements, this section defines the values for each data type.
For example, the following equate defines the SSCP-DATA type to have a value of 2.
77 DT-SSCP-DATA pic S9(4) comp value 2.