HATCH

HATCH is an external hatching utility. HATCH does not actually "hatch" files, rather, it creates a fake .TIC file, in your inbound directory that tells ALLFIX which files it should hatch.

HATCH has two modes: commandline mode and interactive mode.

Command line mode

The command line mode offers the ability hatch files from the dos prompt or in batch files.

Usage: HATCH Area [areaname] File [filename.ext] Desc [description] Replace [filename.ext] Magic [magic name][Copy]

Commands:

Area
[areaname] must be a valid fileecho tag. This command must always be used.

Desc
[description] is the description of the file to be hatched. Enclose the description in quotes if it is contains more than one word. If this command is not used, then HATCH will attempt to take the description from the file database. The Fdb command must be used if the BBS system does not make use of the standard FILES.BBS files.

File
[filename.ext] must be a filename or file specification. Paths may be included. This command must always be used. If a file specification is used, then HATCH will attempt to take the description from the file database. The Fdb command must be used if the BBS system does not make use of the standard FILES.BBS files.

Replace
[filename.ext] is the file specification that this new file should replace.

Magic
[magic name] is the magic name ALLFIX should update in the alias file.

Release
[dd-mm-yy] is the date on which a file should be released. All systems, that have the prerelease switch turned on in this fileecho will receive the file immediately. Systems that do not have that switch turned on, will receive the file on the date entered in this field.

[Copy]
This optional command tells ALLFIX to copy the file to the destination directory instead of moving it.

Example:
HATCH Area ALLFIX File AFIX_430.ZIP Desc "This is the latest release of ALLFIX"
HATCH Area PDNPASCAL File \PASCAL\TP*.* Release 01-02-1996

Interactive mode

The interactive mode presents the user with a menu from which files can be hatched.
The following keys are available in interactive mode:

ESC,F10
Exit and hatch the file.

F9
Abort the hatching the file.

The following is a description of the fields.

Area
The fileecho that this file needs to be hatched into.

File
The file that needs to be hatched.

Copy
This optional command tells ALLFIX to copy the file to the destination directory instead of moving it.

Desc
The description of this file. HATCH will automatically try to read the file description from the file database, when a file name is entered in the File field. The imported description can be edited or replaced.

Magic
The magic name for this file, which will be added to the alias file.

Replace
The filespec that this file should replace.

Release
The date the file should be released. All systems, that have the prerelease switch turned on in this fileecho will receive the file immediately. Systems that do not have that switch turned on, will receive the file on the date entered in this field.

There is an added ability to fill some of the fields with values from the command line. This option is very handy for people who use FEBBS or similar programs. FEBBS can call up HATCH and pass along the filename and description. Those two fields will be filled in and all the user needs to fill in is the Area field and possibly a few other fields. In order to use this feature, simply add the commandline options, explained in the previous section to the commandline. If the "Area" command is used the file will automatically be hatched if the "File" command is also used. Therefore, use all of the commands except the "Area" command, or use all of the commands except the 'File'.

Example: HATCH File TEST.ZIP Desc "Testing the external Hatch program"

In this example, HATCH will jump to interactive mode, with the file and description fields already filled in.