═══ 1. Introduction ═══ The IniCnv application will read program definitions that have been created in OS2 1.x style INI files and make OS2 2.0 program folders and references. IniCnv is a ShareWare program. Please see the registration topic. You must specify the source of the INI information by using the File pulldown menu. You may, then, use three dropdown combination list boxes to examine 1.x program definitions and select them for conversion. Use the push buttons that are located at the bottom of the IniCnv window to control the selection and conversion processes. OS2 2.0 is still very new. Some restrictions apply to this utility. ═══ 1.1. INI Files ═══ Initialization (INI) files are created by applications and the system. The primary system INI file is called OS2.INI and normally resides in the OS2 system directory. When you created program definintions and program groups under OS2 version 1.2 and 1.3, records were created in the system INI file that held the information that you entered. IniCnv can read these records and use that information to create OS2 2.0 folders and program reference icons. Other programs may have also created INI files that contain program and group records. One such program is IniUtil. Files created by IniUtil can also be used as input to IniCnv. ═══ 1.2. Examining Program Info ═══ The client area of the IniCnv application window will display several different items of information: Root Folder Always NFDC SubFolder Name taken from the 1.x group box. Will be the folder that is created in the NFDC root folder, if you press the convert button. Groups List of groups from the INI Program Titles Definition titles found in groups Selected Titles Titles that you have selected and which will be converted if you press the convert button. Program Type Appears under the group list box. If the program was defined with NoAutoClose, that will also appear. ExeName The executeable pathname Parameters The defined parms for the program StartupDir The directory path that will be made current before the is invoked. The program information displayed is that for the title currently displayed in either the Program Titles or Selected Titles combination list box, whichever had the input focus last. If an icon was defined for the program entry, it will also be used to create the 2.0 program reference. The icon path, however, will not be displayed in IniCnv's client area. ═══ 1.3. Title Selection ═══ When the Program Titles drop down combination list box has the input focus, the Select and SelectAll buttons will be enabled. Press the Select button to remove the highlighted title from the Program list and add it to the Selected list. Press the SelectAll button to move all of the Program Title entries to the Selected Titles list. When the Selected Titles drop down combination list box has the input focus, the Deselect button will be enabled. Press the Deselect button to remove the highlighted title from the Selected Title list and return it to the Progam Title list. ═══ 1.4. Conversion Processing ═══ When you press the Convert button, any program definition that was placed in the Selected Title combination list box during the selection process will be converted. A folder will be created with the name NFDC and be placed on the desktop, if it does not already exist. A subfolder will be created within this root folder and be named using the associated 1.x group box name. Finally, program references will be created for selected titles. At the time of this writing, restrictions apply to the conversion process. ═══ 1.5. Process Restrictions ═══ Icons do not immediately appear. For some strange reason, icons will appear only after you next reboot. However, you may move folders and program references to new locations and otherwise rearrange things without causing any harm. This utility must run under OS2 2.0 at beta level 6.304 or above. The OS2 2.0 system must have be installed in an HPFS partition. The OS2 2.0 desktop must be actively using the directory Desktop on the installed partition. ═══ 1.6. Registration ═══ SUPPORT SHAREWARE I hope you find this utility helpful, but (here comes the disclaimer) I am in no way responsible for any damages the use of this utility may cause. You are free to use this utility at your own risk with no obligation to me, the author, for only a short period of time. This utility includes a registration throttle that allows only 5 program references to be converted in a single execution. When you register IniCnv, this throttle will be removed. If IniCnv is helpful to you or your organization, you should register it. The registration fee for individuals is $15 (US). The site registration fee for corporate entities is $150 (US). Please send registration fees along with a daytime phone number to: Dave Lester PO Box 461 New Freedom, PA. 17349 USA Comments, suggestions and bug reports may be submitted through CIS Mail ID 75600,237. These will be answered on a "best effort" basis. ═══ 2. File Action Bar Item ═══ The File pull down menu item displays the following selections: Open Open and INI file Hini_Userprofile Use system INI info Exit Quit the utility ═══ 2.1. Open Action ═══ The Open selection will invoke the system default open file dialog for files that end with a ".ini" suffix. Use the drive and directory list boxes to navigate to the location of your INI input file. Select the INI file that you wish to process and press the OK button. You may not select the OS2.INI file that is in use by your system. ═══ 2.2. Hini_Userprofile Action ═══ When you select the Hini_Userprofile action item, the IniCnv utility will search your existing system definitions for 1.x style program definitions. Since OS 2.0 is relatively new, many installation programs still create the "old" style group and program definitions. IniCnv allows you to convert these entries too. Once the items are converted, you may safely delete the old group boxes. The name HINI_USERPROFILE is used by the system to access the OS2.INI file. I didn't make up that name and am not referencing any person or thing's posterior. ═══ 2.3. Exit Action ═══ You may select Exit to terminate the IniCnv utility. ═══ 3. GroupNames ComboBox ═══ The Groupnames drop down combination list box will display the title of each 1.x group entry that was found in the INI file that you opened for processing. When you select a Groupname list item, any title previously placed in the Selected Titles list is removed and the contents of the Program Titles list is replaced with titles found in the newly selected group. You may then examine information about each of the Program Titles and begin the selection process. ═══ 4. ProgramTitles ComboBox ═══ For each program defined in the selected Groupname, a title will be placed in the Program Titles list. If the Program Tiles list has the input focus, the information displayed in IniCnv's client area will reflect the currently selected item. The Select button will also be enabled so that the currently selected title may be transfered to the Selected Titles list for conversion processing. ═══ 5. Selected Titles ComboBox ═══ Each title removed from the Program Titles list will be placed in the Selected Titles list. If the Selected Tiles list has the input focus, the information displayed in IniCnv's client area will reflect the currently selected item. The Deselect button will be enabled so that the currently selected title may be returned to the Program Titles list. The Convert button will also be enabled so that conversion processing can be initiated. ═══ 6. Keys Help ═══ The list of keys is arranged in groups. ACCELERATOR KEYS Ctrl+o Open an INI file F3 Exit program Program Details Environment Edit Keys ALT-Insert Add contents of Combo Edit Box to Environment List ALT-Delete Delete contents of Combo Edit Box from Environment List HELP KEYS F1 Get help F2 Get extended help (from within any help window) Alt+F4 End help F9 Go to a list of keys (from within any help window) F11 Go to the help index (from within any help window) Esc Previous Help Panel, or End help if only one panel Alt+F6 Go to/from help and programs Shift+F10 Get help for help SYSTEM KEYS Alt+F6 Switch to the next windowed program Alt+Esc Switch to the next program, including full-screen programs Ctrl+Esc Switch to the Task List WINDOW KEYS F3 Close a window F10 Go to/from the action bar Arrow keys Move among choices End Go to the last choice in a pull-down Esc Cancel a pull-down or the system menu Home Go to the first choice in a pull-down PgUp Scroll the contents of the window up one page PgDn Scroll the contents of the window down one page Underlined letter Move among the choices on the action bar and pull-downs Alt+F10 Go to/from the action bar Alt+F4 or F3 Close the window Alt+F5 Restore the window Alt+F7 Move the window Alt+F8 Size the window Alt+F9 Minimize the window Alt+F10 Maximize the window Ctrl+PgDn or Shift+F8 Scroll the contents of the window right one page Ctrl+PgUp or Shift+F7 Scroll the contents of the window left one page Shift+Esc or Alt+Spacebar Go to/from the system menu Shift+Esc or Alt Go to/from the system menu of a text window