Usesegment Errors; Error Lists; 2: Zgrd-Val-Usesegment; Unconditional Tokens - HP Guardian Errors Manual

12 USESEGMENT Errors

This section contains the error list associated with the USESEGMENT procedure. There are no error
codes associated with USESEGMENT; USESEGMENT does not return error codes.
Note that the USESEGMENT procedure is similar to the SEGMENT_USE_ procedure. You would
typically use the SEGMENT_USE_ procedure on D-series and later releases, while you used the
USESEGMENT procedure on C-series releases. See
error list associated with the SEGMENT_USE_ procedure.
Also see "ALLOCATESEGMENT Errors" (page
the ALLOCATESEGMENT procedure. See
Errors" (page
procedure.

Error Lists

If you are using the Subsystem Programmatic Interface (SPI) to send commands to a subsystem,
you might receive a USESEGMENT error list in a response. Subsystems return such an error list
when, in performing your request, they call the USESEGMENT procedure directly or indirectly and
an error occurs on the call.
The standard SPI token ZSPI-TKN-PROC-ERR, which is present in every USESEGMENT error list,
identifies the procedure. Its value is ZGRD-VAL-USESEGMENT (2).
The error list always includes the unconditional tokens listed under its description in this section.
In addition, the 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 a
USESEGMENT error list:
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 section does not discuss the mechanics of error-list construction. For information about creating
error lists, additional information about tokens and token types, and definitions of tokens whose
names begin with ZSPI-, refer to the SPI Programming Manual.

2: ZGRD-VAL-USESEGMENT

A condition code less (CCL) was returned by a call to USESEGMENT. Either the segment ID in
ZGRD-TKN-SEGMENTID is not allocated or it cannot be used by a nonprivileged caller.

Unconditional Tokens

ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
ZSPI-TKN-PROC-ERR
ZSPI-TKN-ENDLIST
Conditional Tokens
ZGRD-TKN-OBJECTFILE
ZGRD-TKN-SEGMENTID
ZGRD-TKN-OLDSEGMENT
Unconditional Tokens
ZSPI-TKN-ERROR is the standard SPI error token, whose value consists of the fields Z-SSID and
Z-ERROR. Z-SSID is the subsystem identifier ZGRD-VAL-SSID. Z-ERROR is the error code returned
in the status parameter of USESEGMENT.
202), for error codes and error lists associated with the SEGMENT_ALLOCATE_
token-type ZSPI-TYP-LIST.
token-type ZSPI-TYP-ERROR.
token-type ZSPI-TYP-ENUM.
token-type ZSPI-TYP-SSCTL.
token-type ZSPI-TYP-FNAME.
token-type ZSPI-TYP-INT.
token-type ZSPI-TYP-INT.
"SEGMENT_USE_Errors" (page
198), for error codes and error lists associated with
"SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_
209), for the
Error Lists 207