Remove a record from the user profile database, VMSMAIL_PROFILE.DATA.

restrictions

Requires SYSPRV privilege.

Syntax

REMOVE [username]

Qualifiers	Defaults
/LOG	/NOLOG
/UIC="[g,m]"	None

Parameters

username

Optional parameter specifying the username associated with the record to remove. The parameter value may contain wild cards in which case any record with a username matching the parameter value will be removed.

Description

The REMOVE command removes one or more user entries from the profile database, VMSMAIL_PROFILE.DATA. At sites with high user turnover (e.g., schools), the profile database can over the course of a few years become populated with records corresponding to non-existent users. The /UIC qualifier can come in especially useful in cases where entire classes of deleted accounts have the same UIC group number.

If the username parameter contains a wild card, then the entire profile database will be scanned looking for entries which match the specified username. Any record which matches is then removed. If a UIC specification is given (with or without wild cards), then the entire profile database is scanned and the UIC obtained for each username entry. Any entries with a matching UIC are removed. Both username and UIC specifications may simultaneously be specified.

Qualifiers

/LOG

/NOLOG (default)

When /LOG is specified, a message will be output for each record removed.

/UIC="[g,m]"

When the /UIC qualifier is used, the entire profile database is scanned looking for usernames which correspond to the specified UIC. An asterisk wild card, *, may be specified for either or both of the group (g) or member (m) numbers. /UIC="[*,*]" is equivalent to /USER=*. Be sure to enclose the UIC specification in quotes; e.g., "[111,3]".

Examples

EMAIL> REMOVE CATS-LIST
      

In this example, the profile entry for CATS-LIST is removed. Note that when you use the SET FORWARD command to establish forwarding of non-existent usernames (e.g., CATS-LIST), an entry in the profile database is made for that non-existent username.

EMAIL> REMOVE/LOG/UIC=[1123,*]
%EMAIL-S-REMRECORD, AASH record removed
%EMAIL-S-REMRECORD, BSMITH record removed
   .
   .
   .
%EMAIL-S-REMRECORD, ZSMITH record removed
%EMAIL-I-REMRECORDS, 113 records removed
EMAIL>
      

In this example, all profile entries for users in the [1123,*] UIC group are removed. Note that not all users may have an entry in the profile database. A user will only have an entry if she or he has issued a SET command from within VMS MAIL, DECwindows MAIL, or PMDF MAIL.