SET.VFS.SERVER

The SET.VFS.SERVER command defines a Virtual File System (VFS) server.

Format

SET.VFS.SERVER name {EXT} handler ip.address{:port} username password {NO.QUERY}

where

name	is the name to be used within QM to reference this server (maximum 15 characters). The name does not need to be related to the network name of the server.

handler

is the VFS handler name. For an external VFS handler, this must be prefixed with EXT. This name is case sensitive on Linux/Unix systems.

ip.address

is the IP address or network name of the server.

port	is the tcp/ip port number on which connection to this server will be made, if relevant.

username

is the user name that will be used to connect to the server.

password

is the password for the supplied username. It is stored internally in encrypted form for security.

The command will prompt for command line elements that are omitted.

Because the ip.address, port and username may not be null strings, a dummy value such as "none" must be entered when defining a VFS handler that does not require this data.

To allow for IPV6 format addresses, the colon separator between the ip.address and the port may alternatively be entered as a semicolon. This applies either on the command line or in response to a prompt for the address.

VFS servers may be defined by any user with system administrator rights using the SET.VFS.SERVER command in the QMSYS account. The NO.QUERY keyword suppresses the confirmation prompt if the server name is already defined. The ADMIN.SERVER command can be used to create or modify server definitions to apply restrictions on which users can access the server.

Example

SET.VFS.SERVER U2 EXT uv 193.100.13.18 sales

This example will create a server known within QM as U2 that uses the external handler named vfs_uv to connect to IP address is 193.100.13.18. Note that the "vfs_" prefix needed on an external VFS handler program is added automatically. If this is included in the handler name supplied to this command, it will be removed. The user name (sales) has been included in the command but, because the password has been omitted, the command will prompt for this.