                CLRFIDO/CLRFIDO2.EXE Documentation
                   (c) 1996 - Herbert Bushong

    PCBoard has a bad habit of accumulating Failed connects in
the Fido queue. Once maxed out, they remain for all packets until
they are all sent. What's worse, it places these entries on HOLD,
reducing the chance of them being sent. This has many times caused
me headaches with polls not calling and packets building up.

    This utility solves that problem by scanning the FIDOQUE.DAT
file, resetting all failed connects to 0, and changing any entries
that it resets to NORMAL if their status is HOLD. 

Both a DOS and an OS/2 EXE are included and each work identically.
NOTE: This utility will work woth PCB 15.22 to 15.30. Future versions
of PCBoard may or may not be compatible. As long as the structure doesn't
change, it will work.


INSTALLATION

    Extract the files to a directory. If you want to be able to call the
    utility from anywhere, place it in your PATH. Alternately, you can call
    it with a fully-qualified path name.

    To automate the process, create one or more events that call
    the utility (see syntax).


SYNTAX
  (note: CLRFIDO2.EXE has the same syntax)

   CLRFIDO [path]

   If no Path is given, the utility looks for the file FIDOQUE.DAT
   in the current directory. To check a different directory, pass
   the path ONLY, including the trailing backslash, like so:

   CLRFIDO d:\path\


    for a brief help screen, type:

    CLRFIDO -?


ERRORLEVELS

    The utility will return an errorlevel to the operating system
    dependent upon success or failure. The levels are as follows:

    0   - Success, normal termination
    1   - FIDOQUE.DAT not found
    2   - File locked by another process, unable to open
    10  - Seek Error

Troubleshooting the errorlevels
    1   - Check the path you gave (especially the trailing backslash)
          or be sure you are in the same directory as the FIDOQUE.DAT
          if no path was given.

    2   - PCBoard probably had the file locked. The utility will try
          to open the queue 10 times with 1 second intervals between
          attempts. It will then exit with this errorlevel.
          You should *rarely* if ever see this errorlevel.

    You should never get an errorlevel of 10 unless you have a 
    corrupted FIDOQUE.DAT. If you do, send my a copy of the file
    before any other changes take place if you want me to look at it.


Support

author: Herbert Bushong

I can be reached via the following methods:

Internet e-mail:   harchon@centuryinter.net
Fidonet        :   Herbert Bushong@1:19/19
Support BBS    :   318-468-3385   (except 2a-6a CST)
Intelec  Confs :   CDCSupport, IS_Support, Sysops, etc...


