Progress
Client Deployment
Guide


Using the INI2REG Utility

The INI2REG utility lets you translate the contents of an initialization (.ini) file into comparable Registry key entries. You can access the INI2REG utility through a graphical user interface or from the command line.

Using the Graphical User Interface

To access the INI2REG utility through its graphical user interface, specify the INI2REG command using the following syntax:

ini2reg 

The INI File to Registry Translation dialog box appears:

To translate an initialization file:

  1. From the INI File to Registry Translation dialog box, choose the Browse button or File Open. The Open dialog box appears.
  2. Type in or browse for the initialization file you want to translate, and choose OK. The name of the selected file appears in the .INI file to translate field.
  3. From the Registry base key drop-down list, select the base key under which you want to create the subkey entries. The default subkey that corresponds to the selected initialization file and base key appears in the Registry subkey field.
  4. If you want to use a subkey other than the default, type the subkey name in the Registry subkey field.

  5. To begin the translation, choose the Translate button or File Translate. For each entry in the initialization file, INI2REG creates a Registry key entry with the same value. As each entry is translated, it appears in the Values being translated display area. If a Registry key entry already exists, INI2REG prompts you to overwrite it.
  6. To exit, choose the Exit button or File Exit.
Using the Command Line Interface

To access the INI2REG utility and translate an initialization file from the command line, specify the INI2REG command using the following syntax:

ini2reg { -a | -ao }  [ -i ini-file-name ]  [ -b base-key ] 
   [ -s subkey ] [ -d default-subkey ] 

-a

Automates the translation. That is, it processes the translation automatically without presenting the graphical user interface.

-ao

Automates the translation and automatically overwrites existing Registry entries.

-i ini-file-name

The pathname of the initialization file to translate.

-b base-key

The base key under which the subkey is created. The value of base-key must be one of following:

-s subkey

The subkey under which entries are created. The subkey is created under the base key specified in the -b parameter.

Use -d to specify a default subkey for the translation destination.

-d default-subkey

The default subkey under which entries are created. The default subkey is created under the base key specified in the -b parameter.

If the base key is HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER, INI2REG prepends “SOFTWARE” to the specified default subkey. If the initialization file name is not progress.ini, INI2REG appends the root name of the initialization file to the specified default subkey. If this parameter is not specified, INI2REG uses a default subkey of PSC\PROGRESS\version.

You can generalize this as follows:

base-key\[SOFTWARE]\default-subkey\[rootname] 

Use -s to specify a complete subkey for the translation destination.

By default, the INI2REG utility creates Registry key entries at the following location:

HKEY_CURRENT_USER\SOFTWARE\PSC\PROGRESS\version 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095