RMVDIRE (Remove Directory Entry)

RMVDIRE Command syntax diagram

 

Purpose

The Remove Directory Entry (RMVDIRE) command removes a specific entry from the system distribution directory. When a user ID and address is removed from the directory, it is also removed from all distribution lists and the list of nicknames for that user. However, the user ID and address for that user is not removed in the list of nicknames for other users.

If an *ANY user is removed and an *ANY *ANY directory entry exists, the user is not removed from the distribution lists but the description is changed to the *ANY *ANY description.

If a user ID and address has multiple descriptions associated with it, options exist to remove only a specific description or all descriptions.

The RMVDIRE command does not provide interactive display support. This is provided by the Work with Directory Entries (WRKDIRE) command.

If the specified user ID, address, and description do not exist in the directory, an error message is returned.

 

Restrictions

  1. The person running this command must have security administrator (*SECADM) authority.

  2. The user ID and address being removed must not:

    • Be enrolled in OfficeVision

    • Have ownership of documents or folders in the Document Interchange Architecture (DIA) library

    If either of the above conditions are not met, the user ID and address is not removed from the directory.

  3. If the user ID and address being removed has not received mail from the mail queue, the following can happen:

    • If the request is entered interactively, a status message is sent asking whether the queue should be cleared. If the user responds yes, the mail is cleared from the queue and the user is removed from the directory. If the user responds no, the user ID and address is not removed from the directory.

    • If the request is not entered interactively (for example, the request is from a batch CL program), the user ID and address is not removed from the directory.

 

Required Parameters

USRID
Specifies the user ID and address for the user entry to be removed.

Element 1: User ID

user-ID: Specify the user ID that is removed. Up to 8 characters can be specified.

Element 2: User Address

user-address: Specify the user address to be removed. Up to 8 characters can be specified.

 

Optional Parameters

USRD
Specifies the description associated with the user ID and address. Since more than one entry can exist in the directory for a specific user ID and address, the description fully defines the user entry being removed.

*FIRST: The first entry in the directory for the specified user ID and address is removed. If only one entry exists, it is removed.

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

user-description: Specify up to 50 characters for the description for the user. This description must be the same as the one in the directory for this user ID and address.

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

Element 2: Code Page

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

Example for RMVDIRE 

RMVDIRE   USRID(HURST NEWYORK)
  USRD('Manager of Payroll')

User ID and address HURST NEWYORK is removed if the following is true:

In addition, the user is removed from all distribution lists.

Error messages for RMVDIRE

*ESCAPE Messages

CPF89A3
Operation not successful due to authority reasons.
CPF90A8
Operation not successful due to data validation reasons.
CPF90A8
*SECADM special authority required to do requested operation.
CPF9005
System resource required to complete this request not available.
CPF9009
System requires file &1 in &2 be journaled.
CPF9024
System cannot get correct record to finish operation.
CPF905C
Error occurred trying to find a translation table.
CPF9087
Directory entry not removed.
CPF9096
Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
CPF9810
Library &1 not found.
CPF9838
User profile storage limit exceeded.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.