To start acurcl on a UNIX server

1. Log in as root or superuser.

2. Issue the "acurcl -start" command on the server command line. Valid options to "-start" are listed below.

Option Description
-c Specifies the name and path of the server configuration file. The "-c" must be followed by a space, and then the path and name of the server configuration file. When "-c" is not used, acurcl looks for the configuration file in its default location: "/etc/a_rclcfg".
-e Causes error output from acurcl to be output to the named file. The "-e" must be followed by a space and the path and name of the error output file. If "-e" is not specified, acurcl attempts to direct error output to /dev/console. If /dev/console cannot be opened, acurcl attempts to append to a file named "acurcl.err" in the current directory. If that file doesn't exist, or the file append fails, acurcl prints the message "acurcl: can't open error output file" to standard output, and acurcl terminates.
-f By default, acurcl runs in background. Use the "-f" option to run acurcl in foreground. When run in foreground, the acurcl process traps normal keyboard signals, such as Control-C. If combined with the "-t" option, the "-f" option causes acurcl to display tracing information directly to the screen. However, if the "-e" switch is used, all messages are placed in the named log file.
-l Causes a listing of the server configuration file to be printed to standard error output. This can be helpful when you are debugging problems that may be related to configuration variables. When this option is combined with the "-e" option, the listing is captured in the error output file.
-n Assigns a port number to this instance of the acurcl program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACURCL_PORT value set in the server configuration file.

The "-n" option associates a port number with one instance of the acurcl daemon. Client applications can, in turn, be assigned to a particular instance of the acurcl daemon via the <server:port> notation on the acuthin command line. Thin clients launched from a Web page can have the port number specified by the atc-port variable in the thin client command line file (see 3.6.1 Thin Client Command Line Files).

The acurcl daemon can work with privileged port numbers (from 0 to 1023), and with non-privileged port numbers (1024 and higher). Privileged port numbers are useful for external, secure applications.

Note: If you start acurcl on two different ports, you must also specify all start-up arguments, including the configuration file, as in:

acurcl -start -n 5632 -c c:\etc\config1 [other options]

acurcl -start -n 5633 -c c:\etc\config2 [other options]
-t # Turns on the tracing function. When combined with the "-e" option, trace information is placed in the named error file. "#" represents the type of tracing or logging to be performed.

"1" provides information about access file match attempts. The trace information buffer is flushed to the error file when the buffer is filled or acurcl terminates.

"2" provides information about runtime requests. The buffer is flushed to the error file when the buffer is filled or acurcl terminates.

"3" provides the information described for "1" and "2".

"5" is equivalent to "1", but the tracing buffer is flushed to the error file each time an access file match is requested. (File trace flushing can also be controlled with the FILE_TRACE_FLUSH server configuration variable. See 3.3.2 Assigning Values to Server Configuration Variables)

"6" is equivalent to "2", but the tracing buffer is flushed to the error file each time a runtime is requested.

"7" provides the information described for "5" and "6".

You can stop AcuLaunch at any time by issuing the "acurcl -kill" command. See Appendix A for a discussion of the "-kill" command options.

Option	Description
-c	Specifies the name and path of the server configuration file. The "-c" must be followed by a space, and then the path and name of the server configuration file. When "-c" is not used, acurcl looks for the configuration file in its default location: "/etc/a_rclcfg".
-e	Causes error output from acurcl to be output to the named file. The "-e" must be followed by a space and the path and name of the error output file. If "-e" is not specified, acurcl attempts to direct error output to /dev/console. If /dev/console cannot be opened, acurcl attempts to append to a file named "acurcl.err" in the current directory. If that file doesn't exist, or the file append fails, acurcl prints the message "acurcl: can't open error output file" to standard output, and acurcl terminates.
-f	By default, acurcl runs in background. Use the "-f" option to run acurcl in foreground. When run in foreground, the acurcl process traps normal keyboard signals, such as Control-C. If combined with the "-t" option, the "-f" option causes acurcl to display tracing information directly to the screen. However, if the "-e" switch is used, all messages are placed in the named log file.
-l	Causes a listing of the server configuration file to be printed to standard error output. This can be helpful when you are debugging problems that may be related to configuration variables. When this option is combined with the "-e" option, the listing is captured in the error output file.
-n	Assigns a port number to this instance of the acurcl program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACURCL_PORT value set in the server configuration file. The "-n" option associates a port number with one instance of the acurcl daemon. Client applications can, in turn, be assigned to a particular instance of the acurcl daemon via the <server:port> notation on the acuthin command line. Thin clients launched from a Web page can have the port number specified by the atc-port variable in the thin client command line file (see 3.6.1 Thin Client Command Line Files). The acurcl daemon can work with privileged port numbers (from 0 to 1023), and with non-privileged port numbers (1024 and higher). Privileged port numbers are useful for external, secure applications. Note: If you start acurcl on two different ports, you must also specify all start-up arguments, including the configuration file, as in: acurcl -start -n 5632 -c c:\etc\config1 [other options] acurcl -start -n 5633 -c c:\etc\config2 [other options]
-t #	Turns on the tracing function. When combined with the "-e" option, trace information is placed in the named error file. "#" represents the type of tracing or logging to be performed. "1" provides information about access file match attempts. The trace information buffer is flushed to the error file when the buffer is filled or acurcl terminates. "2" provides information about runtime requests. The buffer is flushed to the error file when the buffer is filled or acurcl terminates. "3" provides the information described for "1" and "2". "5" is equivalent to "1", but the tracing buffer is flushed to the error file each time an access file match is requested. (File trace flushing can also be controlled with the FILE_TRACE_FLUSH server configuration variable. See 3.3.2 Assigning Values to Server Configuration Variables) "6" is equivalent to "2", but the tracing buffer is flushed to the error file each time a runtime is requested. "7" provides the information described for "5" and "6".