SET.SERVER, SET.PRIVATE.SERVER

The SET.SERVER command defines a QMNet server available to all users. The SET.PRIVATE.SERVER command defines a QMNet server visible only from the QM session in which the command is executed.

Format

SET.SERVER name ip.address{:port} username password

SET.PRIVATE.SERVER name ip.address{:port} username password

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.

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. It must correspond to the port on which the server listens for incoming QMClient connections. If omitted, the default QMClient port (4243) is used.

username

is the username that will be used to connect to the server. This must be defined at the operating system level on the server but does not need to be defined on the local system.

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.

QMNet allows an application to access QM data files on other servers as though they were local file, with complete support for concurrency control via file and record locks. The remote server must have remote access enabled by setting the NETFILES configuration parameter to 2.

Public servers may be defined by any user with system administrator rights using the SET.SERVER command in the QMSYS account.

Private servers are defined using the SET.PRIVATE.SERVER command. As part of the QM security system (see Application Level Security), the SET.PRIVATE.SERVER command is only available to users for which it is enabled in their user register entry. On a system running with security disabled, any user may define private servers.

Example

SET.SERVER ADMIN 193.100.13.18:4000 root

This example will create a server known within QM as ADMIN. The server IP address is 193.100.13.18 and connection will use port 4000. The username (root) has been included in the command but, because the password has been omitted, the command will prompt for this.