Allocatesegment Errors; Error Codes - HP Guardian Errors 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_ALLOCATE64_ Errors" (page
"USESEGMENT Errors" (page
"SEGMENT_USE_Errors" (page

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. Refer to
(page 19), for information about these codes.
0
Cause The operation was completed successfully.
Effect None.
Recovery Informative message only; no corrective action is needed.
-1
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
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
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
Cause The ALLOCATESEGMENT call contained an illegal combination of options.
198 ALLOCATESEGMENT Errors
207). The error list for SEGMENT_USE_ is described in
209).
NO ERROR
ILLEGAL SEGMENT ID
ILLEGAL SEGMENT SIZE
BOUNDS VIOLATION ON SWAP FILE PARAMETER
ILLEGAL COMBINATION OF OPTIONS
"SEGMENT_ALLOCATE_ and
202). The error list for USESEGMENT is described in
"File-System Errors"