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