ContentsIndexPreviousNext

acurcl -config

The "acurcl -config" command allows you to change the configuration of a running AcuLaunch 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 acurcl 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 "rclcfg>" displays. At this prompt, enter any of the following commands:

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

rclcfg> get password_attempts
PASSWORD_ATTEMPTS: 3

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

rclcfg> set password_attempts 5

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

Setting certain variables has no affect on the remote AcuLaunch, 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.

The LIST command lists the names and current values of all variables of which AcuLaunch is aware, including some that do not directly affect AcuLaunch. 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 or EXIT command exits the configure mode.