8.5.7 acuodbcs -start

"acuodbcs -start" causes acuodbcs to start running. On Windows NT and Windows 2000 servers, this option also installs AcuODBC Server as a Windows NT/2000 service, if it is not already installed. In addition, if no startup options are stored, "acuodbcs -start" stores the startup 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.

acuodbcs is started in background unless the "-f" option is specified. If acuodbcs is already running, AcuODBC Server outputs the message:

The AcuODBCS 5.2 on the default port <20222> service is already running on hostname

A new acuodbcs process will not be started. If you want to start the AcuODBC Server with new options, you must stop and restart acuodbcs.

Note for Windows NT/2000: On Windows NT and Windows 2000 systems, it is best to specify "acuodbcs -start" with no options. This causes it to use the startup parameters that have been stored for the service. Typically, if you specify options with "acuodbcs -start", these options are in effect only until the acuodbcs service is started again. The exception to this is if no startup parameters have been stored for the service. In this case, the parameters that you use to start acuodbcs with will be stored for future startup 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, acuodbcs looks for the configuration file in its default location: "/etc/odbcscfg" for UNIX or "\etc\odbcscfg" for Windows NT/2000.
-f By default, acuodbcs runs in the background. Use the "-f" option to run acuodbcs in foreground. When run in the foreground, the acuodbcs process traps normal keyboard signals, such as Control-C.
-n Assigns a port number to this instance of the acuodbcs program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACUODBCS_PORT value set in the server configuration file.

The "-n" option associates a port number with one instance of the acuodbcs daemon. Client applications can, in turn, be assigned to a particular instance of the acuodbcs service via the Port Number field on the AcuODBC Server tab of the AcuODBC Configuration property sheet.

The acuodbcs 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.

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, acuodbcs looks for the configuration file in its default location: "/etc/odbcscfg" for UNIX or "\etc\odbcscfg" for Windows NT/2000.
-f	By default, acuodbcs runs in the background. Use the "-f" option to run acuodbcs in foreground. When run in the foreground, the acuodbcs process traps normal keyboard signals, such as Control-C.
-n	Assigns a port number to this instance of the acuodbcs program. The "-n" must be followed by a space and then an integer, e.g., "6524". It overrides the ACUODBCS_PORT value set in the server configuration file. The "-n" option associates a port number with one instance of the acuodbcs daemon. Client applications can, in turn, be assigned to a particular instance of the acuodbcs service via the Port Number field on the AcuODBC Server tab of the AcuODBC Configuration property sheet. The acuodbcs 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.