OSI/TS Management Programming Manual

Appendix A Errors and Error Lists
056786 Tandem Computers Incorporated A–1
This appendix presents all the error numbers defined by the OSI/TS subsystem— that
is, the values whose symbolic names begin with ZOS4-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. In the
manual you are now reading, Section 3, “SPI Programming Considerations for
OSI/TS,” gives general information about handling errors reported by the OSI/TS
subsystem, and 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.
The following errors are defined by OSI/TS:
11: ZOS4-ERR-OBJ-ACTV
13: ZOS4-ERR-NO-BKUP
ZCOM Errors Returned
by OSI/TS
OSI/TS also returns the following common data communications (ZCOM) error:
ZCOM-ERR-PIN-TOO-BIG
This error, along with it's error list, is 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
are not described here. For more information about these tokens, refer to the
Distributed Systems Management (DSM) Programming Manual.
Descriptions of ZOS4
Errors
The following pages provide descriptions of the errors defined by the OSI/TS
subsystem. They are given in ascending order by error number.