Error Lists; Error From Ssget Or Ssgettkn; Unconditional Tokens - HP Guardian Errors Manual

Recovery No recovery is possible. Report this error to your service provider.
-27
Cause Currently, no more than one format ID can be active at one time.
Effect The requested operation is not completed.
Recovery Recode your program to format only one buffer at a time.

Error Lists

If a HP subsystem calls an SPI procedure and an SPI error occurs—that is, the call returns a nonzero
value in status—the subsystem normally attempts to recover from the error. If it can't recover (for
example, when the application program buffer is corrupted), the subsystem returns information to
the application in an error list. The following pages describe the error list associated with each
SPI procedure.
The contents of the error list depend on which procedure was called. The standard SPI token
ZSPI-TKN-PROC-ERR, which is present in every SPI error list, identifies the procedure.
Each error list always includes the unconditional tokens listed under its description in this subsection.
In addition, each error list can include any of the conditional tokens listed under its description.
If you are designing a subsystem that uses SPI, follow these guidelines when constructing an error
list for an SPI error:
Include all unconditional tokens listed in the error-list description.
Optionally include any or none of the conditional tokens listed in the error-list description.
This subsection does not discuss the mechanics of error-list construction. For information about
creating error lists, for additional information about tokens and token types, and for definitions of
tokens whose names begin with ZSPI-, refer to the SPI Programming Manual.

Error From SSGET or SSGETTKN

A call to SSGET or SSGETTKN returned an error.

Unconditional Tokens

ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
ZSPI-TKN-PROC-ERR
ZSPI-TKN-PARM-ERR
ZSPI-TKN-ENDLIST
Conditional Tokens
ZSPI-TKN-SSID-ERR
Unconditional Tokens
ZSPI-TKN-ERROR is the standard SPI token, whose value consists of the fields Z-SSID and Z-ERROR.
Z-SSID is the SPI subsystem identifier ZSPI-VAL-SSID. Z-ERROR is the status value from the SPI
procedure SSGET or SSGETTKN.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is ZSPI-VAL-SSGET (2)
or ZSPI-VAL-SSGETTKN (3).
ZSPI-TKN-PARM-ERR contains fields ZTOKENCODE, ZINDEX, and ZOFFSET. The value of
ZTOKENCODE is the token code or the first 32 bits of the token map passed in the call that failed.
ZINDEX is the index parameter passed in the call that failed. ZOFFSET is 0.
216 Subsystem Programmatic Interface (SPI) Errors
ZSPI-ERR-NO-FORMATID No format ID available
token-type ZSPI-TYP-LIST.
token-type ZSPI-TYP-ERROR.
token-type ZSPI-TYP-ENUM.
token-type ZSPI-TYP-PARM-ERR.
token-type ZSPI-TYP-SSCTL.
token-type ZSPI-TYP-SSID.