MPE/iX Intrinsics Reference Manual (32650-90875)

272 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FRENAME
FRENAME
NM and CM callable.
Renames an open disk file (and its lockword, if applicable). The file being renamed must be
either:
• A new file.
• An old file (permanent or temporary), opened for exclusive access with the
exclusive
option of the HPFOPEN/FOPEN intrinsics, and with security provisions allowing write
access.
Syntax
I16V CA
FRENAME(
filenum,formaldesig );
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file to be renamed.
formaldesig character array (required)
Passes a formal file designator interpreted according to MPE-escaped
semantics. The file name must be terminated by a nonalphanumeric
character other than a period (.), a slash (/), a hyphen (-), and an
underscore (_).
The file referred to by formaldesig can be either an MPE file (i.e., one
that uses MPE syntax) or it can follow HFS syntax. If
formaldesig follows
MPE syntax, the file name can include password, group, and account in
the following format:
filename/lockword.group.account
To keep or add a lockword to the file, enter it in the ASCII string. If you do
not specify a group, the file will remain in the same group it was assigned
before you invoked FRENAME. If you are renaming a new or temporary file,
specify any account that shares the same volume set as the file referred to
by
formaldesig .
If
formaldesig follows HFS syntax, the file name must start with either a
dot (.) or a slash (/).
If
formaldesig is an escaped pathname:
• you cannot reference remote files
• it cannot express a name equivalent to
filename : envid
• you cannot use the device parameter ( device = node #) to specify the