SNAX/HLS Application Programming Manual

ALLOCATE Verb
Application Prototyping and Simulation (APS) System
6–10 104707 Tandem Computers Incorporated
Aloc: HLS-ALLOCATE
Verb (SF2)
The HLS-ALLOCATE request is used to allocate resources in SNAX/HLS that are
used to manage any session you plan to open by a following HLS-OPEN request.
The request identifies the name of the partner LU, the name of the PROFILE
containing the rules of the session, and whether the session is a pipelined session—a
property that allows more than one server process to receive data from a given session.
It is important to note that this request does not cause communication with your
partner or the Tandem SNA access method (for example, SNAX/XF). Therefore, a
successful completion of the HLS-ALLOCATE request should not be interpreted as
confirmation that the partner LU exists in any way.
The principal advantage of using HLS-ALLOCATE and HLS-OPEN to create sessions,
instead of a simple OPEN-SESSION, is an enhanced set of capabilities:
You can receive operator messages without necessarily opening the session.
You can later open sessions in nowait mode by using the Q completion mode on
the HLS-OPEN verb. While waiting for notification that your session has been
opened, you can receive operator messages.
You can specify application names longer than eight characters on the HLS-OPEN
request.