Guardian Procedure Calls Reference Manual

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 these file-system errors:

The segment ID is invalid or the backup process could not deallocate the segment.2

The segment-id is missing.29

No control blocks are available for linking.30

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.

Unable to link to the backup process.201

Condition Code Settings

is set if the error parameter is missing, or a bounds error occurs on the error parameter.< (CCL)

is set by all other errors (see error parameter).= (CCE)

is never returned from this procedure.> (CCG)

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 file are unpredictable. If the

CHECKDEALLOCATESEGMENT call causes a purge of a temporary file, the system does not

write the dirty pages (that is, pages that are being used) out to the file. If the flags parameter

is missing, the default value of 0 is used.

• Segment deallocation

When a segment is deallocated, the swap file end of file (EOF) is set to the larger of (1) the

EOF when the file is opened by ALLOCATESEGMENT or (2) the end of the highest numbered

page that is written to the swap file. All file extents beyond the EOF that did not exist when

the file was opened are deallocated.

Before deallocating a segment, this procedure removes all memory access breakpoints set in

that segment.

• Shared segments

A shared segment remains in existence until it has been deallocated by all the processes that

allocated it.

CHECKDEALLOCATESEGMENT Procedure (Superseded by SEGMENT_DEALLOCATE_CHKPT_ Procedure) 135