Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-44
SET^FILE Procedure
Syntax for TAL Programmers
For pTAL callers, the procedure definition is:
For other callers, the procedure definition is:
Parameters
error returned value
INT
returns a file-system or sequential I/O (SIO) procedure error number indicating the
outcome of the SET^FILE.
If abort-on-error mode is in effect, the only possible value for
error is 0.
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.
error := SET^FILE ( { common-fcb } ! i
{ file-fcb } ! i
,operation ! i
,[ new-value ] ! i
,[ old-value ] ! o
,[ setaddr-value ]); ! i
error := SET^FILE ( { common-fcb } ! i
{ file-fcb } ! i
,operation ! i
,[ new-value ] ! i
,[ old-value ] ); ! o