ADDDSTLE (Add Distribution List Entry)

ADDDSTLE Command syntax diagram

 

Purpose

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

The ADDDSTLE command allows up to 300 entries to 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.

 

Required Parameters

LSTID

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

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

USRID

Specifies the user ID, address, and description of the users for whom additions to the distribution list are made. Both the user ID and address must be provided and must be separated by at least one space. If any lowercase characters are specified, the system changes and stores them as uppercase.

A list ID and address can be used in place of the user ID and address to identify a remote distribution list ID that is added to the distribution list. A remote distribution list must be defined as a remote user in the directory, or a default *ANY entry must exist.

*NONE: No user ID or list ID is specified. Members are added to this list using the FROMLSTID parameter. If the FROMLSTID parameter also specifies *NONE, an error message is returned.

Element 1: User ID

user-ID: Specify the user ID (or the valid list ID for a remote list entry) of the user for whom the entry is made.

Element 2: User Address

user-address: Specify the user address (or the valid list address for a remote list entry) of the user for whom the entry is made. Separate the ID and address by at least one space.

Element 3: User Description

*FIRST: The first description in the specified user ID and address (or list ID and address) is added. If only one entry exists, it is the one added to the list.

user-description: Specify the description for the user. If a list ID is specified, enter the list description. The description can be up to 50 characters in length. The description entered must be exactly the same as a directory entry or an error message is returned.

FROMLSTID

Specifies the name of an existing distribution list whose entries are added to this list. Up to 50 different list IDs can be specified. Duplicate entries are not removed. Duplicates are defined as entries that have the same user ID, address, and description.

*NONE: No list ID is specified. Members are added to this list using the USRID parameter. If *NONE is specified for the USRID, an error message is returned.

Element 1: From List ID

from-list-ID: Specify the list ID of a distribution list whose entries are added to this list.

Element 2: From List Qualifier

from-list-qualifier: Specify the list qualifier of a distribution list whose entries are added to this list.

CMDCHRID

Specifies the character identifier (graphic character set and code page) for data being specified as parameter values on this command. This character identifier (CHRID) is related to the display device used to specify the command. More information about CHRID processing is in the Application Display Programming

book.

*SYSVAL: The system determines the graphic character set and code page values for the command parameters from the QCHRID system values.

*DEVD: The system determines the graphic character set and code page values for the command parameter from the display device description where the command is entered. This option is valid only when specified from an interactive job. If this value is specified in an interactive CL program or a batch job, an error message is sent.

Element 1: Character Set

graphic-character-set: Specify the character set used to create the command parameters. Valid values range from 1 through 9999 characters.

Element 2: Code Page

code-page: Specify the code page. Valid values range from 1 through 9999.

Example for ADDDSTLE

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.

Additional Considerations

The list ID specified to have entries added to it must already exist in the directory. If the list does not exist, an error message is returned. The Create Distribution List (CRTDSTL) command is used to create a new distribution list.

Up to 300 sets of user IDs, addresses and user descriptions can be entered on this command. Each set of user ID and address is examined to determine whether it exists in the directory. If it is not in the directory, the directory is searched for an entry with user ID *ANY and an address that matches the address of the specified user. If this is found, the user ID and address is added to the distribution list. If it is not found, but a *ANY *ANY entry exists, the user ID is added to the list. Otherwise an error message is returned, stating that the user ID is not valid.

The command processes each set of user ID, address, and description. Each invalid set returns an error message, but the valid sets are added to the distribution list. At the end of processing of the command, a final message is returned indicating how many entries are in fact added to the distribution list, and how many entries are invalid.

The command allows input of up to 50 distribution list IDs whose members are added to the specified distribution list. If any list ID is not found in the directory, an error message is returned. Like the sets of user IDs, and addresses, any valid list IDs will have their members added to the distribution list, and a message is returned for each invalid list ID.

Error messages for ADDDSTLE

*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.