Tivoli Storage Manager for HP-UX Administrator's Reference

RENAME FILESPACE (Rename a Client File Space on the Server)

Use this command to rename an existing client file space on the server to a new file space name or to rename imported file spaces.

If the name of an imported file space is the same as a file space that already exists on a client node, the server will not overlay the existing file space. Instead, the system generates a new name for the imported file space. However, this new name could match an existing name on the client node, which may have file spaces not yet backed up to the server.

Privilege Class

Any administrator with unrestricted policy authority or with restricted policy authority over the client's policy domain can issue this command.

Syntax

>>-REName FIlespace--node_name--current_file_space_name--new_file_space_name-->
 
>--------------------------------------------------------------><
 

Parameters

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

current_file_space_name (Required)
Specifies the name of the file space to be renamed. A file space name is case-sensitive and must be specified exactly as defined to the server.

new_file_space_name (Required)
Specifies the new name for the file space. A client file space name is case-sensitive and must be specified exactly as it is to be defined to the server.

Examples

Task

An AIX client node named LARRY backed up file space /r033 to the TSM server. The file space was exported to tape and later reimported to the server. When this file space was imported, a system-generated name, /r031, was created for it because /r033 already existed for client node LARRY.

Client node LARRY, however, already had a file space named /r031 that was not backed up, therefore, was unknown to the server. Unless the imported file space is renamed, it will overlay filespace /r031 because the file space name generated by the IMPORT function is the same as a file space on client node LARRY that is unknown to the server.

Use the following command to rename imported filespace /r031:

Command:
rename file space larry /r031 /imported-r033

The new name, /imported-r033, identifies that the new filespace is an imported image of filespace /r033.

Related Commands

Table 210. Commands Related to RENAME FILESPACE

Command Description
DELETE FILESPACE Deletes data associated with client's filespaces.
EXPORT NODE Copies client node information to external media.
QUERY FILESPACE Displays information about data in filespaces that belong to a client.
QUERY OCCUPANCY Displays file space information by storage pool.


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