acurcl -config

You can configure server configuration variables on the fly using the acurcl -config command. The acurcl -config command allows you to change the configuration of a running AcuConnect 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 AcuConnect 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 rclcfg> appears. At this prompt, enter any of the following commands: 

GET variable-name
 Gets the value of a single variable. For example: 
rclcfg> get password_attempts
PASSWORD_ATTEMPTS: 3
 
SET variable-name new-value

Sets a variable in the server. For example: 

rclcfg> set password_attempts 5

Note that if given an invalid variable name, the remote AcuConnect sets a variable of that name with the given value, even though that variable will not have any effect on the remote AcuConnect. See Creating a Server Configuration File for a list of valid server variables.

Setting certain variables has no effect on the remote AcuConnect, since the variable is used at initialization time and never checked again. For example, trying to set ACURCL_PORT, SERVER_IP, or SERVER_NAME results in an error message such as: 

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

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

LIST [{>|>>} file]

Lists the names and current values of all variables of which AcuConnect is aware, including some that do not directly affect AcuConnect. 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
EXIT

These commands exit the configure mode.

Parent topic: The acurcl Command