DELETE Command

Reference Guide › Command Reference › DELETE Command

DELETE Command

Use the DELETE command to delete an SFS file space owned by a user ID.

DELETE userid [filepool | ALL | *] [("Options"]

Options:

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

Note: Options can be entered in any order.

Authorizations

You must be the SFS manager for the user ID and you must be authorized to allocate space in the affected file pools, or you must be an SFS administrator.

Definitions

userid

Specifies the user ID whose file space you want CA VM:Secure to delete. The user ID must be active.

[filepool | ALL]

The name of an existing file pool from which to delete the user's file space, or ALL to delete the user's file space for all file pools that CA VM:Secure manages.

The specified file pool must be one that CA VM:Secure manages and in which CA VM:Secure knows the user ID owns file space. ALL deletes the user's file space from all file pools managed by CA VM:Secure that the user is known to be enrolled in.

[FILE [filename]]

[MSG | NOMSG]

[STACK [FIFO | LIFO]

[FIFO]

[LIFO]

These options are explained in the Common API Command Options.

Description

The DELETE command deletes an active user ID file space from one or all file pools that CA VM:Secure manages. If you want to delete file space that belongs to a user ID on hold, you must reactivate it first.

Note: CA VM:Secure runs the DELETE command on a servant machine. Before issuing the DELETE command, be sure the Servant Facility is enabled; if the Servant Facility is disabled, the DELETE command fails. For more information about using the Servant Facility, see the Administration Guide.

Deleting a user's file space deletes all data that user ID has in the specified file pool (or in all file pools that CA VM:Secure manages if you specify ALL). Verify, before you delete a user’s file space, that the user does not need the file space or any data currently stored in that file pool.

The file pool you specify on the DELETE command must be active and available; otherwise the command will fail. If you specify all file pools in which the user ID is enrolled (ALL), then all file pools must be active and available; if any one of them is not, the command will fail.

Deleting a file space makes that file space available for reallocation. It is the opposite of enrolling a user with a particular file space.

Return Codes and Error Messages

The following table lists return codes and error messages for the DELETE command.

Return Code	Message Number	Text
39	0039E	INVALID PARAMETER parameter
99	0099I	command COMMAND CANCELED
328	0328E	INVALID USERID userid
7002	7002E	YOU ARE NOT AUTHORIZED TO MANAGE USER userid
7003	7003E	SFS ERROR REASON CODE 543 DURING DELETE FOR userid filepoolid
7022	7022E	YOU ARE NOT AUTHORIZED TO MANAGE userid IN filepoolid
7025	7025E	userid NOT YET ENROLLED IN filepoolid
7028	7028E	USERID REQUIRED
7068	7068E	YOU ARE NOT AUTHORIZED TO WORK WITH userid
7082	7082E	REQUIRED FIELD fieldname NOT PROVIDED
7098	7098E	UNABLE TO VERIFY STATUS OF FILESPACE userid. ONE OR MORE FILEPOOLS ARE UNAVAILABLE

Note:

For explanations of the message routing options, see Common API Command Options.
For more information about reducing (or increasing) a user's allocation in a file pool without deleting it entirely, see MODIFY Command.
For more information about using the Servant Facility, see the Administration Guide.
For complete descriptions of all messages listed in this section, see the Message Reference Guide.