Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (R-Z)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
8-17
SEGMENT_GETBACKUPINFO_
Retrieves information about an extended segment that is allocated by the backup process
in a named process pair.
segment-id, INT:value input
flags, INT:value input
<0:14> Reserved (specify 0)
<15> = 1 Dirty pages in memory are not to be written to the swap file.
= 0 Dirty pages in memory are to be written to the swap file.
error-detail, INT .EXT:ref:1 output
error := SEGMENT_GETBACKUPINFO_ ( segment-id
,[ segment-size ]
,[ filename:maxlen ]
,[ filename-len ]
,[ error-detail ]
,[ base-address ] );
error, INT returned value
0No 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 The value of segment-id is out of range.
5 The value of segment-id is in range but is not allocated by caller.
6 Information not obtained; error-detail contains the reason for failure.
segment-id, INT:value input
segment-size, INT(32) .EXT:ref:1 output
filename:maxlen, STRING .EXT:ref:*,INT:value output:input