Guardian Procedure Calls Reference Manual

SEGMENT_RESIZE64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Considerations for Privileged Callers
Example
Related Programming Manual
Summary
The SEGMENT_RESIZE64_ procedure alters the size of an existing data segment (for example, a
segment created by SEGMENT_ALLOCATE_ or SEGMENT_ALLOCATE64_).
SEGMENT_RESIZE64_ is identical to RESIZESEGMENT except for the data type of the
new-segment-size parameter, which is INT(64).
NOTE: The SEGMENT_RESIZE64_ procedure is supported on systems running H06.20 and later
H-series RVUs and J06.09 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <kmem.h>
short SEGMENT_RESIZE64_ ( segid_t segment-id
,int64 new-segment-size );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KMEM
error := SEGMENT_RESIZE64_ ( segment-id ! i
,new-segment-size ); ! i
Parameters
segment-id
input
INT:value
is the segment ID of the data segment to be resized (for example, as specified in a call to
SEGMENT_ALLOCATE64_).
new-segment-size
input
INT(64):value
is the new size for the data segment, in bytes.
For a flat segment, the value must be in the range 1 byte through the maximum size defined
by the max-size parameter of the SEGMENT_ALLOCATE[64]_ procedure.
For a selectable segment, the value must be in the range 1 byte through 127.5 megabytes
(133,693,440 bytes).
SEGMENT_RESIZE64_ Procedure 1295