SNAX/HLS Application Programming Manual

GET-ATTRIBUTES Verb
SNAX/HLS Verbs
5–10 104707 Tandem Computers Incorporated
USER–ERROR–CODE
is undefined and should not be analyzed.
RETRY–ACTION–CODE
is a summary indicator that indicates whether an unsuccessful request should be
retried. The value returned here can be installation–defined.
REQUEST–TYPE
is the same value as the request.
USER–DATA–LENGTH
is the length (in bytes) of the returned USER–DATA–S. This structure assumes that
the programmer defines the reply text as a variable– length array (that is, an
OCCURS DEPENDING ON clause in SCOBOLX/COBOL).
USER–DATA–S
contains the text of the reply. At present, only two subformats of the request are
defined, as documented below.
Reply for Type 1 (Get Profile Values)
TRANSLATION–IND
indicates whether character set translation is enabled for the session. A value of Y
confirms translation, and N denies it.
LARGE–MESSAGE–OPTION
indicates whether the option is enabled. A value of Y confirms that LMO is
enabled, and N denies it.
RESPONSE–TYPE
indicates which type of response is being used on your requests. The valid values
are 1, 2 or 3, corresponding to DR1, DR2, and DR1+DR2 (also known as DR3).
Reply for Type 2 (Get Bind Values)
Note that the information returned by this request contains SNA details and should be
interpreted by those knowledgeable in SNA. Because much of the information is
binary, SCOBOLX programs must take exceptional care when handling it.
TSPROFILE
contains the binary value defining the TS PROFILE, extracted from byte 2 of the
BIND message. You should see one of the values 2, 3, 4, or 7. A value of 0 can
occur only if a session is not started.