acurcl -start

The "acurcl -start" command causes acurcl to be started. On Windows NT and Windows 2000 servers, this option also installs AcuLaunch as a Windows NT/2000 service, if it is not already installed. In addition, if no start-up options are stored, "acurcl -start" stores the start-up options to be used as the default options.

To use "-start" on a UNIX server, you must be logged in as root or superuser. On a Windows NT or Windows 2000 server, you must use "-start" from the Administrator account or from an account that belongs to the Administrators group.

acurcl is started in background unless the "-f" option is specified. If acurcl is already running, AcuLaunch outputs the message:

acurcl is already running on hostname

A new acurcl process is not started. If you want to start AcuLaunch with new options, you must stop and restart acurcl.

Note for Windows NT/2000: On Windows NT and Windows 2000 systems, it is best to specify "acurcl -start" with no options. This causes it to use the start-up parameters that have been stored for the service. Typically, if you specify options with "acurcl -start" then these options are in effect only until the AcuRCL service is started again. The exception to this is if no start-up parameters have been stored for the service. In this case, the parameters that you use to start acurcl with are stored for future start-up use.

Optional arguments to "-start" include:

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/acurcl.cfg" for UNIX or "\etc\acurcl.cfg" for Windows NT/2000.
-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 and transaction messages 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 of the acuthin command.

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 attempted. (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".

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/acurcl.cfg" for UNIX or "\etc\acurcl.cfg" for Windows NT/2000.
-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 and transaction messages 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 of the acuthin command. 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 attempted. (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".