Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (A-C)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
4-6
ALLOCATESEGMENT
(Superseded by SEGMENT_ALLOCATE_) Allocates a selectable extended data
segment for use by the calling process. It can also be used to share selectable extended
data segments or flat extended data segments allocated by other processes.
status := ALLOCATESEGMENT ( segment-id
,[ segment-size ]
,[ filename ]
,[ pin-and-flags ] );
status, INT returned value
0No error.
1-999 File-system error related to the creation or open of the swap file.
-1 Illegal segment-id.
-2 Illegal segment-size.
-3 Bounds violation on file-name.
-4 Illegal combination of options.
-5 Unable to allocate segment space.
-6 Unable to allocate segment page table space.
-7 Security violation on attempt to share segment.
-8
The pin does not exist.
-9
The does not have the segment allocated.
-10 Trying to share segment with self.
-11 Requested segment is currently being resized or is incompatible.
segment-id, INT:value input
segment-size, INT(32):value input
filename, INT:ref:12 input, output
pin-and-flags, INT:value input
<8:15> Optional PIN for segment sharing.
<5:7> Not used; must be zero (0).
<4> Allocate an extensible segment.
<3> Allocate a segment sharable by the file-name method.