CRTDSTL (Create Distribution List)

CRTDSTL Command syntax diagram

 

Purpose

The Create Distribution List (CRTDSTL) command creates a new distribution list. A distribution list is a list of entries from the distribution directory. It can include entries for local, remote, indirect, and independent work station users. It can also include remote distribution lists, but not local distribution lists. More information about distribution lists is in the SNA Distribution Services

book.

The CRTDSTL command creates the distribution list with no entries. The Add Distribution List Entry (ADDDSTLE) command is used to add entries to the distribution list.

Restriction: The list identifier (ID) must be unique to all local user IDs, as well as to other list IDs in the directory. If a list ID is not unique, the list is not created and an error message is returned.

 

Required Parameters

LSTID

Specifies the two-part list identifier of the distribution list that is being created.

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

LSTD

Specifies the description of the distribution list. The description further identifies the distribution list.

 

Optional Parameters

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 graphic character set values used to create the command parameters. Valid values range from 1 through 9999.

Element 2: Code Page

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

Example for CRTDSTL

CRTDSTL   LSTID(DEPT48K DLIST)
  LSTD('Department 48K Distribution List')

This command creates a distribution list that contains the members of Department 48K. If this list ID is unique, the distribution list is created.

Error messages for CRTDSTL

*ESCAPE Messages

CPF9009

System requires file &1 in &2 be journaled.

CPF905C

Error occurred trying to find a translation table.

CPF9088

List &1 &2 not created in the directory.

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.