INI_OUTI: Copyright by Charles G. Hoppa INI_OUTI is an OS/2 INI file editor. This program will allow you to add, update, or delete OS/2 INI applications and keys. WARNING: WARNING this program changes data in your INI files. Remember to backup your INI files before using this program. Disclaimer: I make no representation or warranty with respect to the adequacy of this documentation or the programs which it describes for any particular purpose or with respect to its adequacy to produce any particular result. In no event shall I be liable for special, direct, indirect or consequential damages, losses, costs, charges, claims, demands, or claim for lost profits, fees or expenses of any nature or kind. Shareware: INI_OUTI is Shareware. If you find yourself using this program, please register it. Fill out INI_OUTI.REG and send it with $15.00 + $1.00 S&H to: Charles G. Hoppa 413 Falling Spring Court Reisterstown, MD 21136-1622 (Overseas orders, please make payments in US dollars, and include $5.00 for shipping.) When you register you will receive a registered version. The registered version allows the editing of data values up to 8192(8k) bytes in length. Requirements: The files needed to run this program are as follows: INI_OUTI.EXE - program INI_OUTI.TXT - help text INI_OUTI.ICO - icon VROBJ.DLL - VXREXX(1) DLL This program requires OS/2 2.0 with the service pack or a higher version of OS/2 and REXX installed on your machine. Limitations: You can only edit key entries up to a length of 2048(2K) bytes with the intro version or key entries up to a length of 8192(8K) bytes with the registered version. Installation: There are three methods of installing INI_OUTI on your machine. The first is to copy the INI_OUTI files(the EXE, ICO, and TXT) to an existing program directory and copy the VROBJ.DLL to a directory that is contained in the LIBPATH in your CONFIG.SYS file. The second method of installing INI_OUTI is to create a new directory and copy all the files into that directory. Then you will need to include this directory in the LIBPATH in your CONFIG.SYS file (requires you restart the PC for the changes to take affect). The third method is a combination of the first and second methods. Create a new directory and copy the INI_OUTI files to this new directory, then copy the VROBJ.DLL to an existing directory that is contained in the LIBPATH in your CONFIG.SYS file. Starting the application: After you have finished installing this product and restarted your PC to include any changes you made to the LIBPATH in your CONFIG.SYS, you can start the program from a command line. Open an OS/2 Window and make the current drive the drive you installed the INI_OUTI.EXE file onto. Change your directory to the directory where you installed the INI_OUTI.EXE file. Type 'INI_OUTI' and then press the 'ENTER' key. Menu: The menu bar contains two options "File" and "Help". The "File" option contains the two selections "Open an INI file" and "Exit." Use the first of these selections to open an OS/2 INI file for editing. This is a required selection. If you don't open a file for editing, you won't be able to do anything with the editor. The "Exit" selection ends the execution of the current edit session and returns to the operating system. The Help option contains the two selections "Help" and "About this product". The "Help" selection contains help information about the use of this product. The "About this product" displays release information about the version of the product you are currently running. Screen fields and Objects: Current INI file: Displays the name(including drive and path) of the OS/2 INI file you are currently editing. Application Name(s): This list box will display all the applications contained in the "Current INI File". In addition to the existing applications, the first entry "< ADD A NEW APPLICATION >' will allow you to add a new application name to the OS/2 INI file. You can scroll through the list of applications using the vertical scroll bar on the right side of the screen. To view all the keys for an application name, click on one of the current applications listed in the "Application Name(s)" list box. Key Name(s): This list box will display all the keys for the currently selected application contained in the "Current INI File". In addition to the existing keys, the first entry "< ADD A NEW KEY >' will allow you to add a new key, for the currently selected application, to the OS/2 INI file. You can scroll through the list of keys using the vertical scroll bar on the right side of the screen. To view the "Data Value" for the currently selected application and key combination, click on one of the current keys listed in the "Key Name(s)" list box. Display: The 'Display' group will allow you to change the data displayed in the 'Data Value' field from character('Char') to hexadecimal('Hex') and back again. Switching to hexadecimal will allow you to change the existing data to any value needed. This includes special characters or values you cannot produce by using the keyboard. Data Value: The 'Data Value' entry field displays the current data that is associated with a specific application and key combination. You can type over, insert, or delete the data anywhere in the existing 'Data Value' entry field. After editing the current 'Data Value', you can update the data by pushing the 'Update' push button and following the prompted instructions. You can reset the 'Data Value' field to the original value by pushing the 'Reset' push button. Sometimes the data for an application and key combination may contain an embedded NULL(hexadecimal 00), a new line(hexadecimal 0A), or a carriage return(hexadecimal 0D) character. The NULL character presents a problem for any entry field because only the data up to the first NULL character is displayed and the remaining data is truncated. If the current 'Display' option is 'Char', the program converts any embedded NULLS to periods('.'). Then the program changes the 'Data Value' to 'read only' to prevent you from editing the data while the 'Display' option is set to 'Char'. The background color of the 'Data Value' field is changed from cyan to pink. This will allow you to view your data in the 'Data Value' entry. You can change the 'Display' option to 'Hex' to edit a character string containing an embedded NULL character. The new line and the carriage return characters are control codes that affect the way your data is displayed. The new line and carriage return characters are treated in the same way as a NULL character. The program converts them to periods('.'). Then the program changes the 'Data Value' to 'read only' to prevent you from editing the data while the 'Display' option is set to 'Char'. The background color of the 'Data Value' field is changed from cyan to pink. This will allow you to view your data in the 'Data Value' entry. You can change the 'Display' option to 'Hex' to edit a character string containing either an embedded new line or carriage return character. If the current 'Data Value' does not contain any of the 3 special characters, the background color will stay cyan and you can edit the data from the keyboard. The only exception is when the length of the data value exceeds the maximum length of data allowed by this application(see the limitations section). If the length of the data value exceeds the maximum length of data allowed by the application, the background color will change to pink and you will not be allowed to edit the data. You can only view data up to the maximum length allowed by this application. Length: The length display field shows the current length of the data in the 'Data Value' entry field. Update: The 'Update' push button will allow you to change the data value of the current application and key combination. Enter your change in the 'Data Value' entry field, push this button,and follow the dialog prompts. Delete: The 'Delete' push button will allow you to delete a specific application and key combination or delete all the keys for an existing application. To delete an application and key combination, select the application and then select the key value you want to delete. Push this button and follow the dialog prompts. To delete all the keys for an application, select only the application value you want to delete. Push this button and follow the dialog prompts. Reset: The 'Reset' push button will allow you to return the data in the 'Data Value' entry field to its original value. Just press the 'Reset' button to remove any editing you have done on this field. The 'Reset' button will not return the data after a successful delete has been performed, and once a successful update is performed, the new data becomes the original value. You cannot back out a successful update. Add: The 'Add' push button will allow you to add a new key to an existing application or a new application and key combination. To add a new key to an existing application, select the application to which you want to add the key to in the 'Application Name(s)' list box. Then select the first entry in the 'Key Name(s)' list box(< ADD A NEW KEY >). Press this button and follow the dialog prompts. To add a new application and key combination, select the first entry in the 'Applications Names' list box(< ADD A NEW APPLICATION >). Press this button and follow the dialog prompts Trademarks: All registered trademarks contained or referenced in this documentation and program, whether notated or not, are the property of the owners of those registered trademarks. (1) VXREXX is a trademark of WATCOM International Corporation.