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.


