Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-4
DEALLOCATESEGMENT Procedure
(Superseded by SEGMENT_DEALLOCATE_
Summary
The DEALLOCATESEGMENT procedure deallocates an extended data segment when
it is no longer needed by the calling process.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be
used for new development. This procedure is supported only for compatibility with
previous software.
Syntax for TAL Programmers
Parameters
segment-id input
INT:value
is the segment number of the segment, as specified in the call to
ALLOCATESEGMENT that created it.
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 ALLOCATESEGMENT procedure).
0 indicates that dirty pages in memory are to be copied to the swap file.
This parameter is ignored if the swap space was allocated using the Kernel-
Managed Swap Facility (KMSF).
The default is 0.
Condition Code Settings
< (CCL) Segment not deallocated—an illegal segment ID was supplied or the
specified segment is currently in use by the operating system; for example,
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
CALL DEALLOCATESEGMENT ( segment-id ! i
,[ flags ] ); ! i