SET.VFS.SERVER

SET.VFS.SERVER

Top  Previous  Next

 

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

 

nameis 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.

 

handleris 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.addressis the IP address or network name of the server.

 

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

 

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

 

passwordis 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.

 

 

See also:

The Virtual File System, ADMIN.SERVER, DELETE.SERVER, LIST.SERVERS