DEFINE VIRTUALFSMAPPING (Define a virtual file space mapping)
Use this command to define a virtual file space mapping.
Privilege class
- System privilege
- Unrestricted policy privilege
- Restricted policy privilege for the domain to which the NAS node is assigned.
Syntax
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 name which refers to this virtual file space definition. The virtual file space name is case sensitive and the first character must be a forward slash /. The length of the name cannot be more than 64 characters, including the required forward slash. Virtual file space names are restricted to the same character set as all other objects in the server except that the forward slash / character is also allowed.
The virtual file space name cannot be identical to any file system on the NAS node. When selecting a virtual file space name, consider the following restrictions:- If a file system is created on the NAS device with the same name as a virtual file system, a
name conflict will occur on the server when the new file space is backed up. Use a string for the
virtual file space name that is unlikely to be used as a real file system name on your NAS device in
the future.
For example: A user follows a naming convention for creating file spaces on a NAS device with names of the form /vol1, /vol2, /vol3. The user defines a virtual file space to the server with the name /vol9. If the user continues to use the same naming convention, the virtual file space name is likely to conflict with a real file space name at some point in the future.
- During backup and restore operations, the server verifies that a name conflict does not occur prior to starting the operation.
- The virtual file space name appears as a file space in the output of the QUERY FILESPACE command, and also in the backup and restore panels of the IBM Spectrum Protect backup-archive client graphical user interface (GUI). Therefore, consider selecting a name that unambiguously identifies this object as a directory path on the NAS device.
- If a file system is created on the NAS device with the same name as a virtual file system, a
name conflict will occur on the server when the new file space is backed up. Use a string for the
virtual file space name that is unlikely to be used as a real file system name on your NAS device in
the future.
- file_system_name (Required)
Specifies the 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.
- path (Required)
Specifies the path from the root of the file system to the directory. The path can only reference a directory. The maximum length of the path is 1024 characters. The path name is case sensitive.
- NAMEType
- Specifies how the server should interpret the path name specified.
This parameter is useful when a path contains characters that are
not part of the code page in which the server is running. The default
value is SERVER.
Possible values are:
- SERVER
- The server uses the server code page to interpret the path name.
- 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. This could occur if the NAS file system is set to a language different from the one in which the server is running.
Example: Define a virtual file space mapping
Define the virtual file space mapping name /mikeshomedir for the path /home/mike on the file system /vol/vol1 on the NAS node named NAS1.define virtualfsmapping nas1 /mikeshomedir /vol/vol1 /home/mike
Related commands
Command | Description |
---|---|
DELETE VIRTUALFSMAPPING | Delete a virtual file space mapping. |
QUERY VIRTUALFSMAPPING | Query a virtual file space mapping. |
UPDATE VIRTUALFSMAPPING | Update a virtual file space mapping. |