Guardian Procedure Calls Reference Manual

Returned Value
INT
A file-system or SIO procedure error code that indicates the outcome of the call.
If abort-on-error mode is in effect, the only possible error code is 0.
Operations
Table 42 lists operations that set values in the new-value parameter.
Table 43 lists operations that set addresses. For pTAL callers, addresses are set in the
setaddr-value parameter. For other callers, addresses are set in the new-value parameter.
In Table 42 and Table 43, the column labeled "State of File" indicates the file state required to
alter the file characteristic:
The file must be opened to alter the file characteristic.Open
The file must be closed to alter the file characteristic.Closed
The file can either be open or closed to alter the file characteristic.Any
The ASSIGN^SECEXT operation comes into effect only when an ASSIGN^PRIEXT (or
ASSIGN^PRIMARYEXTENTSIZE) operation is specified. If the primary extent (ASSIGN^PRIEXT)
has not been set explicitly, any parameter to set the secondary extent (ASSIGN^SECEXT) will be
ignored, and the secondary extent will have the default value.
.
Table 42 SET^FILE Operations That Set Values
State of Fileold-valuenew-valueDescription of Operation Requestedoperation
Closedblocklennew-blocklenSpecifies the block length, in bytes, for
the file.
ASSIGN^BLOCKBUFLEN (or
ASSIGN^BLOCKLENGTH)
Closedfile-codenew-file-codeSpecifies the file code for the file.ASSIGN^FILECODE
Closedopen-accessnew-open-accesssSpecifies the open access for the file:
READWRITE^ACCESS (0)
ASSIGN^OPENACCESS
READ^ACCESS (1)
WRITE^ACCESS (2)
Even if WRITE^ACCESS (2) is specified,
SIO actually opens the file with
READWRITE^ACCESS (0) to facilitate
interactive I/O.
Closedopen-exclusionnew-open-exclusionSpecifies the open exclusion for the file:
SHARE (0)
ASSIGN^OPENEXCLUSION
EXCLUSIVE (1)
PROTECTED (3)
Closedpri-ext-sizenew-pret-ext-sizeSpecifies the primary extent size (in units
of 2048-byte blocks) for the file.
ASSIGN^PRIEXT (or
ASSIGN^PRIMARYEXTENTSIZE)
Closedrecordlennew-recordlenSpecifies the logical record length (in
bytes) for the file.
ASSIGN^RECORDLEN (or
ASSIGN^RECORDLENGTH)
ASSIGN^RECORDLENGTH gives the
default read or write count. For default
values, see the Guardian Programmer's
Guide.
Closedsec-ext-sizenew-sec-ext-sizeSpecifies the secondary extent size (in
units of 2048-byte blocks) for the file.
ASSIGN^SECEXT (or
ASSIGN^SECONDARYEXTENTSIZE)
1306 Guardian Procedure Calls (S)