home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / AHATCH20.ZIP / AHATCH.DOC < prev    next >
Encoding:
Text File  |  1992-05-16  |  6.7 KB  |  178 lines
  1.  
  2.                            - AHATCH version 2.0 -
  3.  
  4.                   ┌──────────────────────────────────────┐
  5.                   │              ╔════════╗              │
  6.                   │              ║ AHATCH ║              │
  7.                   │              ╚════════╝              │
  8.                   │    - Automated Hatch procedure -     │
  9.                   │                                      │
  10.                   │       Version 2.0, May 16 1992       │
  11.                   │                                      │
  12.                   │         by Marcel Stikkelman         │
  13.                   │                                      │
  14.                   └──────────────────────────────────────┘
  15.  
  16.        AHATCH
  17.        ======
  18.  
  19.        AHATCH provides  an  easy and fast way  to hatch  (Tick release
  20.        utility)  a number of  files from a  FILES.BBS file into a Tick
  21.        area.  Since  AHATCH  is  an  OS/2  REXX  procedure  source  is
  22.        provided.
  23.  
  24.  
  25.        USAGE
  26.        =====
  27.  
  28.                          ┌────────────────┐
  29.                          V                │
  30.           AHATCH ─ area ───┬────────────┬─┴─┬───────┬─┬──────┬─┤
  31.                            ├── /Ccfg ───┤   └ drive ┘ └ path ┘
  32.                            ├── /Ttmp ───┤
  33.                            ├── /Bfbbs ──┤
  34.                            ├── /Ddup ───┤
  35.                            └── /Ffile ──┘
  36.  
  37.        Where:
  38.        area     = Tick area name
  39.        /Ccfg    = the name and location  of the Tick/Hatch config file
  40.                   default will  be that of Hatch itself  (current dir)
  41.        /Ttmp    = the name and  location of the temporary  ahatch file
  42.                   default will be AHATCH.TMP in the current dir
  43.        /Bfbbs   = the name of FILES.BBS, located in drive/path
  44.        /Ddup    = file   containing    already   released   filenames;
  45.                   dupcheck will not include  file extension unless the
  46.                   extension contains a (sequence-)number
  47.        /Ffile   = one file to hatch from FILES.BBS (no path)
  48.        drive    = drive  where  file  and  FILES.BBS  resides (default
  49.                   current drive)
  50.        path     = directory  path  where  file  and  FILES.BBS resides
  51.                   (default current path)
  52.  
  53.        AHATCH will  hatch all  files that exist in the  the current or
  54.        defined  directory  and  those that are named in the  FILES.BBS
  55.        (which  resides  in the  same  directory).   Files  will not be
  56.        hatched  if they  already exist  in the hatch  target directory
  57.        (specified  in  the  Tick  configuration  file),   AHATCH  will
  58.  
  59.                                  - page 1 -
  60.  
  61.                            - AHATCH version 2.0 -
  62.  
  63.        disregard the  file extension except  when a number is found in
  64.        the extension of the hatchfile.
  65.        So: FILE1.ZIP is not hatched if  FILE1.ARC or FILE1.123 exists,
  66.            FILE1.A03 is always hatched except when FILE1.A03 exists.
  67.  
  68.        When a dupfile is given,  AHATCH will also look in the dupfile
  69.        in the same way  for duplicate filenames.  The filename in the
  70.        dupfile must be the first one mentioned, so allowed is:
  71.  
  72.        FILE1.ZIP
  73.        FILE2.A39 E43232F6
  74.        FILE3
  75.        FILE4.ABC File discriptions may be here too.
  76.  
  77.        A hatched file will be moved from  the directory where the file
  78.        was found  to  the directory  of the  Tick area,  so  next time
  79.        AHATCH will not hatch the file again.
  80.  
  81.        Descriptions may  be up to 255  characters long.  AHATCH uses a
  82.        temporary file to do this (AHATCH.TMP)  which is created in the
  83.        directory where  AHATCH is started,  to change the filename and
  84.        location, use the /T parameter.
  85.  
  86.  
  87.        Example (started from the TICK directory):
  88.  
  89.           AHATCH OS2NEW /DDUPS\OS2NEW.DUP C:\FILE\FERNUP
  90.  
  91.        Will release all files in C:\FILE\FERNUP into area OS2NEW.
  92.        Filenames  that  are  found  in the  OS2NEW.DUP  file  are  not
  93.        hatched,  just like files  that already exists  the the  OS2NEW
  94.        target directory (specified in TIC.CFG).
  95.  
  96.        To release just one file just enter:
  97.  
  98.           AHATCH OS2NEW /DDUPS\OS2NEW.DUP /FTHISONE.TXT C:\FILE\FERNUP
  99.  
  100.        To start AHATCH from the (in this example) FERNUP directory:
  101.  
  102.           AHATCH OS2NEW /CC:\TICK\TIC.CFG /DDUPS\OS2NEW.DUP
  103.  
  104.        To make the location of the  Tick configuration file permanent,
  105.        it is possible to edit AHATCH.CMD  and put a full path in front
  106.        of the confdef filename, so the /C parameter does not has to be
  107.        entered every time.
  108.  
  109.        in this case the line:
  110.          confdef   = "TIC.CFG"         /* Hatch default config file */
  111.        has to be changed to:
  112.          confdef   = "C:\TICK\TIC.CFG" /* Hatch default config file */
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                  - page 2 -
  119.  
  120.                            - AHATCH version 2.0 -
  121.  
  122.        SYSTEM REQUIREMENTS
  123.        ===================
  124.  
  125.        AHATCH has been tested on a IBM-PS/2 model 80 with OS/2 1.3.
  126.        It will probably work on most systems that run OS/2 version 1.2
  127.        (EE) and up with  REXX installed.  AHATCH calls  HATCHP.EXE and
  128.        works with Hatch version 2.10 and 2.04beta
  129.  
  130.  
  131.        NOTICE
  132.        ======
  133.  
  134.        AHATCH  may  be  distributed  and  used  unmodified  with  this
  135.        documentation in non-commercial environments free of charge.
  136.        Use AHATCH at your  own risk only,  the author can not  be held
  137.        responsible for any damages.
  138.  
  139.        Please let me know if I should take the time to develop  AHATCH
  140.        any further.  If you have any  suggestions or comments,  please
  141.        enter or send a message to:
  142.  
  143.                    Marcel Stikkelman
  144.          Sysop of: PC-Square, BBS of the PCPC within PCC-net
  145.                    Zoetermeer
  146.                    the Netherlands
  147.                    Tel.: <INT>31-79-424107
  148.                    FidoNet address 2:512/4
  149.  
  150.                    or in an  appropriate echomail area if  the message
  151.                    is  useful to other users and where  you can find a
  152.                    message from me.
  153.  
  154.        AHATCH  is free to use in  non-commercial environments, but  if
  155.        someone  still has the urge to make a contribution feel free to
  156.        do so:
  157.  
  158.                    M. Stikkelman
  159.                    ABN-AMRO bank-account-number 47.35.94.412
  160.                    or GIRO 5152402
  161.                    Zoetermeer
  162.                    the Netherlands.
  163.  
  164.  
  165.        UPDATE HISTORY
  166.        ==============
  167.  
  168.        Version   Date   Changes
  169.        ------- -------- --------------------------------
  170.          2.0   05-05-92 first general release
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                  - page 3 -
  178.