Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-7
SEGMENT_ALLOCATE_ Procedure
•
The parameter length specifies the length in bytes of the character string pointed
to by
filename. The parameters filename and length must either both be
supplied or both be absent.
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. It contains one of the following values:
0 No 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
#include <cextdecs(SEGMENT_ALLOCATE_)>
short SEGMENT_ALLOCATE_ ( short segment-id /* i 1 */
,[ __int32_t segment-size ] /* i 2 */
,[ char *filename ] /* i:i 3 */
,[ short length ] /* i:i 3 */
,[ short *error-detail ] /* o 4 */
,[ short pin ] /* i 5 */
,[ short segment-type ] /* i 6 */
,[ __int32_t *base-address ]] /* i,o 7 */
,[ __int32_t max-size ] /* i 8 */
,[ short alloc-options ]););/*i 9*/
error := SEGMENT_ALLOCATE_ ( segment-id ! i 1 !
,[ segment-size ] ! i 2 !
,[ filename:length ] ! i:i 3 !
,[ error-detail ] ! o 4 !
,[ pin ] ! i 5 !
,[ segment-type ] ! i 6 !
,[ base-address ] ! i,o,7 !
,[ max-size ] ! i 8 !
,[ alloc-options ] ); ! i 9 !