Guardian Procedure Errors and Messages 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 can
typically use the SEGMENT_USE_ procedure on D-series and later releases, while you used the
USESEGMENT procedure on C-series releases. For information on the error list associated with
the SEGMENT_USE_ procedure, see “SEGMENT_USE_Errors” (page 211).
Also for error codes and error lists associated with the ALLOCATESEGMENT procedure, see
“ALLOCATESEGMENT Errors” (page 200). For error codes and error lists associated with the
SEGMENT_ALLOCATE_ procedure, see “SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_
Errors” (page 204).
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-, see 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 token-type ZSPI-TYP-LIST.
ZSPI-TKN-ERROR token-type ZSPI-TYP-ERROR.
ZSPI-TKN-PROC-ERR token-type ZSPI-TYP-ENUM.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
Conditional Tokens
ZGRD-TKN-OBJECTFILE token-type ZSPI-TYP-FNAME.
ZGRD-TKN-SEGMENTID token-type ZSPI-TYP-INT.
ZGRD-TKN-OLDSEGMENT token-type ZSPI-TYP-INT.
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.
Error Lists 209