Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (R-Z)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
8-18
SEGMENT_GETINFO_
Retrieves information about a currently allocated extended segment.
The bits, when set to 1, indicate the following:
filename-len, INT .EXT:ref:1 output
error-detail, INT .EXT:ref:1 output
base-address, INT(32) .EXT:ref:1 output
error := SEGMENT_GETINFO_ ( segment-id
,[ segment-size ]
,[ filename:maxlen ]
,[ filename-len ]
,[ error-detail ]
,[ base-address ]
,[ usage-flags ] );
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.
segment-id, INT:value input
segment-size, INT(32) .EXT:ref:1 output
filename:maxlen, STRING .EXT:ref:*,INT:value output:input
filename-len, INT .EXT:ref:1 output
error-detail, INT .EXT:ref:1 output
base-address, INT(32) .EXT:ref:1 output
usage-flags, INT .EXT:ref:1 output