QUERY VIRTUALFSMAPPING (Query a virtual file space mapping)

Use this command to query a virtual file space mapping definition.

Privilege class

Any administrator can issue this command.

Syntax


>>-Query VIRTUALFSmapping -------------------------------------->

   .-*--*----------------------------------.   
>--+---------------------------------------+-------------------><
   |            .-*----------------------. |   
   '-node_name--+------------------------+-'   
                '-virtual_filespace_name-'

Parameters

node_name: Specifies the client node to which the virtual file space belongs. You can use wildcard characters to specify this name. This parameter is optional. The default is all client node names. You must specify a value for this parameter if you specify a virtual file space name.
virtual_file_space_name: Specifies the name of the virtual file space mappings to be queried. You can use wildcard characters to specify this name. This parameter is optional. If a value is not specified, all virtual file space mappings are queried. Virtual file space mapping names are case sensitive. Use the QUERY VIRTUALFSMAPPING command to determine the correct capitalization for the virtual file space mapping to be queried.

Example: Display virtual file spaces for a specific node

Display the currently defined virtual file spaces for node NAS1. See Field descriptions for field descriptions.

query virtualfsmapping nas1

Node    Virtual Filespace  Filespace   Path              Hexadecimal
Name    Mapping Name       Name                          Path?      
------  -----------------  ----------  ----------------- -----------
NAS1    /mikesdir          /vol/vol2   /mikes            No         
NAS1    /tmpdir            /vol/vol1   /tmp              No         
NAS1    /nonASCIIDir       /vol/vol3   2f73657276657231  Yes

Field descriptions

Node Name

Specifies the name of the client node.

Virtual Filespace Mapping Name

Specifies the name of the virtual file space mapping.

Filespace Name

The name of the file space that belongs to the node.

File space names can be in a different code page or locale than the server. If they are, the names in the Operations Center and the administrative command-line interface might not be displayed correctly. Data is backed up and can be restored normally, but the file space name or file name might be displayed with a combination of invalid characters or blank spaces.

If the file space name is Unicode-enabled, Tivoli® Storage Manager converts the name to the server code page for display. The success of the conversion depends on the operating system, the characters in the name, and the server code page. Conversion can be incomplete if the string includes characters that are not available in the server code page or if the server cannot access system conversion routines. If the conversion is incomplete, the name might contain question marks, blanks, unprintable characters, or ellipses (...).

Path

Specifies the path to the client node.

Hexadecimal Path

Indicates whether the path is hexadecimal.

Related commands

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