MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 6 273
Command Definitions (FLUSHLOG-GETUSERMODE)
FRENAME
remote location of a device
If
formaldesig is the name of a user-defined file, it can begin with an
asterisk (*). If
formaldesig is the name of a system-defined file, it can
begin with a dollar sign ($). When creating a KSAM file,
formaldesig
must be a unique file name, that is, one not currently existing in the
permanent file directory.
The formal file designator can contain command interpreter variables and
expressions that are evaluated before
formaldesig is parsed and
validated.
The file referred to by
formaldesig may reside either in an MPE group or
in an HFS directory.
If renaming a file, a process must have the following:
TD Traverse directory entry to access to all directories
specified in
formaldesig .If formaldesig is specified as
file.group.account, the directories are the root
directory, the account, and the MPE group. If there is no
TD access, FRENAME fails and a call to FCHECK with
filenum set to 0 will return a system error code (398) in
the
fserrorcode parameter.
CD Create directory entry to access to the new parent
directory.
DD Delete directory entry to access to the old parent directory.
SF Save files capability.
The file referred to by
formaldesig may reside either in an MPE group or
in an HFS directory.
If a file is referenced by
filenum , you can rename it within the
hierarchical directory as long as the process invoking FRENAME has
sufficient access and the restrictions are satified. FRENAME intrinsic fully
qualifies the file owner name. Only file owners and users with appropriate
privilege can manipulate a file's lockword.
The home volume set of
formaldesig must be the same as the file being
renamed. Volume sets cannot be spanned when renaming files.
Operation Notes
The following restrictions apply toFRENAME:
• Directories cannot be renamed.
• Lockwords cannot be assigned to hierarchical directories.
• Files cannot be renamed across volume sets.
• Files with KSAM/3000, RIO, and CIR file types may only be assigned names in the
MPE name space.