PAM Management Programming Manual

PAM Management Programming Manual—142481

A-1

Error Numbers and Error Lists

This appendix presents all the error numbers provided by the PAM subsystem (that is,

the values whose symbolic names begin with ZPAM-ERR-) and describes the error lists

associated with these error numbers. These error numbers can occur as values of the

return token, ZSPI-TKN-RETCODE, and as part of the value of the error token, ZSPI-

TKN-ERROR.

What error lists are and how they are retrieved from the buffer is described in the SPI

Programming Manual. General information about how the PAM subsystem handles

errors is given in Section 3, SPI Programming Considerations for the PAM Subsystem

Error-handling information pertaining to specific commands and their responses is given

in Section 5, Commands and Responses.

In this appendix, all tokens and their values are represented in the Data Definition

Language (DDL). For an explanation of DDL as it applies to the Subsystem

Programmatic Interface (SPI), refer to the SPI Programming Manual.

Notation Used

For each error-list description on the following pages, there is a box that lists all the

tokens that can appear in the error list, including the tokens ZSPI-TKN-ERRLIST and

ZSPI-TKN-ENDLIST, which start and end all error lists. With the exception of these

tokens, the order of the tokens in the box is not necessarily the order in which they will

actually occur.

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, each token in the error list (except 4

ZSPI-TKN-ERRLIST and ZSPI-TKN-ENDLIST) is described in the same order in

which it appeared in the box. These two tokens serve the same function in all error lists,

so they are not described here. More information about these tokens can be found in the

SPI Programming Manual.

Error-List Descriptions

The descriptions on the following pages are given in ascending order by error number;

that is, in ascending order by the ZPAM-ERR- values.