OSI/AS Management Programming Manual

Appendix A Errors and Error Lists
056785 Tandem Computers Incorporated A–1
This appendix presents all the error numbers defined by the OSI/AS subsystem—that
is, the values whose symbolic names begin with ZOSI-ERR-—and describes the error
list associated with each error number. These error numbers occur as values of the
return token, ZSPI-TKN-RETCODE, and also as the value of the Z-ERROR field of the
error token, ZSPI-TKN-ERROR, within the error list. All the errors described in this
appendix represent error conditions rather than warning conditions.
The Distributed Systems Management (DSM) Programming Manual describes what error
lists are and how an application retrieves them from the response buffer. Section 3,
“SPI Programming Considerations for OSI/AS,” gives general information about
handling errors reported by the OSI/AS subsystem. Section 5, “Commands and
Responses,” gives error handling information pertaining to specific commands.
In this appendix, tokens and their values are represented in DDL. For a quick
explanation of DDL, refer to the appendix “Overview of DDL for SPI” in the
Distributed Systems Management (DSM) Programming Manual.
ZCOM Errors Returned
by OSI/AS
OSI/AS also returns the following common data communications (ZCOM) errors:
ZCOM-ERR-OK ZCOM-ERR-OBJ-NOT-FOUND
ZCOM-ERR-EMPT-RSP ZCOM-ERR-OBJ-NOT-SUPP
ZCOM-ERR-CMD-ACCEPTED ZCOM-ERR-OBJNAME-INV
ZCOM-ERR-CMD-INV-IN-SUMSTATE ZCOM-ERR-PIN-TOO-BIG
ZCOM-ERR-CMD-MISMATCH ZCOM-ERR-SPI-ERR
ZCOM-ERR-CMD-NOT-SUPP ZCOM-ERR-SSID-INV
ZCOM-ERR-CMD-TOO-LARGE ZCOM-ERR-TKN-CODE-INV
ZCOM-ERR-FNAME-INV ZCOM-ERR-TKN-DUP
ZCOM-ERR-FS-ERR ZCOM-ERR-TKN-LEN-INV
ZCOM-ERR-FTYPE-INV ZCOM-ERR-TKN-REQ
ZCOM-ERR-MAX-LIMIT-EXCEEDED ZCOM-ERR-TKN-VAL-INV
ZCOM-ERR-NO-MEM-SPACE ZCOM-ERR-VAL-REQ
ZCOM-ERR-OBJ-ALRDY-DEF ZCOM-ERR-VSN-INCOMP
ZCOM-ERR-OBJ-ALRDY-IN-SUMSTATE
These errors, along with their error lists, are described in the Communications
Management Programming Manual.
Notation Used Each error-list description on the following pages includes a box listing all the tokens
that can appear in the error list, including the ZSPI-TKN-ERRLIST and ZSPI-TKN-
ENDLIST tokens that start and end all error lists. With the exception of those two
tokens, the order of the tokens in the box is not necessarily the order in which they will
actually occur in the buffer. The notation used in the box for simple tokens is a
shorthand version of the essential information given in the DDL TOKEN-CODE
statement.
Following the box, the tokens in the error list (except the enclosing tokens ZSPI-TKN-
ERRLIST and ZSPI-TKN-ENDLIST) are described in the same order in which they
appear in the box. These two tokens serve the same function in all error lists, so they