Rename Member (RNMM)

Where allowed to run: All environments (*ALL) Threadsafe: Conditional

Parameters Examples Error messages

The Rename Member (RNMM) command changes the name of a specified file member. The member cannot be renamed while it is in use; other users can read and change records of other members in the file that contains the member being renamed. A member that is opened in the same job cannot be renamed.

Restrictions:

• You must have object management (*OBJMGT) authority for the file that contains the member that is to be renamed, and have update (*UPDATE) and execute (*EXECUTE) authorities for the library in which the file is located.

• This command is conditionally threadsafe. In multithreaded jobs, this command is not threadsafe and fails for Distributed Data Management (DDM) files of type *SNA.

Top

---

 

Parameters

Keyword	Description	Choices	Notes
FILE	Data base file	Qualified object name	Required, Positional 1
	Qualifier 1: Data base file	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
MBR	Member	Name	Required, Positional 2
NEWMBR	New member	Name	Required, Positional 3

Top

 

Data base file (FILE)

Specifies the database file (physical or logical) that contains the member to be renamed.

This is a required parameter.

Qualifier 1: Data base file

name

Specify the name of the database file.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the file. If no library is specified as the current library, QGPL is used.

name

Specify the name of the library to be searched.

Top

 

Member (MBR)

Specifies the physical or logical file member that is to be renamed.

This is a required parameter.

name

Specify the name of the file member.

Top

 

New member (NEWMBR)

Specifies the new name to be given to the file member. The member remains in the same file. The new name must not be the same as the name specified on the Member (MBR) parameter. The new name must be unique in the file.

This is a required parameter.

name

Specify the new name of the file member.

Top

---

 

Examples

 RNMM   FILE(ELEMENT)  MBR(LEAD)  NEWMBR(GOLD)

This command renames member LEAD in file ELEMENT as GOLD. The library list (*LIBL) is used to find the file.

Top

---

 

Error messages

*ESCAPE Messages

CPF3178

Member &3 not renamed to &4.

Top