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


TAGFILE a utility for BATCH uploading:

Please give feedback on this program.  I hope to keep this program
under 30k in size though that may be a pipe dream.

Your suggestions can only make this better!

Send suggestions to Church Chatters BBS
Public Access number 402-593-8863

Future enhancements:

1.) Downloading capabilities though that can already be done
    with the configurable switches in DGS.DEF.   The intention
    is not to provide a download utility but one for uploads.
    Your bidirectional options will handle the downloading
    for you as well.

2.) Better Documentation.

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 )

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 9 of DGS.DEF)
    and the optional protocol ( Lines 7 and 8 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 8 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.
Line  8: PUMA P2 HF S@TEST.LST  <- User configurable protocol to execute.
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 EXE
Line 14: DESC.SDI             enter EXE.  If this line is optional. If left blank
                             TAGFILE.EXE will default to DSZ.COM.
                -> Text file created by TAGFILE with file descriptions
                          for files uploaded in batch mode.


See sample DGS.DEF file included here.

2.) To run this utility setup a macro in your communications program;

BOYAN:
I set mine up in Boyan for the "F9" key. 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
the menu selections and then enter the prompt 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 pass the path and
name of your configuration file to it as follows.  TAGFILE C:\SUBDIR\DGS.DEF.


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        
                                       [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.  You and 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.  This is
    for future use with RBATCH ( by Dan Shore ) on RBBS-PC BBS systems.
    Creates preformated description files  writen with the Tagfile internal
    editor.  ID.BAT ( included with TAGFILE ) will add the DIZ or 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 FILE_ID.DIZ or DESC.SDI or
           whatever you choose to call it.
      %3 = extension of the compressed file.


@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. 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.



 7. 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.

 8. 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.

 9. 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



                   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:

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 can 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 do encounter any problems with the program, or have suggestions
on improvements, you can call my BBS 24 hrs a day, and leave a message
for me, or leave me 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
                    HUB  ID = HUBPADRE

  I will also be glad to talk voice with you if you wish, just leave
       a message on the BBS or RIME and we can set up a time.
