SNAX/HLS Application Programming Manual

CLOSE Verb
Application Prototyping and Simulation (APS) System
104707 Tandem Computers Incorporated 6–13
Clos: HLS-CLOSE
Verb (SF4)
The HLS-CLOSE request is used to terminate communication with your session
partner. Unlike the CLOSE-SESSION request, this does not cause the deallocation of
your LU, thus making it possible to continue to receive operator messages. If you
allocated and opened your session with HLS-ALLOCATE and HLS-OPEN, you must
use the HLS-CLOSE and HLS-DEALLOCATE verbs to close and deallocate the
session.
The session is terminated in a forced fashion. However, any data or other messages
that remain on the session’s receive queue are still readable.
The HLS-CLOSE verb allows you to specify the reason for session closure. At
present, only the values 1 or 14 can be specified. A value of 1 indicates the session
is closing in an orderly fashion. This means that all send–type operations posted
ahead of the verb will be completed, the verb processed, the LU closed, and the
session terminated.
A value of 14 indicates the session will be closed forcefully. This means that
internal queues will be bypassed and that SNAX/HLS will immediately send an
UNBIND SNA request to the session partner (UNBIND type X'0E') and close the
LU specified in the LU name of the HLS-ALLOCATE verb.
To execute this verb in an APS session, display the request screen by pressing shifted
F4; enter the required parameter, and press the SEND function key (F12) to cause
SNAX/HLS to execute the function and terminate the session.