Command Line Utility dicfg.exe

The dicfg utility can run locally or remotely. The utility operates on the dataroot directly on a server with the -dataroot variable, or dicfg accesses a remote DiveLine server with the -remote variable. The dicfg process is internal to the DiveLine server, that is, no remote dicfg.exe runs when you connect to the DiveLine server remotely.

For remote connections or batch entries, use a colon (:) to separate the DiveLine user name and the password and an "at" sign (@) to separate the password and server when logging in. For example:

dicfg -remote <uid>:<pw>@<server>:<port> <dicfg command>

Alternatively, as of 7.1(32), there are three separate commands that set the user name, password, and server for remote connection:

• -remote_user <user>

• -remote_password <password>

• -remote_server <server>[:<port_number>]

NOTE: The three separate -remote commands cannot be used in the same line as the combined -remote command.

For a local connection, the syntax is simpler. For example:

dicfg -dataroot C:\DI_Solution\dl-dataroot <dicfg command>

The scripts found in the DI_DICFG Package were developed for Diver Solution 6.x. The dicfg.exe utility has not changed for 7.x, with the exception of user categories.

Before using dicfg, please note the following:

• In the syntax examples, replace each item contained in brackets < > with the appropriate user name, group, password, or other item.
• All commands that begin with set, get, or list include the -q option, which suppresses either the header information or the confirmation output.
• Variables are preceded by a hyphen (-). Any number of variables can be used in the commands that allow multiple options.
• Some commands allow you to enter a list of items separated by commas.
• All commands can be entered on the command line for UNIX or DOS after typing dicfg.
• The dataroot variable specifies the DiveLine dataroot. The dicfg call can use a variable, as shown in the following example:

  dicfg -dataroot $DIDATAROOT <dicfg commands>

• You must specify the server that you are connecting to before specifying the dataroot. If you have multiple dataroots, always explicitly specify one by using the dataroot variable. Otherwise, on Windows, dicfg uses the system default dataroot, which is the one that was most recently specified when installing a DiveLine service.
• You can display the system default dataroot with the di-service -list command.

• The default dataroot on Windows for dicfg (and dlcgi), when not noted in the registry, is: C:\DI\Solution\dl-dataroot. It can also be found in the registry at HKLM\Software\Dimensional Insight\DI-DiveLine (possibly under the WOW64Node if 32-bit on 64-bit Windows). If needed, you can update the registry and add a new string named "dataroot" with a value that points to the desired default location.

• If at any point you need help with a command syntax, use the help command: help <command>. For example, the following command displays the syntax for the List command:

  dicfg help list

• As of DiveLine 7.1(38), time stamps for dicfg scripts reflect the date and time of either the remote server or the local machine, depending on the connection type.