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