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.
You might want to rename a file space that was imported or to cause the creation of new Unicode-enabled file spaces for Unicode-enabled clients.
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-----------------> .-NAMEType--=--SERVER------. >--+--------------------------+---------------------------------> '-NAMEType--=--+-SERVER--+-' +-UNIcode-+ '-FSID----' .-NEWNAMEType--=--SERVER----------. >--+---------------------------------+--+---------------+------>< | (1) | '-force--=--yes-' '-NEWNAMEType--=--+-UNIcode-----+-' '-HEXadecimal-'
- This parameter is the default when you specify NAMEType=UNIcode.
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. Virtual file space mapping names are allowed.
- 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. This parameter cannot be an existing virtual
file space mapping name. If the current_file_space_name is
a virtual file space, the new_file_space_name must
follow all the rules for defining a virtual file space name. See the DEFINE
VIRTUALFSMAPPING command for more information. Important: If the new name type is hexadecimal, specify valid UTF-8 hexadecimal values so the server's code page displays the file space name as intended. For example, do not specify a value that can be interpreted as a backspace.
- When you rename a file space that is part of a file space collocation group, the collocation group is updated with the new name.
- NAMEType
- Specify how you want the server to interpret the current file
space name that you enter. This parameter is useful when the server
has clients with support for Unicode. You can use this parameter for
Unicode-enabled IBM Spectrum Protect™ clients
with Windows, Macintosh OS X, and NetWare operating
systems.
The default value is SERVER. If a virtual file space mapping name is specified, you must use SERVER. Possible values are:
- SERVER
- The server uses the server's code page to interpret the file space name.
- UNIcode
- The server converts the file space name that is entered 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 cannot access system conversion routines.
- FSID
- The server interprets the file space name as the file space ID (FSID).
- NEWNAMEType
- Specify how you want the server to interpret the new file space
name that you enter. The default is SERVER if you specified the NAMETYPE
as SERVER, or if the file space to be renamed is not Unicode. The
default is UNICODE if you specified the NAMETYPE as UNICODE, or if
the file space to be renamed is Unicode. If a virtual file space mapping
name is specified, you must use SERVER. Possible values are:
- SERVER
- The server uses the server's code page to interpret the file space name.
- UNIcode
- The server converts the file space name that is entered 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. If the conversion is not successful, you might want to specify the HEXADECIMAL parameter.
- HEXadecimal
- The
server interprets the file space name that you enter as the hexadecimal
representation of a name in Unicode. Using hexadecimal ensures that
the server is able to correctly rename the file space, regardless
of the server's code page. To view the hexadecimal representation of a file space name, you can use the QUERY FILESPACE command with FORMAT=DETAILED.Restriction: You cannot specify a new name of a type that is different from the original name. You can rename a file space that is Unicode to another name in Unicode. You can rename a file space that is not Unicode, and use a new name in the server's code page. You cannot mix the two types.
- force
- To rename a NAS or VMware file space you must set this parameter as follows: force=yes
Rename an imported file space to prevent overwriting
An AIX® client node named LARRY backed up file space /r033 to the IBM Spectrum Protect 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 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 overlays file space /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.
rename filespace larry /r031 /imported-r033
Rename file space to create a Unicode-enabled file space
Client JOE is using an English Unicode-enabled IBM Spectrum Protect client. JOE backed up several large file spaces that are not Unicode that is enabled in server storage. File space \\joe\c$ contains some files with Japanese file names that cannot be backed up to a file space that is not Unicode that is enabled. Because the file spaces are large, the administrator does not want to convert all of JOE's file spaces to Unicode-enabled file spaces now. The administrator wants to rename only the non-Unicode file space, \\joe\c$, so that the next backup of the file space causes the creation of a new Unicode-enabled file space. The new Unicode-enabled file space allows the Japanese files to be successfully backed up.Use the following command to rename \\joe\c$:
rename filespace joe \\joe\c$ \\joe\c$_old
Related commands
Command | Description |
---|---|
DEFINE VIRTUALFSMAPPING | Define a virtual file space mapping. |
DELETE FILESPACE | Deletes data associated with client file spaces. If a file space is part of a collocation group and you remove the file space from a node, the file space is removed from the collocation group. |
EXPORT NODE | Copies client node information to external media or directly to another server. |
QUERY FILESPACE | Displays information about data in file spaces that belong to a client. |
QUERY OCCUPANCY | Displays file space information by storage pool. |