Add Distribution List Entry (ADDDSTLE)

The Add Distribution List Entry (ADDDSTLE) command allows you to add new entries to an existing distribution list. A distribution list can include local, remote, indirect, and programmable work station users. It can also include remote distribution lists, but not local distribution lists.

Up to 300 entries can be added to a distribution list at one time. In addition, up to 50 local distribution list IDs can be specified whose members are all to become part of this list.

The distribution list must exist before this command can be run. The Create Distribution List (CRTDSTL) command can be used to create a new distribution list.

Restriction: The user of this command must have security administrator authority to add entries to a distribution list owned by someone else. Users can add entries to a distribution list they have created without restrictions.

Parameters

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
USRID User identifier Single values: *NONE
Other values (up to 300 repetitions): Element list		 Optional
Element 1: User ID Character value
Element 2: Address Character value
Element 3: User description Character value, *FIRST
FROMLSTID From list identifier Single values: *NONE
Other values (up to 50 repetitions): Element list		 Optional
Element 1: List ID Character value
Element 2: List ID qualifier Character value
CMDCHRID Command character identifier Single values: *SYSVAL, *DEVD
Other values: Element list		 Optional
Element 1: Graphic character set Integer
Element 2: Code page Integer

List identifier (LSTID)

Specifies the two-part list identifier of the distribution list that is to have entries added.

This is a required parameter.

list-identification
Specify the list ID in two parts.

More information about specifying the list ID is in SNA Distribution Services book, SC41-5410.

If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.

User identifier (USRID)

Specifies the user ID, address, and description of the user that is to be added to the distribution list. Both the user ID and address must be provided. A list ID (both parts) is used in place of the user ID and address to identify a remote distribution list ID being added to the distribution list. A remote distribution list can be added to a local directory as a remote user, or can be valid because of a default *ANY entry. The description can be specified and it must exactly match the entry as it is known in the directory. If no description is specified, *FIRST is the default.

Up to 300 sets of user IDs, addresses, and descriptions can be specified. Each valid set is added to the distribution list.

*NONE
No user ID is specified. If *NONE is specified, a value other than *NONE must be specified on the From list identifier (FROMLSTID) parameter.
user-id and address
Specify both the user ID and address.

If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.

A remote list ID can also be typed in this field.

*FIRST
The first description in the specified user ID and address is added. If only one entry exists, it is the one added to the list.
user-description
Specify a maximum of 50 characters for the description of the user. If a list ID is specified, enter the list description. You must enter the description exactly as it appears in the directory entry or an error message is returned.

From list identifier (FROMLSTID)

Specifies the name of an existing distribution list whose entries are added to this list. A maximum of 50 list IDs can be specified. Duplicate entries are not removed.

*NONE
No list ID is specified.
from-list-identification
Specify the two-part list ID of a distribution list whose entries are added to this list.

Command character identifier (CMDCHRID)

Specifies the character identifier (graphic character set and code page) for the data entered as command parameter values. The value you specify on this parameter applies to the List identifier (LSTID) parameter, the User identifier (USRID) parameter, and the From list identifier (FROMLSTID) parameter.

Note:

Single values

*SYSVAL
The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
*DEVD
The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.

Element 1: Graphic character set

1-32767
Specify the graphic character set to use.

Element 2: Code page

1-32767
Specify the code page to use.

Examples 

ADDDSTLE   LSTID(CHICAGO DLIST)
           USRID((HURST NEWYORK 'Manager of Payroll')
                 (LEE DEPT554 *FIRST)
                 (BOCA DLIST 'Remote Distribution list for Boca')
                 (ERIC WAREHSE))
           FROMLSTID((DEPT48K DLIST) (ALLMGRS DLIST))

This command specifies that four user IDs are added to the distribution list CHICAGO DLIST. The third user ID is in fact a remote distribution list. The fourth user ID (ERIC WAREHSE) defaults to the first description for that user ID. In addition, all of the entries in two distribution lists are added to this distribution list.

Error messages

*ESCAPE Messages

CPF9024
System cannot get correct record to finish operation.
CPF905C
Error occurred trying to find a translation table.
CPF9090
No entries added to distribution list &1 &2.
CPF9091
&1 entries added and &2 lists copied to list &3 &4. &5 entries not added and &6 lists not copied.
CPF9096
Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
CPF9838
User profile storage limit exceeded.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.