SNAX/HLS Application Programming Manual

HLSDEALLOCATE Verb
SNAX/HLS Verbs
5–22 104707 Tandem Computers Incorporated
HLS-DEALLOCATE
Verb
The HLS–DEALLOCATE verb causes the LU name to be deallocated. You must be an
allocator of this LU name. This is an enhanced verb, and is permitted only if the
session was allocated by the HLS–ALLOCATE verb. If more than one requester has
allocated the session, it is the last deallocator that actually releases the resources held
by SNAX/HLS.
If this verb is issued on a session that is currently open, the session is closed. Thus,
you can omit the HLS–CLOSE verb.
Any messages queued to the session are lost when the session is deallocated.
Request Format
77 VERB–HLS–DEALLOCATE pic 9(4) comp value 16.
01 HLS–DEALLOCATE–REQUEST.
02 VERB–CODE pic 9(4) comp.
02 SESSION–ID pic 9(4) comp.
02 COMPLETION–MODE pic X. (Q or W)
02 REQUEST–FORMAT pic X value space.
Reply Format (verb–code = 16)
01 HLS–DEALLOCATE–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–INVALID–COMPLETION–MODE
RC–INVALID–VERB RC–INSUFFICIENT–RESOURCES
RC–INVALID–SESSION–ID RC–SESSION–NOT–ALLOCATED
RC–FORTHCOMING RC–INVALID–VERB–LENGTH
Request Details
VERB–CODE
identifies the request by an integer constant (of value 16), named as follows:
VERB–HLS–DEALLOCATE (in SCOBOL)
VERB^HLS^DEALLOCATE (in TAL)
SESSION–ID
identifies this session. SNAX/HLS generates a session ID in response to an
OPEN–SESSION or an HLS–ALLOCATE verb.