========================================================================

AdeptHatch
A file hatching program for AdeptXBBS
Copyright (c) 1997 by Doug Kushner

========================================================================
AdeptHatch is freeware!  

Disclaimer:

This software has been tested extensively on my system and appears to be 
functioning as designed.  Your mileage may vary.  Back up your Adept 
configuration files!  The author of AdeptHatch will NOT accept 
responsibility for any abnormal behavior of this program. 


Features:

 - Hatch files to all downlinks.
 - Auto-configuration.


Installation:

The archive file contains EA's.  Use Info-ZIP's Unzip to extract into
a temporary directory.  Run AHINST.CMD, which will place all of the 
AdeptHatch files into the specified directory and create a program 
object in the Adept folder or Desktop. Insure that the current 
directory (".") is in the LIBPATH, or move ADPHATCH.DLL to a directory 
in the LIBPATH.

AdeptHatch has been designed to use Watcom's VROBJ.DLL (v2.14, from VX-
REXX v 2.1d), which is not included in this release.  It should be 
available on most OS/2 BBS's as well as on hobbes.nmsu.edu.


Initial setup:

 - Time Zone (TZ= ) must be defined in CONFIG.SYS.
 - The HOLD directory must be defined in gatekpr.ctl.
 - Tic file areas must be configured in file.control.
 - \adept\system\addresses should contain valid 5-D addresses. 


AdeptHatch setup:

The first time AdeptHatch is run, gatekpr.ctl and file.control are 
parsed and AdeptHatch will attempt to auto-configure itself.  At this 
time the setup window will appear and the user can customize the 
configuration.  

Path names should be entered without a trailing backslash.  When adding 
new origins, keep in mind that the addresses must be 5-D 
(Zone:Net/Node.Point@Domain) and a zone can only have one origin address.

Select OK to save the configuration.


Hatching a file is a simple process:

 - Select a file area from the drop-down listbox.  The area selected 
   must have downlinks defined.  When you tab out or mouse out of this
   field, AdeptHatch will attempt to populate the origin field with a 
   value from the origin listbox.

 - If the origin field is blank, choose the origin from the list.
 
 - Enter the file to be hatched by either typing the full path and file 
   name into the File field, or by selecting the File button and using 
   the Select File dialog box. 

 - Enter a filename in the Replaces field if desired.

 - Enter a Magic Name in the Magic field if desired.  NOTE: Gatekpr 
   doesn't support the Magic keyword at this time.

 - Enter the file description.  Text can be pasted into this window with 
   Ctrl-Ins.

 - Click on the Hatch button to invoke the process.


If it doesn't work:

 - Error message "No Downlinks":  Are the RWCHND flags in file.control 
   in uppercase?

 - Error message "Cannot CRC file": Is the file locked by another 
   program?

 - Do you have the correct version of vrobj.dll?  Select the "About" 
   button of AdeptHatch.  The version of vrobj.dll should be 2.14 or 
   greater.

AdeptHatch files:

   ADPHATCH.EXE      Main program
   ADPHATCH.DLL      Contains the CRC32 and GMT time routines.
   ADPHATCH.TXT      This file.
   ADPHATCH.INI      Created by AdeptHatch.  Contains the saved 
                     configuration.
   ADPHATCH.LOG      Created by AdeptHatch.  Contains a running 
                     log of hatching activity.


Known bugs:

 - The Description MLE does not refresh consistently.  This seems to be 
   a VX-REXX problem. Ideas anyone?


Future enhancements:

 - Hatching the file locally, which will include moving the file into 
   the local area and adding the file and description to Adept's
   filebase.

 - Adding AKA's to the list of seen-bys.

 - Importing the description from file_id.diz or the filebase.

 - Find a better icon :)


Obtaining AdeptHatch:

The latest version will always be available via ftp at adeptsoft.com or 
it can be freq'd from the author's BBS with the magic name ADPHATCH.
The latest VROBJ.DLL can be obtained with the magic name VROBJ.


To contact the author:

Please send all bug reports, suggestions or whatever to any of the 
following addresses:

   1:300/407@Fidonet
   dougk@primenet.com

========================================================================
