Top  Previous  Next


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.





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

SET.SERVER name ip.address{:port} LIKE {NO.QUERY}

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




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.


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


usernameis the user name 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. For a domain style login use user@domain or the older domain\user format.


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


server.nameis the name of another server from which the security data is to be copied.



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


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.


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. The NO.QUERY keyword suppresses the confirmation prompt if the server name is already defined. A public server defined with this command can be accessed by all users. The ADMIN.SERVER command can be used to create or modify server definitions to apply restrictions on which users can access the server. Alternatively, the LIKE keyword can be used to copy the security settings from another public server definition.


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. The default behaviour of QM is to allow a private server definition to have the same name as a public server, effectively redirecting connections to that server. The SECURITY configuration parameter can be used to disallow creation of such definitions.







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



See also: