Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-33
CHECKDEALLOCATESEGMENT Procedure
(Superseded by
flags input
INT:value
if present, has the form:
<0:14>
Must be 0.
<15> 1 Indicates that dirty pages in memory are not to be copied to the swap
file (see the ALLOCATESEGMENT procedure).
0 Indicates that dirty pages in memory are to be copied to the swap file.
If omitted, this parameter defaults to 0.
error output
INT .EXT:ref:1
indicates the outcome of the call. This procedure returns all values returned by
DEALLOCATESEGMENT in the backup process, plus the following file-system
errors:
2 The segment ID is invalid or the backup process could not deallocate the
segment.
29 The
segment-id is missing.
30 No control blocks are available for linking.
31 Cannot use the process file segment (PFS), or the PFS has no room for a
message buffer in either the backup process or the primary process.
201 Unable to link to the backup process.
Condition Code Settings
< (CCL) is set if the error parameter is missing, or a bounds error occurs on the
error parameter.
= (CCE) is set by all other errors (see
error parameter).
> (CCG) is never returned from this procedure.
Considerations
•
Allocation by the primary process
The segment need not be allocated by the primary process at the time of the call to
CHECKDEALLOCATESEGMENT.
•
flags parameter
The
flags.<15> = 1 option is used to improve performance when the swap file is
a permanent file or a temporary file that is opened concurrently by an application.
Following the call to CHECKDEALLOCATESEGMENT, the contents of the swap