Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-33
SEGMENT_GETINFO_ Procedure
Parameters
error returned value
INT
Indicates the outcome of the operation. Returns one of the following values:
0 No error
1 Error occurred when attempting to obtain
filename; error-detail
contains the file-system error number.
2 Parameter error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 Bounds error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
4
segment-id is out of range.
5
segment-id is in range but not allocated by caller.
segment-id input
INT:value
specifies the segment ID of the extended data segment for which information is to
be returned.
segment-size output
INT(32) .EXT: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.
See the description of the
segment-size parameter of the
SEGMENT_ALLOCATE_ procedure for details.
filename:maxlen output:input
STRING .EXT: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.