SNAX/HLS Application Programming Manual

CLOSE-SESSION Verb
SNAX/HLS Verbs
5–2 104707 Tandem Computers Incorporated
CLOSE-SESSION Verb This verb is used to forcibly terminate a session by closing the LU associated with the
session ID. For a primary LU (PLU) session, the cleanup actions taken by the Tandem
access method (SNAX/XF or SNAX/CDF) include the transmission of an UNBIND.
HLS does a CLOSE (LU) and returns control back to the user process. SNAX/XF
thenasynchronously processes the UNBIND request. For a secondary LU (SLU)
session, cleanup includes a TERM–SELF (forced).
If the session is queued, it is terminated only when all openers of the session have
issued a CLOSE–SESSION verb or a CLOSE command.
This verb can be used only on sessions that were opened with the OPEN–SESSION
verb. If the session was opened with the HLS–OPEN verb, the CLOSE–SESSION verb
is rejected.
Request Format
77 VERB–CLOSE–SESSION pic 9(4) comp value 3.
01 CLOSE–SESSION–REQUEST.
02 VERB–CODE pic 9(4) comp.
02 SESSION–ID pic 9(4) comp.
Reply Format (verb–code = 3)
01 CLOSE–SESSION–REPLY.
02 VERB–CODE pic 9(4) comp.
02 SESSION–ID pic 9(4) comp.
02 RETURN–CODE pic 9(4) comp.
02 SYSTEM–ERROR–CODE pic S9(4) comp.
02 USER–ERROR–CODE pic S9(4) comp.
02 RETRY–ACTION–CODE pic 9(4) comp.
Return Codes
RC–OK RC–SESSION–NOT–ALLOCATED
RC–INVALID–VERB RC–INSUFFICIENT–RESOURCES
RC–INVALID–SESSION–ID RC–SESSION–TERMINATED
RC–INVALID–VERB–LENGTH
Request Details
VERB–CODE
identifies the request by an integer constant (of value 3), named as follows:
VERB–CLOSE–SESSION (in SCOBOL)
VERB^CLOSE^SESSION (in TAL)
SESSION–ID
identifies this session. SNAX/HLS generates a session ID in response to an
OPEN–SESSION and HLS–ALLOCATE verb.