7.2.2 acuserve -config

"acuserve -config" allows you to change the configuration of a running AcuServer server, for instance, to turn tracing on or off or to change configuration variables such as PASSWORD-ATTEMPTS. When you enter this option, you start communicating with the server running on the named server and named port. If no server name is given, the local server is assumed. If no port number is given, the default port is assumed.

Optional arguments to "-config" include:

Option
Description
server
Specifies the name of the server machine to be configured. If no server is specified, the server is assumed to be the local host.
-n
Identifies a particular instance of the acuserve program by port number. The "-n" must be followed by a space and then an integer, e.g., "6524". If no port number is specified, then the default port is configured.

After you have entered the "-config" option, the prompt "srvcfg>" displays. At this prompt, enter any of the following commands:

GET variable-name
SET variable-name new-value
LIST [{>|>>} file]
! cmd
HELP
QUIT

The GET command gets the value of a single variable. For example:

srvcfg> get max-files
MAX_FILES: 32

The SET command sets a variable in the server. For example:

srvcfg> set max-files 320

Note that if given an invalid variable name, the remote AcuServer sets a variable of that name with the given value, even though that variable will not have any affect on the remote AcuServer. For a list of valid server variables, refer to Section 6.1.2 Server Configuration Variables.

Setting certain variables has no affect on the remote AcuServer, since the variable is used at initialization time, and never checked again.

For example, trying to set ACUSERVER_PORT, SERVER_IP, or SERVER_NAME results in an error message such as:

srvcfg> set SERVER_IP 192.215.170.34
Setting the SERVER_IP has no affect
srvcfg> get SERVER_IP
SERVER_IP: 192.215.170.34

Note that a GET command shows the new value, but it will not be used.

The LIST command lists the names and current values of all variables of which AcuServer is aware, including some that do not directly affect AcuServer. Use the optional "{>|>>} file" syntax to send the output to a named file instead of the screen. ">" creates a new file of the specified name, and ">>" appends the output to an existing file.

The "! cmd" command causes the command "cmd" to be executed.

The HELP command prints a quick synopsis of available commands. It looks very similar to the above list.

The QUIT command exits the configure mode.

Option	Description
server	Specifies the name of the server machine to be configured. If no server is specified, the server is assumed to be the local host.
-n	Identifies a particular instance of the acuserve program by port number. The "-n" must be followed by a space and then an integer, e.g., "6524". If no port number is specified, then the default port is configured.