SNAX/HLS Application Programming Manual

HLS RESPOND Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–43
HLS-RESPOND Verb The HLS–RESPOND verb directs SNAX/HLS to issue a response to previously
received partner data. The verb is legal only if the PROFILE indicates that
USER–RESPONSES is YES. If the verb is issued when USER–RESPONSES are not
enabled, it is treated as an illegal verb, producing the return code of
RC–INVALID–VERB. If the sequence numbers do not correspond to a pending
response, the return code RC–SEND–CHECK, with a sense code of %H200E (Response
Not Correlated), is returned.
If an attempt is made to issue a positive response to a message that has not yet been
completely received (that is, MESSAGE–COMPLETE–IND is N), the attempt is rejected
with a sense code of %H200F (Response Protocol Error).
Request Format
77 VERB–HLS–RESPOND pic 9(4) comp value 18.
01 HLS–RESPOND–REQUEST.
02 VERB–CODE pic 9(4) comp.
02 SESSION–ID pic 9(4) comp.
02 COMPLETION–MODE pic X. (W)
02 REQUEST–FORMAT pic X value space.
02 RESPONSE–TYPE pic X. (P or N)
02 FUTURE pic X.
02 MESSAGE–TAG pic S9(4) comp.
02 SENSE–TEXT.
03 SENSE–DATA pic S9(4) occurs 2 times.
Reply Format (verb–code = 18)
01 HLS–RESPOND–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–INVALID–VERB–LENGTH
RC–SYNTAX–ERROR RC–POSSIBLE–DATA–LOSS
RC–SESSION–FAILURE RC–SESSION–TERMINATED
RC–SEND–CHECK RC–SESSION–NOT–ALLOCATED