Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)

Guardian Procedure Calls Reference Manual—522629-013

14-23

SEGMENT_DEALLOCATE_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example

Related Programming Manual

Summary

The SEGMENT_DEALLOCATE_ procedure deallocates an extended data segment.

Syntax for C Programmers

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.

#include <cextdecs(SEGMENT_DEALLOCATE_)>

short SEGMENT_DEALLOCATE_ ( short segment-id

,[ short flags ]

,[ short *error-detail ] );

error := SEGMENT_DEALLOCATE_ ( segment-id ! i

,[ flags ] ! i

,[ error-detail ] ); ! o