Change Nickname (CHGNCK)

The Change Nickname (CHGNCK) command is used to change an existing nickname in the system distribution directory.

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 or *ALLOBJ) authority to change a public nickname that you do not own. No special authority is needed for you to change a public or private nickname that you own.
Only the owner can change a private nickname. No special authority is needed. However, to change the ownership of a nickname that you own, you must have at least change (*CHANGE) authority to the user profile of the user to be named as the new owner.

Keyword	Description	Choices	Notes
NCK	Nickname	Element list	Required, Key, Positional 1
Element 1: Nickname	Character value
Element 2: Access	PRIVATE, PUBLIC
OWNER	Owner	Name, *SAME	Optional
NEWACCESS	New access	PRIVATE, PUBLIC, *SAME	Optional
TEXT	Nickname description	Character value, *SAME	Optional
USRID	User identifier	Element list	Optional
Element 1: User ID	Character value, *SAME
Element 2: Address	Character value
LSTID	List identifier	Element list	Optional
Element 1: List ID	Character value, *SAME
Element 2: List ID qualifier	Character value

Nickname (NCK)

Specifies the existing nickname that is being changed and the access of the nickname.

The possible nickname value is:

nickname: Specify the nickname you are changing.

The possible nickname access values are:

*PRIVATE: The private nickname is to be changed. Private nicknames can be changed only by the owner.
*PUBLIC: The public nickname is to be changed. Public nicknames can be changed only by a user with security administrator (*SECADM) authority or by the owner.

This is a required parameter.

Owner (OWNER)

Specifies the user profile name of the user who is to own the nickname. The user profile named must exist on the system.

*SAME: The value does not change.
user-profile-name: Specify the user profile name of the user to whom the nickname is being assigned.

New access (NEWACCESS)

Specifies the new access of the nickname.

*SAME: The value does not change. The value is the value on the ACCESS parameter.
*PRIVATE: The nickname cannot be shared with other users. It can be accessed and changed only by the owner.
*PUBLIC: The nickname can be shared with other users. It can be accessed by any user on the local system, but it can be changed only by the owner or a user with security administrator (*SECADM) authority.

Nickname description (TEXT)

Specifies the new description of the nickname.

*SAME: The value does not change.
'nickname-description': Specify the description that further identifies the nickname. A maximum of 50 characters can be specified and must be enclosed in apostrophes.

User identifier (USRID)

Specifies the new identifier of the user for whom the user nickname is being changed. More information about specifying the user ID and address is in the SNA Distribution Services book, SC41-5410.

Note: This parameter cannot be specified when the LSTID parameter is specified.

Both the user ID and address elements must be specified unless *SAME is specified.

The possible value is:

*SAME: The value does not change.

The possible User ID value is:

user-ID: Specify the user ID for this nickname. A maximum of 8 characters can be specified.

The possible user address value is:

user-address: Specify the address for this nickname. A maximum of 8 characters can be specified.

List identifier (LSTID)

Specifies the new list identifier of the distribution list for the list nickname being changed.

Note: This parameter cannot be specified when the USRID parameter is specified.

Both the list identifier and qualifier elements must be specified unless *SAME is specified.

*SAME: The value does not change.

The possible list identifier value is:

list-ID: Specify the list identifier (ID) of the distribution list.

The possible list qualifier value is:

list-ID-qualifier

Specify the list ID qualifier of the distribution list.

Note: The distribution list identifier has two parts, the ID and the qualifier, separated by at least one space. If lowercase characters are specified, the system changes them to uppercase.

The naming rules for the two-part list ID are identical to the rules for the user ID and address. A complete description of these rules is in the SNA Distribution Services book, SC41-5410.

Examples

CHGNCK   NCK(SEC44A *PRIVATE)  NEWACCESS(*PUBLIC)
         TEXT('Secretary for Area 44A')  USRID(XZWS44A RCHVMP2)

This command changes the access, nickname description, and user ID of the nickname SEC44A. If the nickname is a user nickname and the user has proper authority to the nickname, the nickname is changed.

Error messages

*ESCAPE Messages

CPF8360: Not enough storage for commitment control operation.
CPF8AA1: Library QUSRSYS not completely installed.
CPF9A80: Public nickname &1 in use.
CPF9A89: Nickname function not successful.
CPF9024: System cannot get correct record to finish operation.
CPF905C: Error occurred trying to find a translation table.
CPF9838: User profile storage limit exceeded.