Guardian Procedure Calls Reference Manual

SEGMENTSIZE Procedure (Superseded by SEGMENT_GETBACKUPINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The SEGMENTSIZE procedure returns the size of the specified segment in bytes.
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
seg-size := SEGMENTSIZE ( segment-id ); ! i
Parameter
segment-id
input
INT:value
is the segment ID number of a segment accessible by the calling process. If segment-id is
an invalid segment number or is a segment not accessible by the caller, then SEGMENTSIZE
returns -1D as an error indication.
Returned Value
INT(32)
Size of segment-id (in bytes), or -1D as an error indication if segment-id is an invalid segment
number or is a segment not accessible by the caller.
Example
INT(32) seglen := 0D;
INT segid := 2; ! pass to SEGMENTSIZE later
.
.
seglen := SEGMENTSIZE ( segid );
IF seglen = -1D THEN ...
SEGMENTSIZE Procedure (Superseded by SEGMENT_GETBACKUPINFO_ Procedure) 1301