SNAX/HLS Configuration and Control Manual

Resource Definition
Product Overview
1–10 104705 Tandem Computers Incorporated
Data-Transfer Verbs Table 1-3 shows verbs used to transfer data between an application program and its
session partner:
Table 1-3. Data-Transfer Verbs
Verb Function
SEND-DATA Send data to the session partner.
RECEIVE-DATA Retrieves information from the receive queue.
SEND-AND-RECEIVE-DATA Sends data to session partner and then queues a RECEIVE-DATA
verb.
HLS-RESPOND Sends a response to partner’s request.
REQUEST-SEND-STATE Requests permission to send data.
SEND-STATUS Sends a SNA LUSTAT to the session partner.
HLS-FLOW-CONTROL Sends RTR, QEC, QC, or RELQ to the session partner.
RECEIVE-CONTROL Queries the top element of the receive queue and, if it is not the
partner’s data, retrieves it.
RECEIVE-CONTROL-WAIT Waits for a data element to arrive. It then queries the receive
queue and if the top element is not the partner’s data, retrieves it.
Resource Definition The SNAX/HLS operating environment presumes that a resource definition table
(RDT) exists. When the SNAX/HLS process starts, the RDT file is the standard IN file
for the process.
The RDT describes the characteristics of the SNAX/HLS environment. It contains all
the PROFILE, BIND, and INIT-SELF information that your site requires the
SNAX/HLS process to use.
When SNAX/HLS receives an HLS-ALLOCATE or OPEN-SESSION request from the
application program, the PROFILE section of the RDT is scanned for the PROFILE
name specified in the request. The PROFILE record references the necessary BIND or
INIT-SELF images. Thus, the application programmer need know only the PROFILE
name to specify the details of the SNA session.
The RDT accessed by SNAX/HLS is a file created by compiling an edit file. A sample
edit file, RDTTEXT, is distributed with the product, which contains many useful
profiles. You can choose to use the supplied RDTTEXT, or create your own using
RDTTEXT as a model.
The HLSRDT program performs the compilation of the text file into the RDT file
needed by SNAX/HLS.