ADDNCK (Add Nickname)

ADDNCK Command syntax diagram

 

Purpose

The Add Nickname (ADDNCK) command is used to add a nickname to the system distribution directory. The nickname must be unique if it is a public nickname. The 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. You can specify a nickname instead of the full directory entry or distribution list name on many OfficeVision displays. More information about nicknames is in the SNA Distribution Services

 

Required Parameters

NCK

Specifies the nickname to be added and the ability of users to access the nickname.

Element 1: Nickname

nickname: Specify the nickname you are adding.

Element 2: Nickname Access

*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 a user with security administrator (*SECADM) authority or by the owner.

USRID

Specifies the two-part user identifier for which a user nickname is being added. Both the user ID and address elements must be specified. More information about specifying the user ID and address is in the SNA Distribution Services

Note:

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

Element 1: User ID

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

Element 2: User Address

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

LSTID

Specifies the two-part list identifier of the distribution list for which a list nickname is being added. Both the list identifier and qualifier elements must be specified.

Note:

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

Element 1: List Identifier

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

Element 2: List Qualifier

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

 

Optional Parameters

TEXT

Specifies the description of the nickname.

Note:

If a user nickname is specified when sending a note using the OfficeVision program, the text for the TO or COPYLIST fields is filled with the nickname text rather than the directory entry description.

*DFT: The default description is used for the text. The default description is the first description associated with the specified USERID or LISTID parameter.

'nickname-description': Specify a description to further identify the nickname. A maximum of 50 characters can be specified and must be enclosed in apostrophes.

Example for ADDNCK

ADDNCK   NCK(SEC44A *PUBLIC)  USRID(XZWS44A RCHAS1)
  TEXT('Secretary for Department 44A')

This command adds a public user nickname which is a short version of the User ID and Address XZWS44A RCHAS1. If this nickname is unique it is added to the directory.

Error messages for ADDNCK

*ESCAPE Messages

CPF8360

Not enough storage for commitment control operation.

CPF8AA1

Library QUSRSYS not completely installed.

CPF905C

Error occurred trying to find a translation table.

CPF9838

User profile storage limit exceeded.

CPF9A89

Nickname function not successful.