Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KMEM
error := SEGMENT_GETINFO[64]_ ( segment-id ! i
,[ segment-size ] ! o
,[ filename:maxlen ] ! o:i
,[ filename-len ] ! o
,[ error-detail ] ! o
,[ base-address ] ! o
,[ usage-flags ] ); ! o
Parameters
segment-id
input
INT:value
specifies the segment ID of the extended data segment for which information is to be returned.
segment-size
output
(for SEGMENT_GETINFO_)INT(32) .EXT:ref:1
(for SEGMENT_GETINFO64_)INT(64)
.EXT64:ref:1
returns the current size in bytes of the specified extended data segment. The size might be
rounded up from what was specified when the segment was allocated. For details, see the
description of the segment-size parameter of SEGMENT_ALLOCATE[64]_ Procedures
(page 1259). For a 64-bit segment with size greater than 0x7fffffff, SEGMENT_GETINFO_ reports
-1.
filename:maxlen
output:input
(for SEGMENT_GETINFO_)STRING .EXT:ref:*, INT:value
(for SEGMENT_GETINFO64_)STRING .EXT64:ref:*, INT:value
if present and maxlen is not 0, returns the fully qualified name of the segment's swap file.
If the segment is managed by the Kernel-Managed Swap Facility (KMSF), filename is
undefined. For more information on KMSF see the Kernel-Managed Swap Facility (KMSF)
Manual.
maxlen specifies the length in bytes of the string variable filename.
filename-len
output
(for SEGMENT_GETINFO_)INT .EXT:ref:1
(for SEGMENT_GETINFO64_)INT .EXT64:ref:1
returns the length in bytes of the swap-file name being returned.
If the segment is managed by the Kernel-Managed Swap Facility (KMSF), filename-len is
set to 0. For more information on KMSF see the Kernel-Managed Swap Facility (KMSF) Manual.
1288 Guardian Procedure Calls (S)