home *** CD-ROM | disk | FTP | other *** search
/ Monster Disc 2: The Best of 1992 / MONSTER1.ISO / bbs / rbbs / tag160.zip / TAGFILE.TXT < prev    next >
Text File  |  1992-03-02  |  22KB  |  462 lines
  1. TAGFILE v1.60     by Tom Hansen, SysOp      Church Chatters (tm) BBS
  2.  
  3. ------------------------------------------------------------------------------
  4.                   TAGFILE a utility for BATCH uploading.
  5. ------------------------------------------------------------------------------
  6. Files included in this archive include:
  7.  
  8. TAGFILE.EXE : Main control program.
  9. DIRN.EXE    : File Tagging utility called by TAGFILE.EXE.  This may be run
  10.               independantly of TAGFILE.EXE
  11. DGS.DEF     : Sample configuration file.
  12. TAGFILE.TXT : This document.
  13. ID.BAT      : Batch file for processing DIZ ( prepared descriptions ) files.
  14. TAGFILE.SLT : Salt file for compiling macro script for TELIX
  15. TAGFILE.SLC : Compiled TAGFILE.SLT script.
  16. DESC.SDI    : Desctripion of Program for BBS posting ( inserted by TAGFILE )
  17. UPDATE.DOC  : Updates  TAGFILE Documentation re: Bug fixes and enhancements.
  18.  
  19.  
  20.                    ------[ Setup:  How to do it! ]------
  21.  
  22.  
  23. 1.) Edit DGS.DEF to match your system.  Be sure the executable files are
  24.     either in your path or your current subdirectory. ( Executable programs
  25.     called by TAGFILE are DSZ.COM( or DSZ.EXE), HSLINK.EXE, BIMODEM.COM and
  26.     DIRN.EXE ).  User defined programs are the editor (Line 10 of DGS.DEF)
  27.     and the optional protocol ( Lines 8 and 9 of DGS.DEF).  The editor is
  28.     menu selection E ( used in various other functions as well ) and the user
  29.     defined protocol is menu selection M.  The descritpion on line 9 for menu
  30.     selection M should be no longer than 21 chars.
  31.  
  32.  DGS.DEF outline   :
  33.  
  34. Line  1: test.lst          <- Name of file listing tagged files (No Path needed);
  35. Line  2: handshake both sz <- DSZ Command line (Zmodem);  Tagfile will pass
  36.                               your port number and speed as to DSZ.COM or to
  37.                               DSZ.EXE ( see line 12 ) and the tagged files.
  38. Line  3: ha both sb        <- DSZ Command line (Ymodem-g);
  39. Line  4: ha both sb -k     <- Ymodem command line.
  40. Line  5: -@ -NV -UC:\BOYAN\DL -S2048 <- HS/Link parameters. HS/Link will auto
  41.                               detect your comport speed.
  42. Line  6: /I BIMOD1.LOG     <- Bimodem Parameters ( Port, Speed, and tagged
  43.                               files are passed by TAGFILE
  44. Line  7. c:\boyan\dl\      <- Subdirectory to recieve files into.  Be sure
  45.                               the trailing backslash is on this line or it
  46.                               will not work for you.  This option is only for
  47.                               registered users of DSZ.  If your copy of DSZ
  48.                               is not registered leave this as a blank line.
  49. Line  8: PUMA P2 HF S      <- User configurable protocol.  Put your favorite
  50.                               protocol here if it is not available in DSZ
  51.                               Bimodem or HS/Link.
  52. Line  9: Puma Batch        <- User configurable menu entry. Executes Line 8.
  53. Line 10: c:\qed\q.exe      <- Path to your favorite text editor( QEdit
  54.                               recommended). Be sure TAGFILE can find your
  55.                               editor, that it is in your current directory,
  56.                               in your DOS path or that you enter the path in
  57.                               the configuration file as shown in the example.
  58.  
  59. Line 11: 2                 <- Communications port you COMM program uses.
  60.                               Currently Tagfile will only work on com ports
  61.                               1 and 2.
  62. Line 12: 19200             <- Communications port speed
  63. Line 13: COM               <- If using DSZ.COM enter COM here. If using
  64.                               DSZ.EXE  enter EXE here.
  65.  
  66. Line 14: Y                 <- Turns on DSZ's MobyTurbo for downloads. This
  67.                               line replaces the DESC.SDI/FILE_ID.DIZ option.
  68.                               Tagfile is now hard coded for DESC.SDI
  69.  
  70. See sample DGS.DEF file included here.
  71.  
  72. 2.) To run this utility from your communications program:
  73.  
  74. BOYAN:
  75. I set  up  Boyan to use tagfile by executing the F9" key as a macro to call
  76. tagfile. To do this in Boyan, load BOYAN.COM.  Enter "ALT-C" to configure
  77. boyan.  When the configuration menu shows enter "M" for macros.  Pick the
  78. key you want to use from you menu options and then enter the macro as follows:
  79. \DC[TAGFILE]
  80.  
  81. TELIX:
  82. Use the TAGFILE.SLC or compile your own with the TAGFILE.SLT file using
  83. CS.EXE that comes with Telix.  Go into Telix and define any macro to
  84. execute @TAGFILE
  85.  
  86. TAGFILE.EXE and DIRN.EXE are in your path or your current subdirectory.
  87. And make sure the editor, DSZ and other protocols are in your path or
  88. current subdirectory as well. When you load tagfile you may pass the path
  89. and name of your configuration file to it as follows.  TAGFILE C:\SUBDIR\DGS.DEF.
  90.  
  91.     -----------------------[ Using Tagfile ]-------------------------------
  92.  
  93. The commands on the menu are self explanitory.  The "S" will send the
  94. upload command to the host system along with the file names of the
  95. tagged files.  Once the command is sent you will be returned to your
  96. communications package in case you haven't told your favorite BBS which
  97. protocol you want to use.  Once you have done so return to tagfile and
  98. press the upload key for the protocol you wish to use.
  99.  
  100. Your TAGFILE Menu looks as follows:
  101.  
  102.  
  103.  
  104.      │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  105.      │       ----*>>> Tagfile v1.51.06ß Unregistered! <<<*----    │ ░░
  106.      ├────────────────────────────────────────────────────────────┤ ░░
  107.      │ [T] Tagfiles                     [A] Add file to List      │ ░░
  108.      │ [C] Change Tagfile Name          [S] Send UL Command to BBS│ ░░
  109.      │ [E] Edit File List                                         │ ░░
  110.      │ [K] Kill File List               [ESC] to Exit             │ ░░
  111.      │ [F] Description - DESC.SDI       [PGUP] Upload Files       │ ░░
  112.      │ [O] RBBS style DOZ Descriptions  [PGDN] Download Files     │ ░░
  113.      ├────────────────────────────────────────────────────────────┤ ░░
  114.      │ F2 = Os Shell                                              │ ░░
  115.      └────────────────────────────────────────────────────────────┘ ░░
  116.        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  117.  
  118.      TAGFILE command <?,T,C,E,K,F,O,A,D,U,S>?
  119.  
  120.  
  121.  
  122. Commands:
  123.  
  124.  1. T = Tagfiles.  TAGFILE.EXE comes with a file tagging utility which
  125.                    can be used with or without TAGFILE. It is called
  126.                    DIRN.EXE.  When this utility is called it reads the
  127.                    first line configuration file (DGS.DEF) and knows
  128.                    to append files to this list.  If it does not find
  129.                    the list or you have deleted the list then it will
  130.                    create a new one with the name you specify.
  131.  
  132.  
  133.                    When you enter T at the menu prompt you will first
  134.                    be presented with this screen:
  135.  
  136. ╓──────────────────────────────────────────────────────────────────────────────╖
  137. ║                                                                              ║
  138. ║    Press ENTER for current directory.                                        ║
  139. ║    Or enter subdirectory only. Example: C:\TEST                              ║
  140. ║                                                                              ║
  141. ║     Display which subdirectory?                                              ║
  142. ║    :                                                                         ║
  143. ║                                                                              ║
  144. ╙──────────────────────────────────────────────────────────────────────────────╜
  145.  
  146.        You may enter the subdirectory you wish to search at this
  147.        time.  It can be a different drive than your current drive
  148.        as well.  The important thing to remember is not to leave
  149.        any trailing back slashes.  If I wanted to tag files in my
  150.        communications DL directory for uploading to other systems
  151.        I would enter "C:\BOYAN\DL" at the prompt (without quotes of
  152.        course).
  153.  
  154.        The next step would be to enter the file search specifications.
  155.        Aftering entering the subdirectory to search you then need to
  156.        enter those.  The menu you will be presented to enter your
  157.        specifictions looks like this:
  158.  
  159. ╒══════════════════════════════════════════════════════════════════════════════╕
  160. │                                                                              │
  161. │                                                                              │
  162. │                                                                              │
  163. │           ENTER for default: *.*                                             │
  164. │                                                                              │
  165. │         File Search Specifications :                                         │
  166. │                                                                              │
  167. ╘══════════════════════════════════════════════════════════════════════════════╛
  168.  
  169.       As you can see, a carriage return will display all the files
  170.       in the subdirectory you specified above.  Let's say I had some
  171.       specific files I wanted to upload and I knew what they were.
  172.       With the new HS/Link protocol being released there are alot of
  173.       files going around beginning with the letters HS.  For convenience
  174.       in searching all my files for all of them I will then enter
  175.       "HS*.* at this prompt.
  176.  
  177.  
  178.  
  179.     The following list would then be presented:
  180.  
  181.  ░░░░░░░ Press Alt-T to tag all - Alt-U to remove Tags. ░░░░░░░░░
  182.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  183.  ░┌─[■]──────────TagFile v1.50 - Directory Lister──────────[ ]─┐░
  184.  ░│  HS-BOYAN.DOC   HSLK10C6.ZIP                               │░
  185.  ░│  HS-BOYAN.ZIP   HSLK10C7.ZIP                               │░
  186.  ░│  HS-D.BAT       HSLK10C9.ZIP                               │░
  187.  ░│  HS-INST.ZIP    HSLK10D1.ZIP                               │░
  188.  ░│  HS-R173C.ARJ   HSLK10D2.ZIP                               │░
  189.  ░│  HS-R173C.ZOO   HSLK10D3.ZIP                               │░
  190.  ░│ √HS-R173C.ZIP   HSLK1124.ZIP                               │░
  191.  ░│  HS-U.BAT                                                  │░
  192.  ░│  HS-WC215.DOC                                              │░
  193.  ░│  HS-WC215.ZIP                                              │░
  194.  ░│  HSLK10B7.ZIP                                              │░
  195.  ░│  HSLK10C4.ZIP                                              │░
  196.  ░├────────────────────────────────────────────────────────────┤░
  197.  ░└░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░┘░
  198.  ░░░░░░░░░░░ Press SPACE to select or ESC to finish. ░░░░░░░░░░░░
  199.  
  200.  
  201.     Alt T will tag all the listed files with a check mark.  As
  202.     shown on the HS-R173C.ZIP file in the tagging utility, a space
  203.     bar will tag single files.  When done tagging then simply hit
  204.     your escape key and the tagged files will be added to the list
  205.     you specified.  This menu also has mouse functions built into
  206.     it for your convenience.  Stretch the window to your con-
  207.     venience and tag by clicking the mouse with the left button.
  208.  
  209.  
  210.  2. C = Change Tagfile name.  This is the list that you have specified in
  211.     the first line of your configuration file ( DGS.DEF ).  To change then
  212.     name of the file list simply execute this command and you will be prompted
  213.     for the new name and your configuration file will be changed accordingly.
  214.  
  215.  3. E = Edit your file list.  This function calls the editor you have named
  216.     on line 9 of your configuration file ( DGS.DEF ).  QEdit is recommended
  217.     for use here though any text editor ( NOT WORD PROCESSOR ) should work.
  218.  
  219.  4. K = Kill list of tagged files to start a new one.  This function
  220.     erases the list of tagged files so you can start a fresh new one
  221.     after you have uploaded to all your favorite BBSs.
  222.  
  223.  5. F = Add a file description to files in your tagged file list.
  224.     Creates preformated description files  written with the Tagfile internal
  225.     editor.  ID.BAT ( included with TAGFILE ) will add the SDI file to your
  226.     tagged file once you have written the description.   TAGFILE passes the
  227.     extension to the batch file when it calls it.  This file must be found
  228.     in the current subdirectory or in your DOS path.
  229.  
  230.       ID.BAT:
  231.       %1 = the full name and path of the tagged file
  232.       %2 = the name of your description file DESC.SDI.
  233.       %3 = extension of the compressed file.
  234.      Sample ID.BAT:
  235.  
  236.       @ECHO OFF
  237.       GOTO %3 ELSE
  238.       GOTO EXIT
  239.       :ZIP
  240.       pkzip %1 c:\logo\chatters.bbs
  241.       ziplogo %1 c:\logo\logo.bbs
  242.       pkzip -k %1 %2
  243.       GOTO EXIT
  244.       :PAK
  245.       pak A %1 %2
  246.       GOTO EXIT
  247.       :ARC
  248.       pak A %1 %2
  249.       GOTO EXIT
  250.       :ARJ
  251.       arj a %1 %2
  252.       GOTO EXIT
  253.       :ZOO
  254.       zoo a %1 %2
  255.       GOTO EXIT
  256.       :EXIT
  257.  
  258.  6. O = Do RBATCH style DOZ descriptions.  Tagfile will create a text list
  259.     formatted to be accepted by RBATCH ( the RBBS-PC external Batch Upload
  260.     handler.
  261.  
  262.     The .DOZ format is as follows:
  263.  
  264.                 {FI RBATCH.ZIP
  265.                 Description of file goes here with a maximum
  266.                 line length of 45 characters and a maximum
  267.                 of 10 lines
  268.                 {FI TAG160.ZIP
  269.                 Description of file goes here with a maximum
  270.                 line length of 45 characters and a maximum
  271.                 of 10 lines
  272.  
  273.  
  274. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Tagfile
  275.           Will create this line for you. Notice there is no path. It
  276.           is not needed.
  277.  
  278. Line 2 thru 11 :  The description of the file to be posted with
  279.                   a maximum line length of 45 chars and a maximum
  280.                   of 10 lines.  These standards were set to comply
  281.                   with the FILE_ID.DIZ and DESC.SDI formats.
  282.  
  283. Tagfile will automaticly include the file description file in you tagged
  284. file list and will place it first.  If you are for any reason disconnected
  285. from the host while in the midst of a transfer you will be assured of having
  286. sent your descriptions first so all successful uploads will be automaticly
  287. posted by RBATCH if your host has this batch handler installed.
  288.  
  289.  
  290.  7. PGUP = Upload files or Send tagged files to the Host from your system.
  291.         When pressing this key you will get a menu with the following
  292.         selections:
  293.  
  294.         │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  295.         │                    │░░
  296.         │      Download      │░░
  297.         │                    │░░
  298.         │ [Z] Zmodem Batch   │░░  Z = Upload tagged files using Zmodem
  299.         │ [G] Ymodem-g Batch │░░  G = Upload tagged files using Ymodem-g (MNP modems only)
  300.         │ [K] Ymodem Batch   │░░  K = Upload tagged files using Ymodem 1K
  301.         │ [H] HS/Link TwoWay │░░  H = Noted below
  302.         │ [B] BiModem TwoWay │░░  B = Noted below
  303.         │ [M] Puma Batch     │░░  M = Noted below
  304.         └────────────────────┘░░
  305.           ░░░░░░░░░░░░░░░░░░░░░░
  306.  
  307.           ESC will exit this menu.
  308.  
  309.     H = Upload tagged files using HS/Link.  This may be used to execute
  310.         a bidirectional transfer.  Tell the BBS you are calling that
  311.         you want to download a file using HS/Link.  When the system says
  312.         it is ready to send the file then shell to TAGFILE and execute the
  313.         "H" command and your bidirectional transfer will begin.
  314.     B = Upload tagged files using BiModem.  This may be used to execute
  315.         a bidirectional transfer.  Tell the BBS you are calling that
  316.         you want to download a file using BiModem.  When the system says
  317.         it is ready to send the file then shell to TAGFILE and execute the
  318.         "B" command and your bidirectional transfer will begin.
  319.     M = This is a totally configurable menu choice.  You can use this for
  320.         anything you wish: downloading with your favorite protocol,
  321.         uploading with your favorite protocol, compiling or whatever you
  322.         wish.  Tagfile will shell to whatever you call if it can find a
  323.         tagged filelist.  For an example I have included MPT ( Puma ) to
  324.         give you a feel for how it works.  Line 7 of your configuration
  325.         file ( DGS.DEF ) is the program to execute and parameters to pass
  326.         (if any).  Line 8 is the Menu Listing description.  The menu
  327.         will only list the first 21 chars of what you enter here so keep
  328.         it short.
  329.  
  330.  
  331.  
  332.  8. PGDN = Download files or recieve files to your system from the Host.
  333.         When pressing this key you will get a menu with the following
  334.         selections:
  335.         │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  336.         │                    │░░
  337.         │      Download      │░░
  338.         │                    │░░
  339.         │ [Z] Zmodem Batch   │░░  = Download using Zmodem
  340.         │ [G] Ymodem-g Batch │░░  = Download using Ymodem-g (MNP only)
  341.         │ [K] Ymodem Batch   │░░  = Download using Ymodem
  342.         │ [H] HS/Link TwoWay │░░  = Download using HS/Link *
  343.         │ [B] BiModem TwoWay │░░  = Download using Bimodem *
  344.         │                    │░░
  345.         └────────────────────┘░░
  346.           ░░░░░░░░░░░░░░░░░░░░░░
  347.  
  348.         * = Will execute bidirectional transfer if you have tagged files.
  349.  
  350.         ESC will exit this menu.
  351.  
  352.  9. S = Send Upload Command -  Send the upload command to the BBS.  THIS IS
  353.     ONLY TO BE EXECUTED WHILE YOU ARE ON LINE!     This command will send
  354.     the upload command to the BBS along with the names of all the files you
  355.     have tagged.  Depending on the system you call this may or may not
  356.     be an advantageous  feature for you to use.
  357.  
  358. 10. ESC = Quit or exit the program.
  359.  
  360.  
  361. Once you have tagged some files for uploading, dial your favorite BBS
  362. and have a good time transferring files.  Be sure to upload quality files.
  363. This makes your sysop infinitely happy.
  364.  
  365. Though TAGFILE will work on any BBS future enhancements will be more focused
  366. on compatibility with new and upcoming features of the RBBS BATCH uploading
  367. interface ( RBATCH ).  Future enhancements will include:
  368.  
  369.  
  370.    1.) Enhanced file description formats.
  371.    2.) User Suggestions!  Your input can only make this better!
  372.  
  373.  
  374. Tom Hansen, Sysop (DGS-Tango)
  375. CHURCH CHATTERS BBS   (402)593-8863  HST
  376.                       (402)592-9266 Contributers HST v.42Bis
  377.  
  378.  
  379.  
  380.                    DGS - Dedicated to Great Support!
  381.  
  382. I want to thank the following people for helping to test TAGFILE and
  383. especially Dan Shore for writing RBATCH which was the inspiration for
  384. writing this to simplify batch uploading to RBBS-PC systems.  All new
  385. TAGFILE features may be tested on the following systems in addition to
  386. our own : Tom Hansen (DGS-Tango)  CHURCH CHATTERS BBS (402)593-8863 HST
  387.  
  388. Dan Shore (DGS-Wonder)
  389. THE SHORELINE BBS     (301) 946-2771  HST
  390.  
  391. Walter Ames (DGS-Viper)
  392. THE WORLD OF GREYHAWK (410) 461-9943  Dual
  393.                       (410) 465-3891  Dual
  394.  
  395. Gregg Snyder (DGS-Alpha)
  396. THE ELUSIVE DIAMOND   (703) 323-6423  HST
  397.                       (703) 323-1782  HST
  398.  
  399.  
  400.               ------------------------------------------
  401.               TAGFILE WARRANTY, REGISTRATION AND SUPPORT
  402.               ------------------------------------------
  403.  
  404. Warranty & Disclaimer:
  405.  
  406. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  407. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  408. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  409. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  410. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  411. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  412. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  413. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  414. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  415. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  416.  
  417. As always, with any new program, you should have a backup of your system.
  418.  
  419. You can always call my BBS and download the official version.
  420.  
  421.  
  422. Registration:
  423.  
  424. This program is being released under the "shareware" concept.  This means
  425. that you can try it out to see what it is like for a period of time.  If
  426. after a period of 60 days you continue to use it, then your registration
  427. is requested.
  428.  
  429. You may get your registered version one of two ways.  First, for $10.00,
  430. mail in the registration form with all the questions filled in.  You will
  431. then have to call my BBS and log on with the username and password that
  432. you supplied on the registration form and download the filename that I
  433. leave for you in a message. (This will be your registered version).
  434. Second, for $15.00, you can send me the registration form with all the
  435. questions filled in along with the size of the diskette you wish to receive
  436. (5 1/4 or 3 1/2). I will then mail you a diskette with your registered
  437. version of the program on it.
  438.  
  439.  
  440.  
  441.  
  442. Support:
  443.  
  444. If you encounter any problems with the program, or have suggestions
  445. on improvements, you may call my BBS 24 hrs a day, and leave a message
  446. or leave a message on the RIME Network in the RBBS conference. I will
  447. consider the enhancements and of course try to fix any problems
  448. encountered with the program.  My BBS name & number is:
  449.  
  450.                          Tom Hansen
  451.                     "CHURCH CHATTERS BBS"
  452.                        USR HST 14.4k
  453.                        402-593-8863
  454.                      Proud Member of the
  455.                 - DGS Systems Group (Tango) -
  456.  
  457.                    Proudly Running RBBS-PC
  458.              "The Best BBS Software in the World"
  459.  
  460.                  Member of the RIME Network
  461.                     Node ID = OUTRIDER
  462.