Tivoli Storage Manager for HP-UX Administrator's Reference

DELETE FILESPACE (Delete Client Node Data from the Server)

Use this command to delete file spaces from the server. Files that belong to the file space are deleted from primary and copy storage pools.

TSM deletes one or more file spaces as a series of batch database transactions, thus preventing a rollback or commit for an entire file space as a single action. If the process is canceled or if a system failure occurs, a partial deletion can occur. A subsequent DELETE FILESPACE command for the same node or owner can delete the remaining data.

Privilege Class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the client node is assigned.

Syntax

>>-DELete FIlespace--node_name--file_space_name----------------->
 
      .-Type--=--ANY--------------.
>-----+---------------------------+----------------------------->
      '-Type--=--+-ANY----------+-'
                 +-Backup-------+
                 +-ARchive------+
                 +-SPacemanaged-+
                 '-SERver-------'
 
      .-DAta--=--ANY-------------.   .-Wait--=--No------.
>-----+--------------------------+---+------------------+------->
      '-DAta--=--+-ANY---------+-'   '-Wait--=--+-No--+-'
                 +-FIles-------+                '-Yes-'
                 |        (1)  |
                 '-IMages------'
 
>-----+-----------------------+--------------------------------><
      '-OWNer--=--owner_name--'
 

Notes:

  1. This parameter can only be used when TYPE=ANY or TYPE=BACKUP is specified.

Parameters

node_name (Required)
Specifies the name of the client node to which the file space belongs.

file_space_name (Required)
Specifies the name of the file space to be deleted. This name is case-sensitive and must be entered exactly as it is known to the server. To determine how to enter the name, use the QUERY FILESPACE command. You can use wildcard characters to specify this name.

Type
Specifies the type of data to be deleted. This parameter is optional. The default value is ANY. Possible values are:

ANY
Delete only backed-up versions of files and archived copies of files.

If you specify DELETE FILESPACE node_name * TYPE=ANY, all backed-up data and archived data in all file spaces for that node are deleted. File spaces are deleted only if they do not contain files that are migrated from an HSM client.

Backup
Delete backup data for the file space.

ARchive
Delete all archived data on the server for the file space.

SPacemanaged
Delete files migrated from a user's local file system (space-managed files from an HSM client). The OWNER parameter is ignored when you specify TYPE=SPACEMANAGED.

SERver
Delete all archived files in all file spaces for a node that is registered as TYPE=SERVER.

DAta
Specifies objects to delete. This parameter is optional. The default value is ANY. Possible values are:

ANY
Delete files, directories, and images.

FIles
Delete files and directories.

IMages
Delete image objects. You can only use this parameter if you have specified TYPE=ANY or TYPE=BACKUP.

Wait
Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default value is No. Possible values are:

No
Specifies that the server processes this command in the background. You can continue with other tasks while the command is being processed. Messages created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.

Yes
Specifies that the server processes this command in the foreground. Wait for the command to complete before continuing with other tasks. The server displays the output messages to the administrative client when the command completes.
Note:You cannot specify Wait=Yes from the server console.

OWNer
Restricts the data that is deleted to files belonging to the owner. This parameter is optional; it is ignored when TYPE=SPACEMANAGED. This parameter only applies to multiuser client systems such as AIX and SunOS.

Examples

Task 1

Delete the file space named C_Drive that belongs to the client node HTANG.

Command:
delete filespace htang C_Drive

Task 2

Delete all files migrated from client node APOLLO (that is, all space-managed files).

Command:
delete filespace apollo * type=spacemanaged

Related Commands

Table 86. Commands Related to DELETE FILESPACE

Command Description
CANCEL PROCESS Cancels a background server process.
QUERY ACTLOG Displays messages from the server activity log.
QUERY FILESPACE Displays information about data in filespaces that belong to a client.
QUERY OCCUPANCY Displays file space information by storage pool.
QUERY PROCESS Displays information about background processes.
REMOVE NODE Removes a client from the list of registered nodes for a specific policy domain.
RENAME FILESPACE Renames a client filespace on the server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]