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:

  1. 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.
  2. 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

New nickname (NEWNCK)

Specifies the new nickname.

This is a required parameter.

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