Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-30
SEGMENT_GETBACKUPINFO_ Procedure
segment-size output
INT(32) .EXT:ref:1
returns the current size in bytes of the specified segment. The size might be
rounded up from what was specified when the segment was allocated. See the
description of
segment-size under SEGMENT_ALLOCATE_ 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.
filename-len output
INT .EXT: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.
error-detail output
INT .EXT:ref:1
returns additional information associated with some errors.
if
error is 6, one of the following values is returned:
30 No message-system control blocks available
31 The process file segment (PFS) has no room for a message buffer in either
the backup or the primary.
201 Unable to send to the backup
See information under
error for other uses of error-detail.
base-address output
INT(32) .EXT:ref:1
returns the base address of the segment :
•
For a flat segment, base-address is different for each allocated segment.