Monster Media 1993 #2

home *** CD-ROM | disk | FTP | other *** search

/ Monster Media 1993 #2 / Image.iso / comm / hslt110.zip / HSLTAG.DOC < prev next >

Wrap

Text File | 1993-05-11 | 26KB | 636 lines

┌───┐ ┌───┐ ┌─────────┐ ┌───┐ ┌───────────┐ ┌──────────┐ ┌────────┐ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────┘ │ │ └───┐ ┌───┘ │ ┌──┐ │ │ ┌─────┘ │ │ │ │ │ └─────┐ │ │ │ │ │ │ │ │ │ │ │ └───┘ │ │ │ │ │ │ │ │ └──┘ │ │ │ │ ┌───┐ │ │ │ │ │ │ │ │ │ │ │ ┌────┐ │ │ │ │ └─────┐ │ │ │ │ │ │ ┌──┐ │ │ │ └─┐ │ │ │ │ │ ┌─────┘ │ │ └─────┐ │ │ │ │ │ │ │ └───┘ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └───┘ └───┘ └─────────┘ └─────────┘ └───┘ └───┘ └───┘ └─────────┘ HSLTAG v1.10 Copyright (C) 1993 Thomas P. Hansen All Rights Reserved. HSLTAG is a file tagging and batch upload manager for use as a shell from the communications program of choice for managing BBS bidirectional trans- fers with HS/Link (C) by Samual P. Smith. It allows for the creation of description files with its internal editing features and will place these description files in compressed files which you have tagged for uploading. Currently HSLTAG is compatible with ZIP, ZOO, PAK, ARC, LZH and ARJ com- pression formats. It is stable and reliable in DOS, DESQview and Windows environments. HSL/tag is not just another file tagger. It contains all the necessary features for preparing your uploads while off line so that you may exe- cute your bidirectional transfer with a single keystroke while on your favorite BBS. Its file description capabilities are compatible with FILE_ID.DIZ, DESC.SDI and DOZ formats. The DOZ format is the new descrip- tion format used by the RBATCH (C), the batch upload handler for RBBS-PC by Dan Shore of the Shoreline BBS. This program is not free! You are hereby licensed to use this program for a trial period of 30 days free of charge. If, after 30 days, you decide that you would like to continue using HSLTAG, you must complete the regis- tration form (REGISTER.DOC) and return it to the author with the required registration fee enclosed. Registration removes the "UNREGISTERED" and "PLEASE REGISTER" messages, as well as any time delays. Please feel free to distribute HSLTAG to your friends and local BBSes as long as all of the files in this archive are included and unmodified. See the LICENSE AND REGISTRATION section of this document for more details. HSLTAG 1.0 User Documentation - 1 - Table of Contents _________________________________________________________________ Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Screen Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 File List Management . . . . . . . . . . . . . . . . . . . . . . . . 3 File Description Utilities . . . . . . . . . . . . . . . . . . . . . 4 Online HotKeys . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 HSLTAG Configuration Options . . . . . . . . . . . . . . . . . . . 7 Calling HSLTAG from COMM programs . . . . . . . . . . . . . . . . . 8 Trouble Shooting (Some HS/Link Windows 3.x problems). . . . . . . . . 9 External Utilities . . . . . . . . . . . . . . . . . . . . . . . . . 10 Liscense / Registration information . . . . . . . . . . . . . . . . . 11 Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 HSLTAG 1.0 User Documentation - 2 - HSLTAG is a friendly environment built purposefully to match the default color scheme of HSLINK. It's menu is boxed into four sections, File List Management, File Description Utilities, Online Hotkeys & Configuration. The Keys crucial to your on line sessions are in Black and Yellow in the black and yellow box. The other boxes outline functions which can and should ideally be performed before you dial out in preparation for your calling session. Once on line and logged onto a BBS then all you need to do is tell the system what it is you want from them by executing the download command on the BBS. Once the system tells you it is ready to send you the files, shell to HSLTAG and hit your F4 key and your bidirectional file transfer will be on its way. Yes! It is as simple as that! (Menu out line omitted for this persentation) ───────── HSLTag v1.00 - Copyright 1993 - Thomas P. Hansen ─────────── ┌────── File List Management ──────┐ │ │ ╔ Online Hot/Key ╗ │ [T] Tag files for Uploading │ ║ ║ │ │ ║ ESC = Exit ║ │ [A] Add file to Tagged file List │ ║ ║ │ │ ║ F2 = Shell ║ │ [E] Edit File List │ ║ ║ │ │ ║ F4 = HS/Link ║ │ [K] Kill File List │ ║ ║ │ │ ╚════════════════╝ └─────────────────────────────────────┘ ┌──── File Description Utilities ────┐ ┌─── Configuration ────┐ │ │ │ │ │ [F] Description - FILE_ID.DIZ │ │ │ │ │ │ [C] Configure HS/Link │ │ [S] Description - DESC.SDI │ │ │ │ │ │ [H] Configure HSL/Tag │ │ [O] RBBS style DOZ Descriptions │ │ │ │ │ │ │ └─────────────────────────────────────┘ └───────────────────────┘ ────────────────────────────────────────────────────────────────────── File List Management: HSLTAG's File list management is set up for the purpose of perparing your uploads prior to logging on to your BBS of choice. Valuable time is not spent tagging and managing your upload while the clock ticks away. HSLTAG does not delete the tagged list when you exit and has the kill option set for when you want to create a new list of files to upload. This allows you to upload the same list of files to HSLTAG 1.0 User Documentation - 3 - several systems without having to retag them. The management commands are in the upper left quadrant of the HSLTAG screen. ┌────── File List Management ──────┐ │ │ │ [T] Tag files for Uploading │ │ │ │ [A] Add file to Tagged file List │ │ │ │ [E] Edit File List │ │ │ │ [K] Kill File List │ │ │ └─────────────────────────────────────┘ T = Tag files for uploading. As each file is tagged there is a check put next to the file name in the tagging window. You may toggle a tag on or off. Once the files are tagged they will be added to the list of files to send by pressing the F10 key. ESC will escape without adding names to the list. ┌─[■]─────────HSL/Tag v1.00ß - Directory Lister──────────[]─┐ │√ !SBLAST.ZIP DCRD100.ZIP HS-PROD.ZIP PCB-NG.ZIP │ │√ #1KEENV.ZIP DEBTMG10.ZIP KILL150.ZIP PKZFX24C.ZIP│ │ #1MAJOR.ZIP DLFIND12.ZIP MEGAE206.ZIP √ PROBB10.ZIP │ │ AMW13.ZIP DSZX009.ZIP MLABEL25.ZIP PROBB24.ZIP │ │ AN30.ZIP EBANK12.ZIP MORCN11B.ZIP PRODOR34.ZIP│ │ AS26.ZIP EFND100.ZIP MORDOR30.ZIP √ PROE344.ZIP │ │ ASTSPEAK.ZIP EVP101A.ZIP NETGUIDE.ZIP √ PROEDT34.ZIP│ │ CAL14S24.ZIP EXECWSWP.ZIP NGCHR104.ZIP PROPCK30.ZIP│ │ CALLOUT.LOG EXPRES22.ZIP NMSOURCE.ZIP PRORBBS.ZIP │ │ CHOOSCUR.ZIP FDLSTP10.ZIP NOSN100.ZIP PSP101.ZIP │ │ CLEAN100.ZIP FV142.ZIP NSTAT10.ZIP QBWIN5.ZIP │ │ DCF40.ZIP GAPPRO10.ZIP ONLINE.ZIP QNODE150.ZIP│ ├───────────────────────────────────────────────────────────┤ │ PROPCK30.ZIP 30813 Mar 15,1991 2:38p │ └───────────────────────────────────────────────────────────┘ The higlighted file ( which can not be illustrated in this text ) is displayed at the bottem of the tagger's screen with the file size, date and time. A = Add file to list for uploading. If you have a file on your system which you would like to upload but do not want to load the tagger you may add it to the list using this option. You will be presented with a boxed field to enter the full path and file name. HSLTAG 1.0 User Documentation - 4 - ┌─────────────────────────────────────────────────────────────────────────┐ │ │ │ Enter Path and File to Add ··········································· │ │ │ └─────────────────────────────────────────────────────────────────────────┘ If the correct path and filename are entered and HSLTAG finds the file it will be added to your tagged file list. E = Edit file list option allows you to manually edit your tagged file list using the editor you named in your HSLTAG setup. Any text editor will work for this that does not put control characters in the text. Dos 5.0's EDIT.COM or QEdit are good editors for this purpose. K = Kill File list will do just that. It will delete your tagged file list so you may start a new one. File Description Utilities These options allow you to enter descriptions in the ZIP files you are tagging to send if they do not already have description files in them. The menu has three options which will allow you to enter a FILE_ID.DIZ, DESC.SDI or DOZ description for the tagged file(s). The options are found in the bottom left quadrant of the HSLTAG menu. ┌──── File Description Utilities ────┐ │ │ │ [F] Description - FILE_ID.DIZ │ │ │ │ [S] Description - DESC.SDI │ │ │ │ [O] RBBS style DOZ Descriptions │ │ │ └─────────────────────────────────────┘ F = FILE_ID.DIZ description format is a 10 line description of a file each line no more than 45 chars. HSLTAG's internal editor will automaticly format the desciption to this standard. Once fished editing your newly created DIZ file will be put into the ZIP file by shelling out to a batch file called ID.BAT. A working copy of ID.BAT is included with HSLTAG. The batch file must be found either in your path or in the directory HSLTAG is run from. If the file already contains a FILE_ID.DIZ file you will be prompted accordingly and asked if you want to view the de- scription. HSLTAG 1.0 User Documentation - 5 - S = DESC.SDI description format is a single line description of a file 60 chars long. HSLTAG will offer you a single line editor to enter your description if no internal DESC.SDI is found in the file. If the tagged file contains a DESC.SDI file you will be prompted accordingly and asked if you want to view the des- cription. O = Creates the DOZ description file format. An external file, the DOZ file is uploaded along with your tagged files. This format only works with RBBS-PC systems running RBATCH by Dan Shore. Each file is marked with these three chars {FI. The file name follows and then the category that you would enter it in ( as per the BBS directory of directories you are calling. On my system, category 1 is the communications files directory. An entry in a DOZ file for a file uploaded to this directory would look like this: {FI COMMPROG.ZIP 1 This is a communications program from Portugal. Powerful script language and external protocal management. A must for the power BBS user! Once the RBBS-PC system using RBATCH to process batch uploads sees the DOZ file it will automaticly post the description in category 1 of its file listings. This frees the caller from entering any keystrokes to describe and categorize files while on line. HSLTAG writes this file in the correct format. You of course are responsible for entering the cor- rect categories and descriptions before you execute your BBS calling and upload session. OnLine HotKeys: These commands are found in the upper right hand quadrant of the HSLTAG menu: ╔ Online Hot/Key ╗ ║ ║ ║ ESC = Exit ║ ║ ║ ║ F2 = Shell ║ ║ ║ ║ F4 = HS/Link ║ ║ ║ ╚════════════════╝ HSLTAG 1.0 User Documentation - 6 - When you shell from your COMM program to HSLTAG while on-line, these are the three primary commands you want available to you since you have already done your tagging and editing while off-line. ESC = Everone needs to exit at one time or another. F2 = Sometimes you need to get to DOS. We figured there was no reason once in HSLTAG to exit to your COMM program to shell to DOS so we put this one in here. F4 = Starts your HS/Link communications session. If you have told the remote system to send you files and you have tagged files to send, this will begin your bidirectional transfer. If you have not tagged any files but have told the remote system to send you files this command will begin the HS/Link single direction transfer. If you have tagged files and told the remote system you are sending a file using HS/Link this command will begin your transfer if you have files tagged. Configuration: Commands in the bottom right hand quadrant of your HSLTAG menu enable you to configure HSLINK and HSLTAG. You must have HSCONFIG.EXE in your path or current directory. Configure HS/Link according to HS/Link documentation. HSLTAG will not run if it cannot find this file as HS/Link configuration is manditory for HSLTAG to do the job for you. C = HS/Link Configuration. See HS/Link documentation. H = HSLTAG configuration. HSLTAG has 4 configuration options: A. The full path and filename of your text editor. This is only necessary if you wish to edit your DOZ file description and/or file lists. B. The default path location where you store files to send. Please note there is no trailing backslash! C. Whether or not you are using a fossil driver. If your answer is yes, HSLTAG will require FHSLINK.EXE to be in the current directory or in your path. FHSLINK.EXE is distributed with HSLINK. If you are not using a fossil driver HSLTAG will re- HSLINK.EXE to be in the current directory or in your path. HSLTAG 1.0 User Documentation - 7 - D. Tagger options. 1. When displaying files to tag them the tagger will not prompt you for which sudirectory files to display. Rather, it will go directly to the default subdirectory named in you configuration and display all files [*.*]. 2. The tagger will go to the default subdirectory named in you configuration and prompt you for file specifications. 3. The file tagger will prompt you for a subdirectory to display and for file specifications. Calling HSLTAG from your COMM program. Currently HSLTAG is known to work with Telix 3.21, Boyan 5.0, Procomm for Dos, Procomm for Windows, QModem and {COMMO}. Setting up HSLTAG to run from your communications program is simply a matter of setting up a macro key to call HSLTAG. Telix: A SLT file has been provided for Telix users. This file must be compiled using the Telix Script compiler. Boyan: Load Boyan. Enter Alt-C. Enter M. Enter H. Enter 79. Type: \DC[HSLTAG.EXE] Hit Return to Save. Hit ESC to Exit Macro configuration and ESC to return to your terminal. Another effective way to set up the macro would be to add HSLTAG to the external protocol options. To do this Enter CTRL-C. Press X for external protocols. Select one of the open lines and press the appropriate number for that line. In the first field enter HSLTAG. Enter H in the second field. Enter HSLTAG.EXE in the third field. Enter YES in the fourth field and in the fifth field Enter "HS*" ^B "R". This will automaticly call HSLTAG when Boyan detects the remote system is ready to send files. Simply press F4 when the HSLTAG menu appears. Procomm Plus for DOS: Hit ALT S. Go to External Protocols. Under A type "HSLINK" Under C Upload command: Enter HSLTAG.EXE. Under D Download Command: Enter HSLTAG.EXE. If using TAGFILE.EXE "External Protocol #2. E should say TAGFILE. Both G and H say TAGFILE.EXE. HSLTAG 1.0 User Documentation - 8 - Procomm Plus for Windows: Enter ALT-S. Double Click MetaKey and select one of the unused Bars numbered 1 - 9 and 0. You will see three boxes the first labeled "TYPE". Click on the first option in this box and select program.exe. In the next field "CONTENTS" enter "HSLTAG.EXE" without the quotes of course. Click the third field "LABEL" and enter "HSLTAG" - again without the quotes. Click the Save button. You will be returned to the setup box. Drop it's upper left corner and click save and exit. HSLTAG will appear on one of the meta bars at the bottom of the screen. Make sure all HSLTAG files and utilities are in your PROWIN directory or your path and that HSLINK.EXE, FHSLINK.EXE and HSCONFIG.EXE are located in the same way, in your path or in your PROWIN subdirectory. Now, a little about Windows. ...perhaps it is my inexperience with Windows but in my opinion it is brain damaged when it comes to commun- ications. If you run into high speed transfer problems here is a sol- ution which has worked with our beta testers. Get hold of a fossil driver such as Ray Gwinn's X00.SYS ( Available at Church Chatters BBS as X00V124.ZIP). Load the driver in your CONFIG.SYS. The following line works on com1. Device=x00.sys E 1 B,0,38400. If you are using a buffured 16550 UART (NS16550AFN) in your COMM port add a space after your speed and then F=15. The line would look as follows: Device= x00.sys E 1 B,0,38400 F=15 (B,0,38400 = Baud on COM1 = 38400) (B,1,38400 = Baud on COM2 = 38400) Read Ray Gwinns documentation if you want more information. Make sure your PROWIN is set at the same speed, your dialing directory is set to the same speed and that HS/Link is set to the same speed. If you do high speed transfers and run into problems it may be that you have a brain damaged UART. Using X00's utility XU.EXE type "XU S" at the dos promt and it will tell you what kind of chip you have. If you have anything other than a 16550 then you WILL run into problems with bi-directional high speed trans- fers. This seems to fake out Windows and HS/Link will run like a charm with these settings and the correct COM chip when using HSLTAG in PROWIN. External Utilities: ID.BAT = A batch file which comes with your HSLTAG package. It is called by HSLTAG when compressing your newly created DIZ and SDI files into the files they describe. HSLTAG pas- ses three parameters to this batch file. The first is the file name which the description file will be added to. The second is the name of the file to be added to the compressed file (File_id.diz or Desc.sdi ). The third parameter is the compression format. We left this as an external function so you may edit the batch file to do anything else you wish such as adding BBS ads or LOGO files. HSLTAG 1.0 User Documentation - 9 - Compression formats supported by HSLTAG are ARJ,ZIP, ZOO, LZH, PAK and ARC. The programs needed for these formats are ARJ.EXE, PKZIP.EXE, PKUNZIP.EXE, ZOO.EXE, LHARC.EXE & PAK.EXE. These util- ites can be found on most BBS systems. They must be placed in your path or in the directory from which HSLTAG is run. External Editor. I have been tempted to write my own editor for HSLTAG but have decided against it so as not to reinvent the wheel. The New DOZ format for RBBS can be editor intensive if you have a large number of files to describe. Plus, I always like to have access to my favorite editor so why not in HSLTAG. We use QEdit at Church Chatters and always have the most current version on line - Semware mails us their latest releases for the board. The last version we have received from them is QEDIT215.ZIP. HSLTAG comes with two executable files. HSLTAG.EXE and HSDIRN.EXE. HSDIRN.EXE is the tagger. HSLTAG shells to this utility. This is primarily because of the desire to not make HSLTAG.EXE too large HSDIRN.EXE must be found by HSLTAG in either your path or in the subdirectory from which you run HSLTAG. HSLTAG 1.0 User Documentation - 10 - License and Registration _________________________________________________________________ This program is not free! You are hereby licensed to use this program for a trial period of 30 days free of charge. If, after 30 days, you decide that you would like to continue using HSLTAG, you must complete the registration form (REGISTER.DOC) and return it to the author with the required registration fee enclosed. Registration removes the "UNREGISTERED" messages as time delays. Basic HSLTAG registration costs $15 US, which includes a proof of pur- chase. For $25 US, a disk containing the latest release of HSLTAG, along with a receipt can be obtained. Each registration is valid for use on a single CPU. Registration #'s will be assigned once we are out of the Beta phase of release 1.00. Please feel free to distribute unregistered HSLTAG to your friends and local BBSes as long as all of the files in this archive are included and unmodified. Send your registration payment to: THOMAS P. HANSEN 702 SHANNON.RD PAPILLION, NEBRASKA 68046 U.S.A. Your HSLTAG registered version may be picked up ON LINE if you care not to wait for the mail and will be posted for you in the personals section of our BBS off the main file menu. Credit card orders are unavailable at this time. Our BBS line is open 24hrs per day. Call: Church Chatters(tm) BBS 402-593-8863 14.4k v.32bis We may be reached through the RelayNET as Node ->OUTRIDER or (#693) FidoNET 1:285/30@fidonet.org InterNet @chat.omahug.org LICENSE AGREEMENT FOR SHAREWARE DISTRIBUTORS Shareware distributors may distribute this program as long as the author has been notified, in writing, prior to ANY distribution. The "per disk" charge may not exceed $6 and the shareware distributor will not change the above license fee for the end user of HSLTAG. End users are not exempt from registering HSLTAG with the author at the normal registration fee. DISCLAIMER IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. HSLTAG 1.0 User Documentation - 11 -