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 |
| Top |