| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Rename Distribution List (RNMDSTL) command renames the list identifier (ID) of an existing distribution list.
A distribution list is a list of entries from the distribution directory. The distribution list can include entries for local, remote, indirect, and independent work station users. It can also include remote distribution lists, but it cannot include local distribution lists. More information about distribution lists is in the SNA Distribution Services book, SC41-5410.
When renaming the distribution list, the new list ID must be unique to all local user IDs and other list IDs in the directory. If a new list ID is not unique, the list is not renamed and an error message is returned.
Restriction: You must have security administrator (*SECADM) authority to rename a distribution list that you do not own. No special authority is needed for you to rename a distribution list that you own.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LSTID | List identifier | Element list | Required, Positional 1 |
| Element 1: List ID | Character value | ||
| Element 2: List ID qualifier | Character value | ||
| NEWLSTID | New list identifier | Element list | Required, Positional 2 |
| Element 1: List ID | Character value | ||
| Element 2: List ID qualifier | Character value |
| Top |
Specifies the two-part list identifier of the distribution list to be renamed.
The possible list identifier value is:
The possible list qualifier value is:
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.
This is a required parameter.
| Top |
Specifies the new two-part list identifier of the distribution list.
The possible list identifier value is:
The possible list qualifier value is:
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.
This is a required parameter.
| Top |
RNMDSTL LSTID(DEPTABC DLIST) NEWLSTID(DEPTXYZ DLIST)
This command renames a distribution list that contains the members of Department&rbl.ABC. The list ID is being changed to correspond to a new department name, XYZ. If the new list ID is unique, the distribution list is changed.
| Top |
*ESCAPE Messages
| Top |