=== NOTES ON CHECKINI.EXE ===


CHECKINI checks for, and optionally corrects, some problems in OS2.INI and
OS2SYS.INI. CHECKINI only looks at information regarding the workplace
shell. 

CHECKINI is NOT yet complete ! 

I allow you to use and distribute CHECKINI freely under the condition that I
am in no way responsible for any damage or loss you may suffer.


WARNING 1

if you are normally connected to a network and run CHECKINI when you are NOT
connected to this network, or when you are not logged in, CHECKINI will
report errors for references to network objects.
In the situation mentioned above and with the /C swith given, take care 
when confirming deleting or correcting problems.

WARNING 2

Whenever you run CHECKINI with the /C switch you must be prepared to
shutdown immidiatly after you have run the program. This because the
workplace shell has a lot of info in memory and it you keep on working
some of the changes checkini has made will be overwritten by the desktop.

WARNING 3

I do not know it all. The PM_Workplace:Handles record in the ini contains
some information I do not understand (yet). Still I decided on my own PC to
delete several lumbs of information in the record. I have done so several
times without any problems.


If you have any remarks concerning to this program send them to me at DEVNET
or send netmail to Jaap Geluk at 2:512/47.336@fidonet.org or leave a
message at Chat BBS (2:512/47) +31-75-704045 for Jaap Geluk.


Henk Kelder


USING CHECKINI

From an OS/2 command prompt enter the command CHECKINI. Without any command
line options CHECKINI doesn't change anything to your ini-files.

COMMAND LINE OPTIONS

/C            - Write corrections to ini-files. The default is to diagnose
                only. If this option is specified the program will ask
                confirmations for all changes it may want to do in your
                ini-files.

/APath        - Specify different location for ini-files to be checked. This
                option is usefull if you have a copy of you ini files and
                you would like these copies to be checked.

/Llogfilename - specify name of logfile. The default is CHECKINI.LOG in the
                directory you start the program in.

/W            - Write all output to logfile. Normally only problems are
                written to the logfile.

/S            - 'Silent run', only write logfile. Normally found errors are
                reported directly.

/?            - Show info.




HOW THE PROGRAM WORKS

While running CHECKINI displays all found information on the screen.
Whenever a problem is found, and the /S switch is not used the program
reports the problem. The problem itself is visible in the bottom lines
of the screen. Problems are always reported in CAPITALS.

some examples:

=================================================
 PM_Workplace:Handles:BLOCK1                   
=================================================
3E2DA:CHECKINI.EXE   =>E:\ICON\CHECKINI.EXE<-DOES NOT EXIST
395F8:COPYINI.EXE    =>E:\ICON\COPYINI.EXE<-DOES NOT EXIST
39400:GETPROG.EXE    =>E:\ICON\GETPROG.EXE<-DOES NOT EXIST
=================================================
 PM_Abstract:Objects & PM_Abstract:FldrContents
=================================================
  Object 13087, Class WPNetLink : A network folder
   Linked to: \\SERVER09\SYS3\DIRECTORY1<-DOES NOT EXIST!
  Object 140AD, Class WPNetLink : SYS3
   Linked to: \\SERVER09\SYS3<-DOES NOT EXIST!
  Object 15185, Class WPNetLink : SYS1
   Linked to: \\SERVER09\SYS1<-DOES NOT EXIST!
  Object 15956, Class WPNetLink : A network folder
   Linked to: \\SERVER09\SYS3\DIRECTORY1<-DOES NOT EXIST!
=================================================
 Checking AssocCheckSum                          
=================================================
PMWP_ASSOC_CHECKSUM:252153
  points to 3D8F9 - E:\ICON\GETBLOCK.EXE<-DOES NOT EXIST
=================================================
 Checking FolderPos                              
=================================================
PM_Workplace:FolderPos:252223@10
  points to 3D93F - OBJECT DOES NOT EXIST


WHAT THE PROGRAM CHECKS

The following ini-records (Application - Key) are checked:


PM_Workplace:Handles    - BLOCK1 
  (Checks consistency and existence of filesystem object-handles)

PM_Workplace:Location   - (all keys)
  (Checks existence of object where id-strings like <WP_DESKTOP> point to)

PM_Workplace:Folderpos  - (all keys)
  (Checks for obsolete saved object positions)

PM_Workplace:Templates  - (all keys)
  (Checks for template-records that refer to non-existing objects)

PM_Abstract:Objects     - (all keys)
  (Mainly checks WPProgram objects for consistency, but also checks for
  'lost-objects' - objects moved to non-existing locations. Also checks
  WPNetLink and WPShadow links.)

PM_Abstract:FldrContent - (all keys)
  (Used for the check mentioned above for 'lost-objects')      

PM_Abstract:Icons       - (all keys)
  (Checks for obsolete icons, icons for abstract objects that do not exist)

PMWP_ASSOC_FILTER       - (all keys)
  (Checks for associations with non-existing objects)

PMWP_ASSOC_TYPE         - (all keys)
  (Checks for associations with non-existing objects)

PMWP_ASSOC_CHECKSUM     - (all keys)
  (Checks for obsolete checksum record that point to non-existing objects)