Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-45
SET^FILE Procedure
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 14-2
on page 14-46 and
Table 14-3
on page 14-56.)
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.
Considerations
•
Table 14-2 on page 14-46 contains operations that set values in the new-value
parameter.
•
Table 14-3 on page 14-56 contains 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 14-2 on page 14-46 and Table 14-3 on page 14-56, the column labeled
“State of File” is flagged with the following:
Open The file must be opened to alter the file’s characteristics.
Closed The file must be closed to alter the file’s characteristics.
Any The file can either be open or closed to alter the file’s characteristics.