WRKDSTL (Work with Distribution Lists)

WRKDSTL Command syntax diagram

 

Purpose

The Work with Distribution Lists (WRKDSTL) command allows you to view, create, add entries to, remove entries from, and delete distribution lists. A distribution list is a list of directory entries used to simplify the sending of distributions to a group of users. When the WRKDSTL command is entered, the system shows one, some, or all of the distribution lists in the system directory, depending on the value specified on the LSTID parameter. If *ALL is specified on the LSTID parameter, all distribution lists are shown. If a specific list ID is specified on the LSTID parameter, a specific distribution list is shown.

Restriction: You must have security administrator (*SECADM) authority to change, delete, or rename distribution lists that you do not own. No special authority is needed to display distribution lists or to work with distribution lists that you own.

 

Optional Parameters

LSTID
Specifies which distribution lists to be shown. If a list ID not currently contained in the distribution directory is specified on the LSTID parameter, an error message is returned.

*ALL: All distribution lists in the system distribution directory are shown in alphabetical order by list ID.

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 Link to PDF book.


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.

Examples for WRKDSTL

Example 1: Showing a Distribution List 

WRKDSTL  LSTID(WILL DISTLIST)

This command shows the Work with Distribution Lists display with one entry, WILL DISTLIST. This example assumes that WILL DISTLIST exists.

Example 2: Showing All Distribution Lists 

WRKDSTL

This command shows the Work with Distribution Lists display with a list of all distribution lists in the distribution directory.

Error messages for WRKDSTL

*ESCAPE Messages

CPF9A83
Public nickname &1 not found.
CPF9A85
Nickname &1 not found.
CPF9024
System cannot get correct record to finish operation.
CPF905C
Error occurred trying to find a translation table.
CPF9052
List ID, &1 &2, cannot be found.
CPF9838
User profile storage limit exceeded.