home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / AHATCH22.ZIP / AHATCH.DOC < prev   
Text File  |  1992-12-22  |  8KB  |  178 lines
  1.  
  2.                            - AHATCH version 2.2 -
  3.  
  4.                   ┌──────────────────────────────────────┐
  5.                   │              ╔════════╗              │
  6.                   │              ║ AHATCH ║              │
  7.                   │              ╚════════╝              │
  8.                   │    - Automated Hatch procedure -     │
  9.                   │                                      │
  10.                   │     Version 2.2, December 22 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.                              V                │
  29.           AHATCH ─┬─ area ─┬───┬────────────┬─┴─┬───────┬─┬──────┬─┤
  30.                   └─ /A ───┘   ├── /Ccfg ───┤   └ drive ┘ └ path ┘
  31.                                ├── /Ttmp ───┤
  32.                                ├── /Bfbbs ──┤
  33.                                ├── /Ddup ───┤
  34.                                ├── /R ──────┤
  35.                                └── /Ffile ──┘
  36.        Where:
  37.        area     = Tick area name
  38.        /A       = Hatch the  file  in an  alternate  area,  check  for
  39.                   [A:area]  at te  beginning of the  description (must
  40.                   precede [R:file]  if used),  when not used  [A:area]
  41.                   will remain in the description
  42.        /Ccfg    = the name and location  of the Tick/Hatch config file
  43.                   default will  be that of Hatch itself  (current dir)
  44.        /Ttmp    = the name and  location of the temporary  ahatch file
  45.                   default will be AHATCH.TMP in the current dir
  46.        /Bfbbs   = the name of FILES.BBS, located in drive/path
  47.        /Ddup    = file   containing    already   released   filenames;
  48.                   dupcheck will not include  file extension unless the
  49.                   extension contains a (sequence-)number
  50.        /Ffile   = one file to hatch from FILES.BBS (no path)
  51.        /R       = use the  Hatch  replace  file  function,  check  for
  52.                   [R:file]  at the beginning of the description (after
  53.                   [A:area]), when not used description is not changed
  54.        drive    = drive  where  file  and  FILES.BBS  resides (default
  55.                   current drive)
  56.        path     = directory  path  where  file  and  FILES.BBS resides
  57.                   (default current path)
  58.  
  59.                                  - page 1 -
  60.  
  61.                            - AHATCH version 2.2 -
  62.  
  63.        AHATCH will  hatch all  files that exist in the  the current or
  64.        defined  directory  and  those that are named in the  FILES.BBS
  65.        (which  resides  in the  same  directory).   Files  will not be
  66.        hatched  if they  already exist  in the hatch  target directory
  67.        (specified  in  the  Tick  configuration  file),   AHATCH  will
  68.        disregard the  file extension except  when a number is found in
  69.        the extension of the hatchfile.
  70.        So: FILE1.ZIP is not hatched if  FILE1.ARC or FILE1.123 exists,
  71.            FILE1.A03 is always hatched except when FILE1.A03 exists.
  72.  
  73.        When a dupfile is given,  AHATCH will also look in the dupfile
  74.        in the same way  for duplicate filenames.  The filename in the
  75.        dupfile must be the first one mentioned, so allowed is:
  76.  
  77.        FILE1.ZIP
  78.        FILE2.A39 E43232F6
  79.        FILE3
  80.        FILE4.ABC [R:FILE4.OLD] File discriptions may be here too.
  81.  
  82.        A hatched file will be moved from  the directory where the file
  83.        was found  to  the directory  of the  Tick area,  so  next time
  84.        AHATCH will not hatch the file again.
  85.  
  86.        Descriptions may  be up to 255  characters long.  AHATCH uses a
  87.        temporary file to do this (AHATCH.TMP)  which is created in the
  88.        directory where  AHATCH is started,  to change the filename and
  89.        location, use the /T parameter.
  90.  
  91.        Example (started from the TICK directory):
  92.           AHATCH OS2NEW /DDUPS\OS2NEW.DUP /R C:\FILE\FERNUP
  93.  
  94.        Will release all files in C:\FILE\FERNUP into area OS2NEW.
  95.        Filenames  that  are  found  in the  OS2NEW.DUP  file  are  not
  96.        hatched,  just like files  that already exists  the the  OS2NEW
  97.        target directory (specified in TIC.CFG). Also when AHATCH finds
  98.        [R:<filename>]  at  the  beginning  of  the   description,  the
  99.        <filename> will be passed on to Hatch as the replace file.  The
  100.        [R:<filename>] part will be stripped from the description (only
  101.        when /R option is used!).
  102.  
  103.        To release just one file just enter:
  104.           AHATCH OS2NEW /DDUPS\OS2NEW.DUP /FTHISONE.TXT C:\FILE\FERNUP
  105.  
  106.        To start AHATCH from the (in this example) FERNUP directory:
  107.           AHATCH OS2NEW /CC:\TICK\TIC.CFG /DDUPS\OS2NEW.DUP
  108.  
  109.        To make the location of the  Tick configuration file permanent,
  110.        it is possible to edit AHATCH.CMD  and put a full path in front
  111.        of the confdef filename, so using /C is not necessary anymore.
  112.  
  113.        In this case the line:
  114.          confdef   = "TIC.CFG"         /* Hatch default config file */
  115.        has to be changed to:
  116.          confdef   = "C:\TICK\TIC.CFG" /* Hatch default config file */
  117.  
  118.                                  - page 2 -
  119.  
  120.                            - AHATCH version 2.2 -
  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
  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.        Contact the author when used in commercial environments.
  137.        Use AHATCH at your  own risk only,  the author can not  be held
  138.        responsible for any damages.
  139.  
  140.        Please let me know if I should take the time to develop  AHATCH
  141.        any further.  If you have any  suggestions or comments,  please
  142.        enter or send a message to:
  143.  
  144.                    Marcel Stikkelman
  145.          Sysop of: PC-Square, BBS of the PCPC
  146.                    Zoetermeer
  147.                    the Netherlands
  148.                    Tel.: <INT>31-79-424107
  149.                    FidoNet address 2:512/4
  150.                                    81:431/5
  151.  
  152.                    or in an  appropriate echomail area if  the message
  153.                    is  useful to other users and where  you can find a
  154.                    message from me.
  155.  
  156.        AHATCH  is free to use in  non-commercial environments, but  if
  157.        someone  still has the urge to make a contribution feel free to
  158.        do so:
  159.  
  160.                    M. Stikkelman
  161.                    ABN-AMRO bank-account-number 47.35.94.412
  162.                    or GIRO 5152402
  163.                    Zoetermeer
  164.                    the Netherlands.
  165.  
  166.  
  167.        UPDATE HISTORY
  168.        ==============
  169.  
  170.        Version   Date   Changes
  171.        ------- -------- --------------------------------
  172.          2.0   05-05-92 first general release
  173.          2.1   10-16-92 added replace /R function
  174.          2.2   12-22-92 added replace /A function
  175.  
  176.  
  177.                                  - page 3 -
  178.