7.2.8 acuserve -start

"acuserve -start" causes acuserve to be started. On Windows NT and Windows 2000 servers, this option also installs AcuServer as a Windows NT/2000 service, if it is not already installed. In addition, if no start-up options are stored, "acuserve -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.

acuserve is started in background unless the "-f" option is specified. If acuserve is already running, AcuServer will output the message:

acuserve is already running on hostname

A new acuserve process will not be started. If you want to start AcuServer with new options, you must stop and restart acuserve.

Note for Windows NT/2000: On Windows NT and Windows 2000 systems, it is best to specify "acuserve -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 "acuserve -start" then these options will be in effect only until the acuserve 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 acuserve with will be 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, acuserve looks for the configuration file in its default location: "/etc/a_srvcfg" for UNIX or "\etc\a_srvcfg" for Windows NT/2000.
-e
Causes error output from acuserve 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, acuserve will attempt to direct error output to /dev/console. If /dev/console cannot be opened, acuserve will attempt to append to a file named acuserve.err in the current directory. If that file doesn't exist, or the file append fails, acuserve will print the message "acuserve: can't open error output file" to standard output, and acuserve will terminate.
-f
By default, acuserve runs in background. Use the "-f" option to run acuserve in foreground. When run in foreground, the acuserve process traps normal keyboard signals, such as Control-C.
If combined with the "-t" option, the "-f" option causes acuserve 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 acuserve program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACUSERVER-PORT value set in the server configuration file.
The "-n" option associates a port number with one instance of the acuserve daemon. Client applications can, in turn, be assigned to a particular instance of the acuserve daemon via the ACUSERVER-PORT variable in the runtime configuration file.
The acuserve 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 acuserve on two different ports, you must also specify all start-up arguments, including the configuration file, as in:
acuserve -start -n 6523 -c c:\etc\config1 [other options] acuserve -start -n 6524 -c c:\etc\config2 [other options]
-t #
Turns on file tracing and transaction logging. When combined with the "-e" option, file trace and transaction messages are placed in the named error file. "#" represents the type of tracing or logging to be performed.
"1" turns on file tracing, and a message is printed to standard output every time a file operation is performed. The message includes: the type of file operation performed, the name of the target file or file ID, and the values of any applicable keys.
"2" turns on connection information logging, and a message is output whenever a connection request is made, a disconnect is performed, or an "acuserve -kill" or "acuserve -unlock" command is processed.
"3" turns on file tracing and connection information logging.
"5" turns on file tracing and flushes the error file after each write operation. (File trace flushing can also be controlled with the FILE-TRACE-FLUSH server configuration variable; see Section 6.1.2).
"6" turns on connection information logging and flushes the error file after each write operation.
"7" turns on file tracing and connection information logging, and flushes the error file after each write operation.

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, acuserve looks for the configuration file in its default location: "/etc/a_srvcfg" for UNIX or "\etc\a_srvcfg" for Windows NT/2000.
-e	Causes error output from acuserve 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, acuserve will attempt to direct error output to /dev/console. If /dev/console cannot be opened, acuserve will attempt to append to a file named acuserve.err in the current directory. If that file doesn't exist, or the file append fails, acuserve will print the message "acuserve: can't open error output file" to standard output, and acuserve will terminate.
-f	By default, acuserve runs in background. Use the "-f" option to run acuserve in foreground. When run in foreground, the acuserve process traps normal keyboard signals, such as Control-C. If combined with the "-t" option, the "-f" option causes acuserve 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 acuserve program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACUSERVER-PORT value set in the server configuration file. The "-n" option associates a port number with one instance of the acuserve daemon. Client applications can, in turn, be assigned to a particular instance of the acuserve daemon via the ACUSERVER-PORT variable in the runtime configuration file. The acuserve 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 acuserve on two different ports, you must also specify all start-up arguments, including the configuration file, as in: `acuserve -start -n 6523 -c c:\etc\config1 [other options] acuserve -start -n 6524 -c c:\etc\config2 [other options]`
-t #	Turns on file tracing and transaction logging. When combined with the "-e" option, file trace and transaction messages are placed in the named error file. "#" represents the type of tracing or logging to be performed. "1" turns on file tracing, and a message is printed to standard output every time a file operation is performed. The message includes: the type of file operation performed, the name of the target file or file ID, and the values of any applicable keys. "2" turns on connection information logging, and a message is output whenever a connection request is made, a disconnect is performed, or an "acuserve -kill" or "acuserve -unlock" command is processed. "3" turns on file tracing and connection information logging. "5" turns on file tracing and flushes the error file after each write operation. (File trace flushing can also be controlled with the FILE-TRACE-FLUSH server configuration variable; see Section 6.1.2). "6" turns on connection information logging and flushes the error file after each write operation. "7" turns on file tracing and connection information logging, and flushes the error file after each write operation.