Guardian Procedure Errors and Messages Manual

11 SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_
Errors
This section lists and describes the error codes and error lists associated with the
SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_ procedure. The SEGMENT_ALLOCATE_
and SEGMENT_ALLOCATE64_ error codes are the values returned in the error parameter to
SEGMENT_ALLOCATE_. The same error codes are returned by SEGMENT_ALLOCATE_CHKPT_.
Error codes and error lists associated with the ALLOCATESEGMENT procedure are described in
“ALLOCATESEGMENT Errors” (page 200). The error list for USESEGMENT is described in
“USESEGMENT Errors” (page 209). The error list for SEGMENT_USE_ is described in
“SEGMENT_USE_Errors” (page 211).
NOTE: The error codes defined in the subsequent sections are applicable to both
SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_ APIs.
Error Codes
This subsection lists each SEGMENT_ALLOCATE_ procedure error code and provides a description
of each code.
0 NO ERROR
Cause The operation was completed successfully.
Effect None.
Recovery Informative message only; no corrective action is needed.
1 ERROR CREATING OR OPENING SEGMENT SWAP FILE
Cause The system encountered an error while creating or opening the swap file. The error-detail
parameter contains the error number of the file-system error that occurred.
Effect The procedure sets the error code and returns without allocating the extended data segment.
Recovery Correct the call to SEGMENT_ALLOCATE_ to make sure the correct swap file is specified.
If there is no disk space available to create the swap file, either specify a different volume or create
space on the desired volume.
2 PARAMETER ERROR
Cause The SEGMENT_ALLOCATE_ call contained an illegal combination of options. Possible causes
include:
• Omitting the required segment-id parameter
• Supplying a max-sizevalue that is inconsistent with segment-size
• Supplying an invalid segment-type
• Setting one or more reserved, must be 0 bits to a nonzero value
The error-detail parameter contains the ordinal number of the first (leftmost) parameter encountered
whose option is in error.
Effect The procedure sets the error code and returns without allocating the extended data segment.
204 SEGMENT_ALLOCATE_ and SEGMENT_ALLOCATE64_ Errors