SNAX/HLS Application Programming Manual

HLS-ALLOCATE Verb
SNAX/HLS Verbs
5–12 104707 Tandem Computers Incorporated
HLS-ALLOCATE Verb The HLS–ALLOCATE verb identifies and assigns a session for eventual use by the
application. The functions implied in this operation are automatically performed
when you issue an OPEN–SESSION verb.
Once having allocated a session, your process can now receive session–related
information such as operator messages (QMSG), open notifications, and so on. If the
HLS–ALLOCATE is issued over a Server Connection, the allocated session is
considered allocated to all server connections from the same process.
The SNAX/HLS systems programmer defines the appropriate values in the Resource
Definition Table (RDT) for PROFILE, BIND, or INIT attributes. The application
programmer must supply the PROFILE name and required indicators (for example,
PIPELINE–LU–IND) to use the verb.
If the session identified by LU–NAME has already been allocated, and this new request
bears a matching PROFILE–NAME or a blank PROFILE–NAME, the request is completed
without error. This is provided that the PIPELINE–LU–IND value matches that
required by the PROFILE and the session was previously allocated by an
HLS–ALLOCATE verb (and not by an OPEN–SESSION verb).
If the session identified by LU–NAME has already been allocated and is not open, but
the new request bears a different PROFILE–NAME, the old session is deallocated and a
new session reallocated. This occurs within SNAX/HLS, so that at no time is the
session identified by LU–NAME in an unallocated state. Any receive–type operations
pending on the session are terminated with the completion code
RC–SESSION–NOT–ALLOCATED. Furthermore, since a new session–ID value is
assigned, any program that had previously allocated this session is now unable to
access it without reissuing the HLS–ALLOCATE verb.
The most important value returned is SESSION–ID. This value uniquely identifies the
session to SNAX/HLS and locates the tables that store session–related information.
The application uses this returned session–ID value in all subsequent verbs for the
given session.