RMVDSTLE (Remove Distribution List Entry)

RMVDSTLE Command syntax diagram

 

Purpose

The Remove Distribution List Entry (RMVDSTLE) command removes entries from an existing distribution list. Up to 300 entries can be removed from a list at one time.

Restriction: The user must have security administrator authority (*SECADM) to remove entries from a distribution list owned by another user. Users can remove entries from distribution lists that they created.

 

Required Parameters

LSTID

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

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.

USRID

Specifies the user ID, address, and description of the users for whom distribution list entries are removed. 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 translates and stores them as uppercase. The description can be entered to specify the removal of a specific user ID.

A list ID and address can be used in place of the user ID and address to identify a remote distribution list that is removed from the distribution list.

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

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

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

Element 3: User Description

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

*ALL: All the entries with the specified user ID and address are removed from the distribution list.

user-description: Specify the description for the user. If a list ID is specified, specify the list description. The description can be up to 50 characters in length.

 

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 RMVDSTLE

RMVDSTLE LSTID(CHICAGO DLIST)
  USRID((HURST PAYROLL 'Manager of Payroll')
  (LEE DEPT554 *FIRST)
  (BOCA DLIST 'Remote Distribution list for Boca')
  (BRYON WAREHSE *ALL))

In this example, four user IDs are removed from the distribution list CHICAGO DLIST. The third user ID is, in fact, a remote distribution list. All entries for BRYON WAREHSE are removed from the list.

Additional Considerations

To remove entries from a list ID, the list ID must exist in the directory. If the list does not exist, an error message is returned.

Up to 300 sets of user IDs, addresses and user descriptions can be entered on this command. Each set of user IDs and addresses is examined to determine whether it exists in the directory. If no such entry exists, an error message is returned. If an entry is found, it is removed from the list.

Error messages for RMVDSTLE

*ESCAPE Messages

CPF9024

System cannot get correct record to finish operation.

CPF905C

Error occurred trying to find a translation table.

CPF9092

No entries removed from list &1 &2.

CPF9093

&1 entries removed from list &2 &3.

CPF9096

Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.

CPF9838

User profile storage limit exceeded.

CPF9845

Error occurred while opening file &1.