Changing Properties From the Command Line

When you enter the acuserve -config command, you start communicating with the process 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 on which the acuserve process is 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, for example, 6524. If no port number is specified, the default port is configured.

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

Command Description
GET variable-name Fetches and displays the value of a single variable. For example:
srvcfg> get max_files 
MAX_FILES: 32
SET variable-name new-value      Sets the value of a variable. For example:
srvcfg> set max_files 320

Note that if given an invalid variable name, the acuserve process sets a variable of that name with the given value, even though that variable will not have any effect on acuserve.

Be aware, also, that some variables are checked by acuserve only at initialization, so changing these variables on a running instance of the service will have no effect. For example, if you try to set ACUSERVER_PORT, SERVER_IP, or SERVER_NAME with the acuserve -config command, you receive an error message similar to the following:

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

Note that the GET command will show the new value, but the value will not be used.

LIST [(>|>>) file] 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.
! cmd Causes the command cmd to be executed.
HELP Prints a quick synopsis of available commands. It looks very similar to the above list.
QUIT Exits the configure mode.