Guardian Procedure Calls Reference Manual

For other callers, the procedure definition is:
error := SET^FILE ( { common-fcb } ! i
{ file-fcb } ! i
,operation ! i
,[ new-value ] ! i
,[ old-value ] ); ! o
Parameters
common-fcb
input
INT:ref:*
identifies those files whose characteristics are to be altered.
The SET^FILE operations that make sense only for the common-fcb are the SET^BREAKHIT,
SET^ERRORFILE, and SET^TRACEBACK.
When using INIT^FILEFCB, INIT^FILEFCB^D00, FILE^FWDLINKFCB, FILE^BWDLINKFCB, and
SET^TRACEBACK, the FCB can be specified as the common-fcb or the file-fcb.
If an improper FCB is specified or the FCB is not initialized, an error is indicated.
file-fcb
input
INT:ref:*
identifies the file whose characteristics are to be altered. In most cases, the FCB must be
associated with a file or $RECEIVE.
When using INIT^FILEFCB, INIT^FILEFCB^D00, FILE^FWDLINKFCB, FILE^BWDLINKFCB, and
SET^TRACEBACK, the FCB can be specified as the common-fcb or the file-fcb.
If an improper FCB is specified or the FCB is not initialized, an error is indicated.
operation
input
INT:value
specifies the file characteristic to be altered. See Table 42 (page 1306) and Table 43 (page 1310).
new-value
input
INT:value
specifies a new value for the specified operation. This parameter is optional, depending on
the operation desired. For pTAL callers, some operations require that the setaddr-value
parameter be used.
old-value
output
INT:ref:*
is a variable in which the current value for the specified operation returns. This can vary
from 1 to 12 words and is useful in saving this value for reset later. If old-value is omitted,
the current value is not returned.
setaddr-value
input
WADDR:ref:*
for pTAL callers only, specifies a new address for the specified operation. This parameter
is optional, depending on the operation desired.
SET^FILE Procedure 1305