AcuODBC Server comes with a UNIX command-line DSN configuration utility, srvconfig.sh, so that no matter what your working environment, you can easily configure remote DSNs.
The srvconfig.sh utility is an interactive, UNIX command-line equivalent of the AcuODBC Server Configuration utility. Acucorp strongly recommends that you read Chapter 3, "Creating Data Sources" on configuring DSNs and "Configuring Remote Data Sources in Windows" in section 9.3.1 before using srvconfig.sh. The remainder of this chapter describes working with remote data sources in a UNIX command-line environment and provides some sample sessions with the srvconfig.sh utility.
Notes on srvconfig.sh and the UNIX command-line environment
UNIX is a case-sensitive environment. Each time you enter the name of a DSN, enter it in the same case that was used to create it, because UNIX regards "multi.dsn", "Multi.dsn", and "MULTI.dsn", for example, as three distinct data source names. The srvconfig.sh utility displays the names of your existing DSNs, so simply enter the name of the DSN as it appears in the listing.
In a notable exception to this case-sensitivity, you can use either case to respond to most prompts in srvconfig.sh. However, this does not apply to paths or the names of files and directories. When supplying such information, you must use the proper case.
Similarly, when responding to prompts (other than those requiring a path or filename), you can "abbreviate" your reply by typing only enough characters to distinguish your response from other choices that start with the same letters. For example, when you are asked what type of information you want to edit, Advanced and AcuServer are both among your choices. To distinguish between these, you must enter at least "ad" or "ac" before pressing Enter. Likewise, the response to a prompt may include "MoveDown" or "MoveUp". In this instance, you must enter at least "moved" or "moveu" before pressing Enter. (You may enter your response in either uppercase or lowercase letters.) See "Starting srvconfig.sh" for examples. If you enter too few letters, you receive the following message:
Ambiguous choice. Restricting future choices.
srvconfig.sh returns you to the prompt, but this time your choices are restricted to those that start with the letters you had entered. For example:
What type of information do you want to edit? General, Advanced, Vision, Tracing, FileAlias, Multicompany, AcuServer [Exit]: a Ambiguous choice. Restricting future choices. What type of information do you want to edit? Advanced, AcuServer: ad File Case: [Default], Upper, Lower:
If you enter a choice not among those listed, srvconfig.sh returns
Invalid choice.
and repeats the prompt.
You can receive the following prompt several times during a srvconfig.sh session:
What type of information do you want to edit? General, Advanced, Vision, Tracing, FileAlias, Multicompany, AcuServer [Exit]:
These choices correspond to the tabs on the AcuODBC Server Configuration property sheet, which is shown below.
In a command-line environment, you must answer the questions or respond to prompts in the order in which they appear. You cannot "move around" as you would in a windowed environment. When using srvconfig.sh, if you must change data that you have already entered, you have two choices:
More: