Tivoli Header
Administrator's Reference
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------'
.-NAMEType--=--SERVER------.
>--+----------------------+--+--------------------------+------->
'-OWNer--=--owner_name-' '-NAMEType--=--+-SERVER--+-'
+-UNIcode-+
'-FSID----'
.-CODEType--=--BOTH-----------.
>--+-----------------------------+-----------------------------><
'-CODEType--=--+-UNIcode----+-'
+-NONUNIcode-+
'-BOTH-------'
Notes:
- 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.
For a server that has clients with support for Unicode, you may need to
have the server convert the file space name that you enter. For
example, you may need to have the server convert the name you enter from the
server's code page to Unicode. See the NAMETYPE parameter for
details. If you do not specify a file space name, or specify only a
single wildcard character for the name, you can use the CODETYPE parameter to
limit the operation to Unicode file spaces or to non-Unicode file
spaces.
- 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 on an MVS system
console and in the TSM server's Job Log.
- 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 when you issue this command with the MVS
MODIFY command.
- 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.
- NAMEType
- Specify how you want the server to interpret the file space names that you
enter. This parameter is useful when the server has clients with
support for Unicode. A backup-archive client with support for Unicode
is currently available only for the following operating systems: Windows
NT, Windows 2000, Windows 2002, Windows .NET, and Windows XP.
Use this parameter only when you enter a partly or fully qualified file
space name. The default value is SERVER. Possible values
are:
- SERVER
- The server uses the server's code page to interpret the file space
names.
- UNIcode
- The server converts the file space names from the server code page to the
UTF-8 code page. The success of the conversion depends on the actual
characters in the name and the server's code page. Conversion can
fail if the string includes characters that are not available in the server
code page, or if the server has a problem accessing system conversion
routines.
- FSID
- The server interprets the file space names as their file space IDs
(FSIDs).
- CODEType
- Specify what type of file spaces are to be included in the
operation. The default is BOTH, meaning that file spaces are included
regardless of code page type. Use this parameter only when you enter a
single wildcard character for the file space name. Possible values
are:
- UNIcode
- Include only file spaces that are in Unicode.
- NONUNIcode
- Include only file spaces that are not in Unicode.
- BOTH
- Include file spaces regardless of code page type.
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 78. 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 ]