TOPS-10 Monitor Calls Manual Volume 2 AA-K039D ... - Trailing-Edge

RENAME [OPCOOE 055]
RESTRICTION
If your program attempts to change the extension of an SFO, a
protection error results. An error also results if your program
attempts to alter the name, extension, or PPN associated with a UFO or
the PPN associated with an ersatz device name.
SKIP RETURN
On a skip return, the monitor returns the same information on a RENAME
as on a LOOKUP and ENTER. Refer to Section 11.13.
ERROR RETURN
The error return is taken under the following conditions:
o
o
o
No file has been opened on the specified channel.
The specified file cannot be found.
The specified file is currently in the process of being
written, superseded, or renamed.
o Your program does not have the appropriate privileges to
RENAME the file.
o The new file name already exists (occurs when changing file
names) .
The monitor returns the error code for the RENAME monitor
right half of addr+1 of the 4-word argument block, or
half of addr+3 in the extended argument block. The
overwrites the high-order three bits of the creation
entire access date.
call in the
in the right
error code
date and the
This overwriting of data does not cause any problems for programs that
recover from RENAME errors by aborting or by re-initializing the
argument list. However, programs that attempt to recover from an
error by fixing only the incorrect portion of the argument block and
then reexecuting the monitor call should restore the right half of
addr+1 or addr+3 before reexecuting the RENAME monitor call. Error
codes are restricted to a maximum of 15 bits to allow programs to
recover from an error in a file with a zero creation date. See
Section 11.14 for a list of error codes.
22-350