RENAME
RENAME Use the RENAME command to change the fileid of one or eMS files on
a CMS disk. The format of the RENAME is: r- , I Rename , fileid1 fileid2 [(options ••• U ]] I I , I , I L r , ITYPE I r , I UPDIRT - I , L .J L .J
_______________ -.1 fileid1 is the file identifier of the original file whose name is to
be changed. All components of the fileid (filenamer
filetype, and filemode) must be coded, with either a name or
an asterisk. If an asterisk is coded in any field, any file
that satisfies the other qualifications is renamed.
fi leid2 TYPE T NOUPDIRT NOUP is the new file identifier of the file. All components of
the file (filename, filetype, and must be coded,
with either a name or an equal sign; if an equal sign (=) is
coded, the corresponding file identifiec is unchanged. The
output filemode can also be specified as an asterisk (*),
indicating that the filemode is not changed.
displaysr at the terminal, the new identifiers of all
the files that are renamed. The file identifiers are
displayed only when an asterisk (*l is specified for one
or more of the file identifiers (fn, ftr or fm) in
fileid 1.
suppresses at the terminal, displaying of the new file
identifiers of all files renamed.
updates the master file directory upon of this
command.
suppresses the updating of the
upon completion of this command.
master file directory (See Usage Note 3.)
1. When you code an asterisk (*) in any portion of the input fileid,
any oc all of the files that satisfy the other qualifiers may be cenamed, depending upon how you specify the fileid. For
example:
rename * assemble a test file a
results in the first ASSEMBLE file found on tne A-disk being
renamed to TEST FILE. If more than one ASSEMBLE file exists, error
messages are issued to indicate that they cannot be cenamed. 160 IBM VM/370 CMS Command and Macro Reference
2 3. RENAME If you code an equal sign (=) in an output fileid in
corresponding to an asterisk in an input fileid, all
satisfy the condition are renamed. For example:
a position
files that
rename * assemble a = oldasm =
renames all files
filetype of OLDASM. with a filetype of ASSEMBLE to
Current filenames are retained.
files with a You cannot use the
another. You must
filemode letters.
RENAME command to move a file from one disk to
use the COPYFILE com mana if you want to change You can use the RENAME command to modify filemode numbers, for
example,
rename * module al = = a2
changes the filemode number on all MODULE files that have a mode
number of 1 to a mode number of 2. You can invoke the RENAME command from the terminal, from an EXEC file, or as a function from a program. If is invoked as
a function or from an EXEC file that has the &CONTROL NOMSG option
in effect, the message DMSRNM002E FILE 'fn ft fm' NOT FOUND is not
issued.
Normally, the master file directory for
whenever you issue a command that affects you use the NOUPDIRT option of the RENAME directory is not updated until you issue
updates, or deletes any file on the disk,
a disk is updated
files on the disk. When command, the master file
a commana that writes,
or until you explicitly
release the disk (with the RELEASE command; newfn newft newfm
The new filename, filetype, and filemode of each file altered is
displayed when the TYPE option is specified and an asterisk was specified for at least one of the file identifiers (fn, ft or fm)
of the input fileid. DMSRNM002E FILE 'fn ft fm' NOT FOUND RC=28 DMSRNM003E INVALID OPTION 'option' RC=24 DMSRNM019E IDENTICAL FILEIDS RC=24 DMSRNM024E FILE 'fn ft fm' ALREADY EXISTS RC=28 DMSRNM030E FILE 'fn ft fm' ALREADY ACTIVE RC=28 DMSRNM037E DISK 'mode (cuu) , IS READ/ONLY RC=36 DMSRNM048E INVALID FILE MODE 'fm' RC=24 DMSRNM051E INVALID MODE CHANGE RC=24 DMSRNM054E INCOMPLETE FILEID SPECIFIED RC=24 DMSRNM062E INVALID * IN OUTPUT FILEID RC=20 , I Section 2. CMS Commands 161
Previous Page Next Page