Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-26
SEGMENT_DEALLOCATE_CHKPT_ Procedure
SEGMENT_DEALLOCATE_CHKPT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The SEGMENT_DEALLOCATE_CHKPT_ procedure is called by a primary process to
deallocate an extended data segment in its backup process.
Syntax for C Programmers
This passive backup procedure is not supported in C programs. For a comparison of
active backup and passive backup, see the
Guardian Programmer’s Guide.
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. It returns one of the following values:
0 Segment successfully deallocated.
1 Segment deallocated, but an I/O error occurred when writing to the segment's
permanent swap file;
error-detail contains the file-system error number.
2 Parameter error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 Bounds error
4 Segment not deallocated;
error-detail contains the reason for failure.
segment-id input
INT:value
specifies the segment ID of the segment to be deallocated. The segment ID was
assigned by the program in the call to SEGMENT_ALLOCATE_ that allocated the
segment.
error := SEGMENT_DEALLOCATE_CHKPT_ ( segment-id ! i
,[ flags ] ! i
,[ error-detail ] ); ! o