DELMDISK Command

Reference Guide › Command Reference › DELMDISK Command

DELMDISK Command

Use the DELMDISK command to delete a minidisk defined within a USER, IDENTITY, or SUBCONFIG directory entry.

DELMdisk entry vaddr [("Options"]

Options:

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

Note: Options can be specified in any order.

Authorizations

You must have DELMDISK authorization through a GRANT DELMDISK record in the AUTHORIZ CONFIG file.

If you want to leave the contents of minidisks that have been deleted intact, then you must have NOFORMAT DELETE authorization through a GRANT NOFORMAT DELETE record in the AUTHORIZ CONFIG file.

Definitions

entry vaddr

Specifies the owner and virtual address of the minidisk to delete. The directory entry must not be in HOLD status.

[Format | NOFormat]

Formats (FORMAT) or does not format (NOFORMAT) the specified minidisk after deleting it. Formatted minidisks are formatted using a block size of 4K, and their labels are changed to ERASED. You must have NOFORMAT or NOFORMAT DELETE authorization to specify NOFORMAT. (If you include this DELMDISK command in a program, the user ID that submits the program for execution must have NOFORMAT DELETE authority.)

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

[FILE [ filename]]

[MSG | NOMSG]

[STACK [FIFO | LIFO]]

[FIFO]

[LIFO]

[Wait | NOWait]

These options are explained in the Common API Commands Options.

Description

The DELMDISK command deletes minidisks USER, IDENTITY, or SUBCONFIG directory entries. You can delete a user’s minidisks only under the following conditions:

User ID is not currently logged on
Minidisks you want to delete are not linked
No directory profile specifies a link to any of the minidisks you want to delete

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

Example

To delete the NICKT 193 minidisk without formatting it, enter:

vmdirect delmdisk nickt 193 (noformat

Return Codes and Error Messages

The table below lists return codes and error messages for the DELMDISK command.

Return Code	Message Number	Text
2	0127E	USER userid1 EXCEEDED USER userid2 type PASSWORD LIMIT
4	0038E	MISSING PARAMETER
6	0531E	PARAMETER userid IS TOO LONG
8	0265E	NOT AUTHORIZED FOR: DELMDISK userid
10	0349E	PASSWORD IS INCORRECT
12	0080E	USER userid DOES NOT EXIST
20	0382E	USER userid IS ON HOLD
22	0633E	ONE OR MORE ERRORS WERE DETECTED WHILE PROCESSING THE UPDATE OF USERID userid
23	0304E	ADDRESS vaddr IS AN INVALID DEVICE ADDRESS
25	0531E	PARAMETER vaddr IS TOO LONG
26	0313E	DEVICE vaddr DOES NOT EXIST
28	0634E	DIRECTORY PROFILE LINKS ALREADY EXIST FOR DEVICE vaddr
29	0311E	DEVICE vaddr IS NOT A MINIDISK
30	none	non‑zero return code from DIRECT_PRFLINKS
31	0561E	MINIDISK vaddr NOT DEFINED WITHIN svmid CONFIGURATION
32	0310E	DEVICE vaddr IS AN IGNORED DEVICE
41	0639E	YOU ARE NOT AUTHORIZED TO DELETE A CACHE’d DEVICE
46	0653E	INFORMATION ABOUT THE userid vaddr MINIDISK NOT AVAILABLE; RETURN CODE code FROM { QRYDISK \| ACCESS \| LINK }
48	0562E	MINIDISK vaddr NOT action, CURRENTLY IN USE
49	0339E	MINIDISK vaddr HAS BEEN PROCESSED BY THE CMS SAVEFD COMMAND
50	0573E	CANNOT LINK FOR FORMAT; VOLUME IS OFFLINE
68	0643E	EXTRA PARAMETER(S) parameters WERE ENTERED AND ARE NOT ALLOWED
70	0644E	’NOWAIT’ OPTION SPECIFIED BUT THE SERVANT FACILITY IS NOT ACTIVE
71	0648E	THE NOWAIT OPTION MAY NOT BE SPECIFIED WITH THE STACK OF FILE OPTIONS
72	0553E	YOU ARE NOT AUTHORIZED TO SKIP FORMATTING
76	0018E	INVALID OPTION option
78	0647E	THE { WAIT \| FORMAT } OPTION MAY NOT BE SPECIFIED FOR A MINIDISK ON T‑DISK
80	0364E	FILE filename filetype IS BEING UPDATED
89	0726E	SERVANT ABENDED DURING command COMMAND. DIRECTORY NOT CHANGED.
95	none	non‑zero return code from DIRECT UPDATE
96	none	non‑zero return code from MAN000S0
97	none	non‑zero return code from MAN000R0
98	0383I	FROM EXIT: text (SCRATCH USER EXIT)

Note:

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