DELENTRY Command

Reference Guide › Command Reference › DELENTRY Command

DELENTRY Command

Use the DELENTRY command to delete a USER, IDENTITY, SUBCONFIG, or PROFILE directory.

DELEntry entry [("Options"]

Options:

[FILE [filename]]
[Format | NOFormat]
[HOLD]
[MSG | NOMSG]
[STACK [FIFO | LIFO]]
[FIFO]
[LIFO]
[Wait | NOWait]

Note: Options can be entered in any order.

To delete a directory profile:

DELEntry entry (PROFILE "Options"

Options:

[FILE [filename]]
[MSG | NOMSG]
[STACK [FIFO | LIFO]]
[FIFO]
[LIFO]

Note: Options can be entered in any order.

Authorizations

If a user ID has minidisks to be deleted, you must have DELMDISK authorization through a GRANT DELMDISK record in the AUTHORIZ CONFIG file.

If you want to leave minidisks that have been deleted from a directory entry unformatted, you must have NOFORMAT DELETE authorization through a GRANT NOFORMAT DELETE record in the AUTHORIZ CONFIG file.

Definitions

entry

Specifies the name of the directory entry to delete.

entry (PROFile

Specifies the name of the directory profile to delete.

[Format | NOFormat]

Formats (FORMAT) or does not format (NOFORMAT) the minidisks defined in the directory entry before deleting them. You must have the appropriate NOFORMAT authorization to specify NOFORMAT. (If you include this DELENTRY command in a program, the user ID that submits the program for execution must have the appropriate NOFORMAT authority.)

Formatted minidisks are formatted using a block size of 4K, and their labels are changed to ERASED.

CA VM:Director ignores this option for minidisks defined on T‑DISK or V‑DISK.

[HOLD]

Indicates that the specified directory entry is currently on hold. This option is required if you want to delete a directory entry on hold.

[FILE [filename]]

[MSG | NOMSG]

[STACK [FIFO | LIFO]]

[LIFO]

[FIFO]

[Wait | NOWait]

These options are explained in the Common API Options.

Description

The DELENTRY command lets you delete the directory entry for a USER, IDENTITY, SUBCONFIG, or PROFILE regardless of whether it is active or on hold. When it deletes the directory entry for a user ID, it also deletes the:

User ID minidisks using the DELMDISK command
User ID from all file pools in which it was enrolled
User ID from the VMDIRECT MANAGERS file

(CA VM:Secure only) If your site uses the Rules Facility, deletes the USRRULES file for the user ID and any references to the user ID in any other rules file

Note: When you use the DELENTRY command and delete a minidisk that is on a pack that is under CA VM:Director control, CA VM:Director also deletes all links to that deleted minidisk from the directory.

You can delete an active user's directory entry only under the following conditions:

User ID is not currently logged on
None of the user ID minidisks is linked
No directory profile specifies a link to any of its minidisks
All file pools in which the user is enrolled are active

You can delete a directory profile only if no directory entry refers to it with an INCLUDE statement. Use the QUERY PRFUSERS command to list all users of a directory profile.

When you delete a SUBCONFIG directory entry, the associated BUILD statement in the related IDENTITY directory entry is removed.

When you delete an IDENTITY directory entry, any related SUBCONFIG directory entry is also deleted.

Example

To delete user ID NICKT, which is on hold, format NICKT’s deleted minidisks, and send messages generated by the deletion to the default CMS file (DELENTRY RESULTS A), enter:

vmdirect delentry nickt (hold format file

Return Codes and Error Messages

The table below lists immediate termination return codes and error messages for the DELENTRY command.

Return Code	Message Number	Text
2	0018E	INVALID OPTION option
4	0644E	‘NOWAIT’ OPTION SPECIFIED BUT THE SERVANT FACILITY IS NOT ACTIVE
6	0648E	THE NOWAIT OPTION MAY NOT BE SPECIFIED WITH THE STACK OR FILE OPTIONS
8	0553E	YOU ARE NOT AUTHORIZED TO SKIP FORMATTING
10	0698E	THE PROFILE OPTION MAY NOT BE SPECIFIED WITH THE HOLD OPTION
12	0038E	MISSING PARAMETER
14	0531E	PARAMETER userid IS TOO LONG
15	0328E	INVALID USERID userid
16	0265E	NOT AUTHORIZED FOR: DELENTRY userid
17	7068E	YOU ARE NOT AUTHORIZED TO WORK WITH userid
18	0127E	USER userid1 EXCEEDED USER userid2 CA VM:Director LOGON PASSWORD LIMIT {FOR vaddr}
20	0349E	PASSWORD IS INCORRECT
22	0080E	USER userid DOES NOT EXIST
24	0435E	USER userid IS NOT ON HOLD
25	0270W	PROFILE entryname DOES NOT EXIST
26	0382E	USER userid IS ON HOLD
28	0643E	EXTRA PARAMETER(S) parameters WERE ENTERED AND ARE NOT ALLOWED
29	0254E	PROFILE profname IS USED BY number USERS AND MAY NOT BE REMOVED
30	0383I	FROM EXIT: SCRATCH userexit
32	0357E	USER userid IS CURRENTLY LOGGED ON
34	0621E	UNEXPECTED RETURN CODE code FROM OPEN
36	0506E	userid NOT ALTERED. REFERENCED IN PROFILES: profname1 profname2 ...
38	0710E	MANAGER mgrid STILL HAS USERIDS DEFINED ON THE { DRCT \| HOLD DISK }
40	0711E	FILE filename filetype filemode CANNOT BE UPDATED BECAUSE IT IS LOCKED BY ANOTHER USER
42	0712E	AN ERROR OCCURRED WHILE ATTEMPTING TO PROCESS THE filename filetype FILE
44	0730E	USER userid NOT REMOVED, MINIDISK mdisk IS CURRENTLY IN USE
46	0653E	INFORMATION ABOUT THE userid vaddr MINIDISK NOT AVAILABLE; RETURN CODE code FROM { QRYDISK \| ACCESS \| LINK }
50	0573E	CANNOT LINK FOR action; VOLUME volser IS OFFLINE
7223	7223E	ERROR code FROM command

Note:

For explanations of the message routing and disconnect options, see Common API Command Options.
For information about how to check on links to a minidisk if you cannot delete a minidisk because it is linked, see DISPLINK Command.
For an explanation of the QUERY PRFUSERS command, see QUERY Command.
For NOFORMAT authorizations, see Authorizations for Command Processing table in the chapter "Authorizations" of the Administration Guide.
Message Reference Guide for complete descriptions of all messages listed in this section.