Guardian Procedure Calls Reference Manual

RESIZESEGMENT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Considerations for Privileged Callers
Example
Related Programming Manual
Summary
The RESIZESEGMENT procedure alters the size of an existing data segment (for example, a segment
created by SEGMENT_ALLOCATE_).
NOTE: The RESIZESEGMENT procedure perform the same operation as the SEGMENT_RESIZE64_
Procedure (page 1295), which is recommended for new code.
Key differences in SEGMENT_RESIZE64__ are:
• The new-segment-size parameter is 64 bits wide.
Syntax for C Programmers
#include <cectdecs(RESIZESEGMENT)>
short RESIZESEGMENT ( short segment-id
,__int32_t new-segment-size );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := RESIZESEGMENT ( 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_ALLOCATE_).
new-segment-size
input
INT(32):value
is the new size for the data segment, in bytes.
1252 Guardian Procedure Calls (R)