Guardian Procedure Errors and Messages Manual

10 ALLOCATESEGMENT Errors
This section contains the error codes returned by the ALLOCATESEGMENT procedure and the error
lists associated with the ALLOCATESEGMENT procedure. Error codes and error lists associated
with the SEGMENT_ALLOCATE_ procedure are described in “SEGMENT_ALLOCATE_ and
SEGMENT_ALLOCATE64_ Errors” (page 204). 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).
Error Codes
The ALLOCATESEGMENT error codes are the values returned in the status parameter to
ALLOCATESEGMENT. ALLOCATESEGMENT error codes in the range 1 through 999 indicate a
file-system error related to the creation or opening of a swap file. For information about these
codes, see “File-System Errors” (page 19).
0 NO ERROR
Cause The operation was completed successfully.
Effect None.
Recovery Informative message only; no corrective action is needed.
-1 ILLEGAL SEGMENT ID
Cause The ALLOCATESEGMENT call either specified an invalid extended data segment ID (not in
the range 0 through 1023) or used the extended data segment ID of a currently allocated extended
data segment.
Effect The procedure sets the error code and returns without allocating the extended data segment.
Recovery Specify a valid extended data segment ID, then retry the operation. User processes can
specify an extended data segment ID equal to 1023 or less; only processes supplied by HP can
specify an extended data segment ID greater than 1023.
-2 ILLEGAL SEGMENT SIZE
Cause The ALLOCATESEGMENT call specified an invalid extended data segment size.
Effect The procedure sets the error code and returns without allocating the extended data segment.
Recovery Specify a valid extended data segment size, then retry the operation. The range of valid
values for a selectable segment is between 1 byte and 127.5 megabytes. (To allocate a shared
flat segment, you must use the SEGMENT_ALLOCATE_ procedure.)
-3 BOUNDS VIOLATION ON SWAP FILE PARAMETER
Cause A bounds violation occurred on the ALLOCATESEGMENT swap-file name.
Effect The procedure sets the error code and returns without allocating the extended data segment.
Recovery Pass a correct reference address or the swap-file name to ALLOCATESEGMENT.
-4 ILLEGAL COMBINATION OF OPTIONS
Cause The ALLOCATESEGMENT call contained an illegal combination of options.
200 ALLOCATESEGMENT Errors