SNAX/HLS Application Programming Manual

SCOBOLX Applications
SNAX/HLS Programming Standards
104707 Tandem Computers Incorporated 1–5
Request and Reply Definitions
The HLSDDS copybook includes definitions of every request and reply used for the
Pathway IDS (Intelligent Device Support) interface. Section names are derived by
appending the letters -REQUEST or -REPLY to verb names. For example, the
copybook statements provided for the request and the reply for the OPEN-SESSION
verb are:
?SECTION OPEN-SESSION-REQUEST
...
?SECTION OPEN-SESSION-REPLY
...
Two important facts must be noted:
There is no SEND-AND-RECEIVE-DATA-REPLY section, as this structure never
occurs in a reply.
No user data areas are included in the definitions.
If the verb does not include variable-length data, the verb definition provided by the
section is complete. If the verb uses data, you define it as a level 02 structure. The
following example defines the request and reply to the RECEIVE-DATA verb. (You
must provide a real value for max .)
copy RECEIVE-DATA-REQUEST of HLSDDS.
copy RECEIVE-DATA-REPLY of HLSDDS.
02 RCV-LENGTH pic 9(4) comp.
02 RCV-TEXT pic X occurs 0 to max times
depending on RCV-LENGTH.
Use this technique for the following verbs, all of which use variable-length data:
SEND-DATA-REQUEST GET-ATTRIBUTES-REPLY
SEND-AND-RECEIVE-DATA-REQUEST RECEIVE-DATA-REPLY
HLS-CALL-USER-REQUEST HLS-CALL-USER-REPLY
HLS-OPEN-REQUEST
Section RC-NAME-TAB
Use the following statement to include the RC-NAME-TAB section of the copybook in
your program:
copy RC-NAME-TAB of HLSDDS.