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

RENAME [OPCODE 055]
22.137 RENAME [OPCODE 055]
FUNCTION
Performs one or more of the following functions:
o Alters file attributes, including the file name,
extension, and access privilege code of the file.
file
o
o
o
Changes an SFD name.
Deletes the specified file.
Performs an implicit CLOSE.
Use FILOP. to perform a RENAME on an extended I/O channel.
CALLING SEQUENCE
RENAME channo,addr
error return
skip return
In the calling sequence, the program supplies the following variables:
o channo is the number of an initialized channel. If the
channel is an extended channel, use FILOP. function . FORNM.
o
addr is the address of the argument list.
rs--equivalent to that of LOOKUP and
described in Section 11.13.
The argument list
ENTER calls and is
RENAME has two forms of argument block: the four-word block and the
extended argument block. The short-form (4-word) argument list is
described in Section 11.13.1. The extended argument list is described
in section 11.13.2. For DECtape files, refer to Chapter 13 for
descriptions of the arguments.
The only way that your program can RENAME a file into or out of an SFD
1S to refer to an explicit path using the PATH. argument block (by
including an [XWD O,addr] instruction as the PPN argument). If a
RENAME is given that attempts to move a file into or out of an SFD
without specifying an explicit path, it will take the skip return
(assuming no other errors), but the file will not change directories.
To delete a file after all read references have been made, your
program should specify the value of zero in the address of the file
name word in the RENAME block.
A delete function on a channel that is open for output, to supersede a
file, simply aborts the creation of the new file. This is equivalent
to a CLOSE with CL.RST set.
Although only a privileged job can delete a UFD, an unprivileged job
can delete an empty SFD. Note that you must set your path to a
different area before you can delete the current SFD. If the
directory is not empty or if a job is currently using the directory,
the monitor returns the DIRECTORY NOT EMPTY error code.
A CLOSE is optional after a RENAME because a RENAME implicitly
performs a CLOSE. A CLOSE should not be issued between a LOOKUP and a
RENAME if the file is not in the def~ult direc,tory path, because the
CLOSE erases all memory of the path. If RENAME is performed and the
file is not in the default path, the monitor returns the FILE NOT
FOUND error in the right half of addr+l.
22-349