Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (R-Z)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
8-14
SEGMENT_ALLOCATE_
Allocates an extended data segment for use by the calling process.
error := SEGMENT_ALLOCATE_ ( segment-id
,[ segment-size ]
,[ filename:length ]
,[ error-detail ]
,[ pin ]
,[ segment-type ]
,[ base-address ]
,[ max-size ]
,[ alloc-options ] );
error, INT returned value
0No error.
1 File-system error related to the creation or open of 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 Invalid segment-id.
5 Invalid segment-size.
6 Unable to allocate segment space.
7 Unable to allocate segment page table space.
8 Security violation when attempting to share segment.
9
The pin parameter does not exist.
10
The pin parameter does not have the segment allocated.
11 Caller is trying to share segment with self.
12 Requested shared segment is incompatible.
13 The segment-id parameter is already allocated by this process.
14 Unable to allocate process segment table (PST); error-detail contains the file-
system error number.
15 Part or all of the requested address range has already been allocated.
segment-id INT:value input
segment-size INT(32):value input
filename:length STRING .EXT:ref:* INT:value input:input