TAGFILE v1.60     by Tom Hansen, SysOp      Church Chatters (tm) BBS

------------------------------------------------------------------------------
                  TAGFILE a utility for BATCH uploading.
------------------------------------------------------------------------------
Files included in this archive include:

TAGFILE.EXE : Main control program.
DIRN.EXE    : File Tagging utility called by TAGFILE.EXE.  This may be run
              independantly of TAGFILE.EXE
DGS.DEF     : Sample configuration file.
TAGFILE.TXT : This document.
ID.BAT      : Batch file for processing DIZ ( prepared descriptions ) files.
TAGFILE.SLT : Salt file for compiling macro script for TELIX
TAGFILE.SLC : Compiled TAGFILE.SLT script.
DESC.SDI    : Desctripion of Program for BBS posting ( inserted by TAGFILE )
UPDATE.DOC  : Updates  TAGFILE Documentation re: Bug fixes and enhancements.


                   ------[ Setup:  How to do it! ]------


1.) Edit DGS.DEF to match your system.  Be sure the executable files are
    either in your path or your current subdirectory. ( Executable programs
    called by TAGFILE are DSZ.COM( or DSZ.EXE), HSLINK.EXE, BIMODEM.COM and
    DIRN.EXE ).  User defined programs are the editor (Line 10 of DGS.DEF)
    and the optional protocol ( Lines 8 and 9 of DGS.DEF).  The editor is
    menu selection E ( used in various other functions as well ) and the user
    defined protocol is menu selection M.  The descritpion on line 9 for menu
    selection M should be no longer than 21 chars.

 DGS.DEF outline   :

Line  1: test.lst          <- Name of file listing tagged files (No Path needed);
Line  2: handshake both sz <- DSZ Command line (Zmodem);  Tagfile will pass
                              your port number and speed as to DSZ.COM or to
                              DSZ.EXE ( see line 12 ) and the tagged files.
Line  3: ha both sb        <- DSZ Command line (Ymodem-g);
Line  4: ha both sb -k     <- Ymodem command line.
Line  5: -@ -NV -UC:\BOYAN\DL -S2048 <- HS/Link parameters. HS/Link will auto
                              detect your comport speed.
Line  6: /I BIMOD1.LOG     <- Bimodem Parameters ( Port, Speed, and tagged
                              files are passed by TAGFILE
Line  7. c:\boyan\dl\      <- Subdirectory to recieve files into.  Be sure
                              the trailing backslash is on this line or it
                              will not work for you.  This option is only for
                              registered users of DSZ.  If your copy of DSZ
                              is not registered leave this as a blank line.
Line  8: PUMA P2 HF S      <- User configurable protocol.  Put your favorite
                              protocol here if it is not available in DSZ
                              Bimodem or HS/Link.
Line  9: Puma Batch        <- User configurable menu entry. Executes Line 8.
Line 10: c:\qed\q.exe      <- Path to your favorite text editor( QEdit
                              recommended). Be sure TAGFILE can find your
                              editor, that it is in your current directory,
                              in your DOS path or that you enter the path in
                              the configuration file as shown in the example.

Line 11: 2                 <- Communications port you COMM program uses.
                              Currently Tagfile will only work on com ports
                              1 and 2.
Line 12: 19200             <- Communications port speed
Line 13: COM               <- If using DSZ.COM enter COM here. If using
                              DSZ.EXE  enter EXE here.

Line 14: Y                 <- Turns on DSZ's MobyTurbo for downloads. This
                              line replaces the DESC.SDI/FILE_ID.DIZ option.
                              Tagfile is now hard coded for DESC.SDI

See sample DGS.DEF file included here.

2.) To run this utility from your communications program:

BOYAN:
I set  up  Boyan to use tagfile by executing the F9" key as a macro to call
tagfile. To do this in Boyan, load BOYAN.COM.  Enter "ALT-C" to configure
boyan.  When the configuration menu shows enter "M" for macros.  Pick the
key you want to use from you menu options and then enter the macro as follows:
\DC[TAGFILE]

TELIX:
Use the TAGFILE.SLC or compile your own with the TAGFILE.SLT file using
CS.EXE that comes with Telix.  Go into Telix and define any macro to
execute @TAGFILE

TAGFILE.EXE and DIRN.EXE are in your path or your current subdirectory.
And make sure the editor, DSZ and other protocols are in your path or
current subdirectory as well. When you load tagfile you may pass the path
and name of your configuration file to it as follows.  TAGFILE C:\SUBDIR\DGS.DEF.

    -----------------------[ Using Tagfile ]-------------------------------

The commands on the menu are self explanitory.  The "S" will send the
upload command to the host system along with the file names of the
tagged files.  Once the command is sent you will be returned to your
communications package in case you haven't told your favorite BBS which
protocol you want to use.  Once you have done so return to tagfile and
press the upload key for the protocol you wish to use.

Your TAGFILE Menu looks as follows:



     ߳
            ----*>>> Tagfile v1.51.06 Unregistered! <<<*----     
     Ĵ 
      [T] Tagfiles                     [A] Add file to List       
      [C] Change Tagfile Name          [S] Send UL Command to BBS 
      [E] Edit File List                                          
      [K] Kill File List               [ESC] to Exit              
      [F] Description - DESC.SDI       [PGUP] Upload Files        
      [O] RBBS style DOZ Descriptions  [PGDN] Download Files      
     Ĵ 
      F2 = Os Shell                                               
      
       

     TAGFILE command <?,T,C,E,K,F,O,A,D,U,S>?



Commands:

 1. T = Tagfiles.  TAGFILE.EXE comes with a file tagging utility which
                   can be used with or without TAGFILE. It is called
                   DIRN.EXE.  When this utility is called it reads the
                   first line configuration file (DGS.DEF) and knows
                   to append files to this list.  If it does not find
                   the list or you have deleted the list then it will
                   create a new one with the name you specify.


                   When you enter T at the menu prompt you will first
                   be presented with this screen:

ķ
                                                                              
    Press ENTER for current directory.                                        
    Or enter subdirectory only. Example: C:\TEST                              
                                                                              
     Display which subdirectory?                                              
    :                                                                         
                                                                              
Ľ

       You may enter the subdirectory you wish to search at this
       time.  It can be a different drive than your current drive
       as well.  The important thing to remember is not to leave
       any trailing back slashes.  If I wanted to tag files in my
       communications DL directory for uploading to other systems
       I would enter "C:\BOYAN\DL" at the prompt (without quotes of
       course).

       The next step would be to enter the file search specifications.
       Aftering entering the subdirectory to search you then need to
       enter those.  The menu you will be presented to enter your
       specifictions looks like this:

͸
                                                                              
                                                                              
                                                                              
           ENTER for default: *.*                                             
                                                                              
         File Search Specifications :                                         
                                                                              
;

      As you can see, a carriage return will display all the files
      in the subdirectory you specified above.  Let's say I had some
      specific files I wanted to upload and I knew what they were.
      With the new HS/Link protocol being released there are alot of
      files going around beginning with the letters HS.  For convenience
      in searching all my files for all of them I will then enter
      "HS*.* at this prompt.



    The following list would then be presented:

  Press Alt-T to tag all - Alt-U to remove Tags. 
 
 []TagFile v1.50 - Directory Lister[ ]Ŀ
   HS-BOYAN.DOC   HSLK10C6.ZIP                               
   HS-BOYAN.ZIP   HSLK10C7.ZIP                               
   HS-D.BAT       HSLK10C9.ZIP                               
   HS-INST.ZIP    HSLK10D1.ZIP                               
   HS-R173C.ARJ   HSLK10D2.ZIP                               
   HS-R173C.ZOO   HSLK10D3.ZIP                               
  HS-R173C.ZIP   HSLK1124.ZIP                               
   HS-U.BAT                                                  
   HS-WC215.DOC                                              
   HS-WC215.ZIP                                              
   HSLK10B7.ZIP                                              
   HSLK10C4.ZIP                                              
 Ĵ
 ٰ
  Press SPACE to select or ESC to finish. 


    Alt T will tag all the listed files with a check mark.  As
    shown on the HS-R173C.ZIP file in the tagging utility, a space
    bar will tag single files.  When done tagging then simply hit
    your escape key and the tagged files will be added to the list
    you specified.  This menu also has mouse functions built into
    it for your convenience.  Stretch the window to your con-
    venience and tag by clicking the mouse with the left button.


 2. C = Change Tagfile name.  This is the list that you have specified in
    the first line of your configuration file ( DGS.DEF ).  To change then
    name of the file list simply execute this command and you will be prompted
    for the new name and your configuration file will be changed accordingly.

 3. E = Edit your file list.  This function calls the editor you have named
    on line 9 of your configuration file ( DGS.DEF ).  QEdit is recommended
    for use here though any text editor ( NOT WORD PROCESSOR ) should work.

 4. K = Kill list of tagged files to start a new one.  This function
    erases the list of tagged files so you can start a fresh new one
    after you have uploaded to all your favorite BBSs.

 5. F = Add a file description to files in your tagged file list.
    Creates preformated description files  written with the Tagfile internal
    editor.  ID.BAT ( included with TAGFILE ) will add the SDI file to your
    tagged file once you have written the description.   TAGFILE passes the
    extension to the batch file when it calls it.  This file must be found
    in the current subdirectory or in your DOS path.

      ID.BAT:
      %1 = the full name and path of the tagged file
      %2 = the name of your description file DESC.SDI.
      %3 = extension of the compressed file.
     Sample ID.BAT:

      @ECHO OFF
      GOTO %3 ELSE
      GOTO EXIT
      :ZIP
      pkzip %1 c:\logo\chatters.bbs
      ziplogo %1 c:\logo\logo.bbs
      pkzip -k %1 %2
      GOTO EXIT
      :PAK
      pak A %1 %2
      GOTO EXIT
      :ARC
      pak A %1 %2
      GOTO EXIT
      :ARJ
      arj a %1 %2
      GOTO EXIT
      :ZOO
      zoo a %1 %2
      GOTO EXIT
      :EXIT

 6. O = Do RBATCH style DOZ descriptions.  Tagfile will create a text list
    formatted to be accepted by RBATCH ( the RBBS-PC external Batch Upload
    handler.

    The .DOZ format is as follows:

                {FI RBATCH.ZIP
                Description of file goes here with a maximum
                line length of 45 characters and a maximum
                of 10 lines
                {FI TAG160.ZIP
                Description of file goes here with a maximum
                line length of 45 characters and a maximum
                of 10 lines


Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Tagfile
          Will create this line for you. Notice there is no path. It
          is not needed.

Line 2 thru 11 :  The description of the file to be posted with
                  a maximum line length of 45 chars and a maximum
                  of 10 lines.  These standards were set to comply
                  with the FILE_ID.DIZ and DESC.SDI formats.

Tagfile will automaticly include the file description file in you tagged
file list and will place it first.  If you are for any reason disconnected
from the host while in the midst of a transfer you will be assured of having
sent your descriptions first so all successful uploads will be automaticly
posted by RBATCH if your host has this batch handler installed.


 7. PGUP = Upload files or Send tagged files to the Host from your system.
        When pressing this key you will get a menu with the following
        selections:

        ߳
                            
              Download      
                            
         [Z] Zmodem Batch     Z = Upload tagged files using Zmodem
         [G] Ymodem-g Batch   G = Upload tagged files using Ymodem-g (MNP modems only)
         [K] Ymodem Batch     K = Upload tagged files using Ymodem 1K
         [H] HS/Link TwoWay   H = Noted below
         [B] BiModem TwoWay   B = Noted below
         [M] Puma Batch       M = Noted below
        ٰ
          

          ESC will exit this menu.

    H = Upload tagged files using HS/Link.  This may be used to execute
        a bidirectional transfer.  Tell the BBS you are calling that
        you want to download a file using HS/Link.  When the system says
        it is ready to send the file then shell to TAGFILE and execute the
        "H" command and your bidirectional transfer will begin.
    B = Upload tagged files using BiModem.  This may be used to execute
        a bidirectional transfer.  Tell the BBS you are calling that
        you want to download a file using BiModem.  When the system says
        it is ready to send the file then shell to TAGFILE and execute the
        "B" command and your bidirectional transfer will begin.
    M = This is a totally configurable menu choice.  You can use this for
        anything you wish: downloading with your favorite protocol,
        uploading with your favorite protocol, compiling or whatever you
        wish.  Tagfile will shell to whatever you call if it can find a
        tagged filelist.  For an example I have included MPT ( Puma ) to
        give you a feel for how it works.  Line 7 of your configuration
        file ( DGS.DEF ) is the program to execute and parameters to pass
        (if any).  Line 8 is the Menu Listing description.  The menu
        will only list the first 21 chars of what you enter here so keep
        it short.



 8. PGDN = Download files or recieve files to your system from the Host.
        When pressing this key you will get a menu with the following
        selections:
        ߳
                            
              Download      
                            
         [Z] Zmodem Batch     = Download using Zmodem
         [G] Ymodem-g Batch   = Download using Ymodem-g (MNP only)
         [K] Ymodem Batch     = Download using Ymodem
         [H] HS/Link TwoWay   = Download using HS/Link *
         [B] BiModem TwoWay   = Download using Bimodem *
                            
        ٰ
          

        * = Will execute bidirectional transfer if you have tagged files.

        ESC will exit this menu.

 9. S = Send Upload Command -  Send the upload command to the BBS.  THIS IS
    ONLY TO BE EXECUTED WHILE YOU ARE ON LINE!     This command will send
    the upload command to the BBS along with the names of all the files you
    have tagged.  Depending on the system you call this may or may not
    be an advantageous  feature for you to use.

10. ESC = Quit or exit the program.


Once you have tagged some files for uploading, dial your favorite BBS
and have a good time transferring files.  Be sure to upload quality files.
This makes your sysop infinitely happy.

Though TAGFILE will work on any BBS future enhancements will be more focused
on compatibility with new and upcoming features of the RBBS BATCH uploading
interface ( RBATCH ).  Future enhancements will include:


   1.) Enhanced file description formats.
   2.) User Suggestions!  Your input can only make this better!


Tom Hansen, Sysop (DGS-Tango)
CHURCH CHATTERS BBS   (402)593-8863  HST
                      (402)592-9266 Contributers HST v.42Bis



                   DGS - Dedicated to Great Support!

I want to thank the following people for helping to test TAGFILE and
especially Dan Shore for writing RBATCH which was the inspiration for
writing this to simplify batch uploading to RBBS-PC systems.  All new
TAGFILE features may be tested on the following systems in addition to
our own : Tom Hansen (DGS-Tango)  CHURCH CHATTERS BBS (402)593-8863 HST

Dan Shore (DGS-Wonder)
THE SHORELINE BBS     (301) 946-2771  HST

Walter Ames (DGS-Viper)
THE WORLD OF GREYHAWK (410) 461-9943  Dual
                      (410) 465-3891  Dual

Gregg Snyder (DGS-Alpha)
THE ELUSIVE DIAMOND   (703) 323-6423  HST
                      (703) 323-1782  HST


              ------------------------------------------
              TAGFILE WARRANTY, REGISTRATION AND SUPPORT
              ------------------------------------------

Warranty & Disclaimer:

THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.

As always, with any new program, you should have a backup of your system.

You can always call my BBS and download the official version.


Registration:

This program is being released under the "shareware" concept.  This means
that you can try it out to see what it is like for a period of time.  If
after a period of 60 days you continue to use it, then your registration
is requested.

You may get your registered version one of two ways.  First, for $10.00,
mail in the registration form with all the questions filled in.  You will
then have to call my BBS and log on with the username and password that
you supplied on the registration form and download the filename that I
leave for you in a message. (This will be your registered version).
Second, for $15.00, you can send me the registration form with all the
questions filled in along with the size of the diskette you wish to receive
(5 1/4 or 3 1/2). I will then mail you a diskette with your registered
version of the program on it.




Support:

If you encounter any problems with the program, or have suggestions
on improvements, you may call my BBS 24 hrs a day, and leave a message
or leave a message on the RIME Network in the RBBS conference. I will
consider the enhancements and of course try to fix any problems
encountered with the program.  My BBS name & number is:

                         Tom Hansen
                    "CHURCH CHATTERS BBS"
                       USR HST 14.4k
                       402-593-8863
                     Proud Member of the
                - DGS Systems Group (Tango) -

                   Proudly Running RBBS-PC
             "The Best BBS Software in the World"

                 Member of the RIME Network
                    Node ID = OUTRIDER
