UPDATE VIRTUALFSMAPPING (Update a virtual file space mapping)

Use this command to update an existing virtual file space mapping definition. Refer to the documentation about your NAS device for more information about this command.

The NAS node must have an associated data mover definition because when the Tivoli® Storage Manager server updates a virtual file space mapping, the server attempts to contact the NAS device to validate the virtual file system and file system name.

Privilege class

To issue this command, you must have one of the following privilege classes:
  • System privilege
  • Unrestricted policy privilege
  • Restricted policy privilege for the domain to which the NAS node is assigned

Syntax

Read syntax diagramSkip visual syntax diagram
>>-UPDate VIRTUALFSMapping--node_name--virtual_filespace_name--->

>--+-------------------------------------+---------------------->
   '-FILESystem--=--new_file_system_name-'   

>--+----------------------------------------------------------+-><
   |                         .-NAMEType--=--SERVER----------. |   
   '-PATH--=--new_path_name--+------------------------------+-'   
                             '-NAMEType--=--+-SERVER------+-'     
                                            '-HEXadecimal-'       

Parameters

node_name (Required)

Specifies the NAS node on which the file system and path reside. You cannot use wildcard characters or specify a list of names.

virtual_filespace_name (Required)

Specifies the virtual file space mapping to update. You cannot use wildcard characters or specify a list of names.

FILESystem

Specifies the new name of the file system in which the path is located. The file system name must exist on the specified NAS node. The file system name cannot contain wildcard characters. The file system name should only be modified when the file system name is modified on the NAS device or, for example, the directory is moved to a different file system. This parameter is optional.

PATH

Specifies the new path from the root of the file system to the directory. The path can only reference a directory. This should only be modified when the path on the NAS device has changed; for example, the directory is moved to a different path. The maximum length of the path is 1024 characters. The path name is case sensitive. This parameter is optional.

NAMEType

Specifies how the server should interpret the path name specified. Specify this parameter only if you specify a path. This parameter is useful when a path contains characters that are not part of the code page on which the server is running. The default value is SERVER.

Possible values are:
SERVER
The code page in which the server is running is used to interpret the path.
HEXadecimal
The server interprets the path that you enter as the hexadecimal representation of the path. This option should be used when a path contains characters that cannot be entered. For example, this could occur if the NAS file system is set to a language different from the one in which the server is running.

Example: Modify the path of a virtual file space mapping

Update the virtual file space mapping named /mikeshomedir for the NAS node NAS1 by modifying the path.
update virtualfsmapping nas1 /mikeshomedir path=/new/home/mike

Related commands

Table 1. Commands related to UPDATE VIRTUALFSMAPPING
Command Description
DEFINE VIRTUALFSMAPPING Define a virtual file space mapping.
DELETE VIRTUALFSMAPPING Delete a virtual file space mapping.
QUERY VIRTUALFSMAPPING Query a virtual file space mapping.