Rename Nickname (RNMNCK)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Rename Nickname (RNMNCK) command is used to rename an existing nickname in the system distribution directory. The new nickname must be unique if it is a public nickname. The new nickname must be unique only for the owner if it is a private nickname.
A nickname is a short version of either a directory entry or a distribution list name. More information about nicknames is in the SNA Distribution Services book, SC41-5410.
Restrictions:
- You must have security administrator (*SECADM) authority to rename a public nickname that you do not own. No special authority is needed for you to rename a public nickname that you own.
- Only the owner can rename a private nickname. No special authority is needed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| NCK | Nickname | Element list | Required, Positional 1 |
| Element 1: Nickname | Character value | ||
| Element 2: Access | *PRIVATE, *PUBLIC | ||
| NEWNCK | New nickname | Character value | Required, Positional 2 |
| Top |
Nickname (NCK)
Specifies the existing nickname to be renamed and the access of that nickname.
The possible nickname value is:
- nickname
- Specify the nickname you are renaming.
The possible nickname access values are:
- *PRIVATE
- The private nickname that you own is being renamed.
- *PUBLIC
- The public nickname is being renamed. Public nicknames can be renamed only by a user with security administrator (*SECADM) authority or by the owner.
This is a required parameter.
| Top |
| Top |
Examples
RNMNCK NCK(SEC44A *PUBLIC) NEWNCK(SEC44C)
This command renames the public nickname SEC44A to SEC44C. If the new nickname is unique, the nickname is renamed.
| Top |
Error messages
*ESCAPE Messages
- CPF8AA1
- Library QUSRSYS not completely installed.
- CPF8360
- Not enough storage for commitment control operation.
- CPF9A80
- Public nickname &1 in use.
- CPF9A80
- Public nickname &1 in use.
- CPF9024
- System cannot get correct record to finish operation.
- CPF905C
- Error occurred trying to find a translation table.
- CPF9838
- User profile storage limit exceeded.
| Top |