SNAX/HLS Application Programming Manual

CONVERT-ERROR-CODE Verb
SNAX/HLS Verbs
5–6 104707 Tandem Computers Incorporated
USER–ERROR–DISPLAY
is the hexadecimal conversion of the value in USER–ERROR–CODE of the request.
RETURN–CODE–MESSAGE
is the textual translation of the value in RETURN–CODE of the request.
SYSTEM–ERROR–MESSAGE
is the textual translation of the value in SYSTEM–ERROR–CODE of the request.
Hexadecimal values are represented using the digits 0–9, A–F. The textual translation
of SYSTEM–ERROR–CODE and RETURN–CODE contains installation–specified text.
The text selected for SYSTEM–ERROR–CODE depends upon RETURN–CODE in the
request. If it is one of RC–SEND–CHECK, RC–SESSION–FAILURE, or
RC–REQUEST–REJECT, the value in SYSTEM–ERROR–CODE is interpreted as SNA
sense bytes. If it is RC–FILE–ERROR, the value is interpreted as
file–system error code. Other values of RETURN–CODE cause
CONVERT–ERROR–CODE to return blank text.
Figure 5–1 shows a session example using the CONVERT–ERROR–CODE verb.
Figure 5–1. Example of CONVERT–ERROR–CODE
REQUESTER SNAX/HLS
CONVERT-ERROR-CODE
RETURN-CODE = 22
SYSTEM-ERROR-CODE = %H081B
USER-ERROR-CODE = %H0000
CONVERT-ERROR-CODE
RETRY-ACTION-CODE = 0
USER-DATA-LENGTH = 78
SYSTEM-ERROR-DISPLAY= %H081B
USER-ERROR-DISPLAY = 0000
RETURN-CODE-MESSAGE = Request reject
SYSTEM-ERROR-MESSAGE= Receiver in transmit mode