DLTDSTL (Delete Distribution List)

DLTDSTL Command syntax diagram

 

Purpose

The Delete Distribution List (DLTDSTL) command deletes an existing distribution list from the system distribution directory. Up to 300 lists can be deleted at a time.

Restriction: You must have security administrator (*SECADM) authority to delete a distribution list that you do not own. No special authority is needed to delete a distribution list that you own.

 

Required Parameters

LSTID

Specifies the two-part list identifier of the distribution list being deleted. Up to 300 list IDs (both parts) can be specified.

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.

 

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 parameter. 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 DLTDSTL

DLTDSTL   LSTID((DEPT48K DLIST)  (ISMGRS DSTLIST))

This command deletes the two distribution lists, DEPT48K DLIST and ISMGRS DSTLIST, if they exist.

Additional Considerations

If a specified distribution list identifier does not exist in the directory, an error message is returned. If several list identifiers are given, each is processed individually. An error message is returned each time a list identifier is found not to exist or if the current user of this command does not have the authority to delete the list.

Error messages for DLTDSTL

*ESCAPE Messages

CPF9024

System cannot get correct record to finish operation.

CPF905C

Error occurred trying to find a translation table.

CPF9094

&1 distribution lists deleted. &2 lists not deleted.

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.