High Voltage Shareware

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

/ High Voltage Shareware / high1.zip / high1 / DIR10 / GDSTERM.ZIP / GDSTERM.DOC < prev next >

Wrap

Text File | 1993-04-20 | 17KB | 324 lines

GDSTERM and TTYHOST Documentation (c) 1993 GDSOFT April 20, 1993 This is limited documentation for GDSTERM.EXE and TTYHOST.EXE. Please remember that both of these program are BETA, and many changes may still be made. The terminal program is GDSTERM.EXE and the host module is currently named TTYHOST.EXE. Both program can be executed from the DOS prompt or from a menu. These two program provide for complete communications via modem between two computers. They both support downloads/uploads using XMODEM, YMODEM, YMODEMG, and any batch file protocol of your choice such as DSZ, HSLINK or TEXAS ZMODEM. CONFIGURATION FILES ------------------- You will notice that these programs are VERY small. One of the reasons, it that these files have been compressed with PKLITE by PKWARE. What this means is that in order to provide for such things as baud rate, com port, and other varible information, these programs use configuration files instead of writing the information back to the EXE file. Before using them, you will need to use a word processor or editor, and edit the GDSTERM.CFG and TTYHOST.CFG files. You should set which com port you are using, the HIGHEST baud rate that your modem will work at, initialization strings, upload and download paths, and a list of number you want to include in your dialing directory. The best thing to do is refer to the CFG files for examples of what everthing does. RUNNING THE PROGRAMS -------------------- Running TTYHOST is simply a matter of executing the program from the DOS prompt. After that, there is no interaction required from the user. There are configuration switches that can be turned OFF or ON. Make sure that you edit TTYHOST.CFG and set the values to your liking before you run the program. EXAMPLE CONFIGURATION FILE : (TTYHOST) PORT=2 ;modem port BAUD=57600 ;start baud rate PASSWORD=GDSOFT ;login host password AUTOANSWER=YES ;modem answers NOW or needs 2 ring callback BATCHFILE=D:\MODEM\ULDL.BAT ;batch for external transfers. MUST be defined BEFORE Protocols LOGONFILE=D:\MODEM\HOSTSM.ANS ;ANSI file for log on procedure ( DEFAULT = Built in screen) DOORFILE=\doors\doorrun.bat ;batch file name for DOORS HOSTNAME=GDSOFT HOST ;name of this HOST PROTOCOL1=~T~exas ZModem ;name of External PROTOCOL #1 PROTOCOL2=Hyper~P~ ;name of External PROTOCOL #2 INIT=ATZ&B1&H1&N0L0B0M1Q0V1X4S0=0S11=60 ;modem setup string Normally, TTYHOST will answer the telephone on the FIRST ring, and permit the caller to log on. However, notice the AUTOANSWER= switch. If you set this to NO, then TTYHOST will do something special. First, it counts rings. If it receieves two (2) and NO MORE within 15 seconds, then it starts an internal 60 second timer loop. For this 60 second period ONLY, it will answer the phone on the FIRST ring. After the 60 seconds, it goes back to counting rings again. This is useful if you only have one phone line, and have an answering machine and DO NOT want TTYHOST to answer if there is MORE than two rings. Make sure that you set your answering machine to something GREATER that two rings. To make it simple, here is the EXACT procedure to follow : 1. Call you number and let the phone ring TWICE ONLY !!! Hang UP !! 2. Wait 10 seconds and call back again, TTYHOST will answer. Another configuration file switch that might need explaination is the LOGONFILE= switch. Normally, TTYHOST displays it's internal log on screen. However, you might want to create your own. This screen MUST be an a file that contains ANSI escape sequences that can be displayed. Try out the shareware program THEDRAW for a great ANSI editor that can be used to create your file. You can name it anything you wish, just set the LOGONFILE=FILENAME in the configuration file. You can terminate the program and hang up on the caller at any time by pressing the the ESC key. GDSTERM.EXE is a full featured communications program with MANY built in features. I won't try to list all of them, or explain how each works in great detail, as I will assume that you are familiar with some other com program that has similiar capabilities. Here are a few of the important features and commands : HELP ---- The HOME key pops up a help screen and lists all of the commands that are available. Most of these are common such as PGDN for downloading files and PGUP for uploading. ┌─────────── GDSTERM : HELP ───────────┐ │ Alt C Clear Terminal Screen │ │ Alt D Dial The Phone │ │ Alt I Initialize Modem │ │ Alt H Go OFFLine (Hangup) │ │ Alt L Initiate Online CHAT │ │ Alt M Manual Dial │ │ Alt N Write Your Name │ │ Alt Q Host Mode │ │ Alt R Redial Last Number │ │ Alt S Dos SHELL │ │ Alt = DOORWAY Mode │ │ PgUp/Down UPLOAD/DOWNLOAD Files │ │ Home Display Help Screen │ │ CtrlHome Display Status │ │ F1 Buffer Control │ │ F2..F5 Execute Commands │ │ F6 Toggle Capture File │ │ F7 Dial Directory │ │ F8 Change UPLOAD Path │ │ F9 Change DOWNLOAD Path │ │ F10 Exit Program │ └──────────────────────────────────────┘ FILE TRANSFERS -------------- GDSTERM supports XMODEM, YMODEM, YMODEMG and ZMODEM using DSZ.COM by OMEN Technology and HSLINK by Sam Smith. You can also add other external protocols to GDSTERM and TTYHOST such as SZMODEM.EXE or TEXAS ZMODEM. Included with the files is a sample batch file for doing this (ULDL.BAT). This batch file is divided into TWO main areas. One for DOWNLOAD, and one for UPLOAD. Each of the five possible protocols has a section in each area named ONE,TWO,THREE etc. Simply add the necessary commands for any protocol to the section for protocol#1, protocol#2 etc. Study the ULDL.BAT file and I think you'll get the idea. TTHOST and GDSTERM outputs certain values to this batch file such as port, modem speed, file names and dowload directory. Next, you MUST modify your .CFG file so either GDSTERM or TTYHOST will know which protocol is in which slot. You will need a line in your .CFG file that looks like this : PROTOCOL1=~T~exas ZModem ;name of External PROTOCOL #1 The Tilde(~) character selects which the MENU key that will be displayed when you do DOWNLOADS or UPLOADS to select the protocol. Notice that in the example, Texas Zmodem is assigned to PROTOCOL1. It's THAT EASY !! If everything is setup properly, when you select a given protocol from the DOWNLOAD/UPLOAD menu (pgdn/pgup), TTYHOST and GDSTERM calls the batch file with the proper parameters and execution occurs at the place that you have defined for that protocol. YOU DO NOT NEED TO DEFINE a PROTOCOLx= for DSZ.COM or HSLINK. They are ALREADY built into BOTH TTYHOST and GDSTERM, and these programs with the proper baud rate etc are called AUTOMATICALLY. DIALING DIRECTORY ----------------- Access the dialing directory with ALT D or F7. ┌────────────────────── Dialing Directory List ──────────────────────┐ │ ┌────────────────────────────────────────────────────────────────┐ │ │ │ 01 Your Favorite BBS 555-1234 NO 57600 8 N 1 F CRT │ │ │ │ 02 GDSOFT 875-8133 NO 38400 8 N 1 F CRT │ │ │ │ 03 Compuserve - 9600 1-271-0016 YES 9600 7 E 1 F CRT │ │ │ │ 04 Compuserve (800) 1-800-331-7166 YES 9600 7 E 1 F CRT │ │ │ │ 05 CompuServe - LOCAL 294-8629 NO 2400 7 E 1 F CRT │ │ │ │ 06 Genie - 9600 1-424-4754 YES 9600 8 N 1 F ANSI │ │ │ │ 07 Genie Network 295-1550 NO 2400 8 N 1 F ANSI │ │ │ │ 08 EXEC-PC 1-414-789-4360 YES 57600 8 N 1 F ANSI │ │ │ │ 09 TurboPower BBS 1-719-260-9726 YES 57600 8 N 1 F ANSI │ │ │ │ 10 Canada REMOTE 1-416-629-7000 YES 57600 8 N 1 F ANSI │ │ │ │ 11 Dave's BBS 293-6465 NO 57600 8 N 1 F ANSI │ │ │ │ 12 SurReal BBS 262-9371 NO 57600 8 N 1 F ANSI │ │ │ │ 13 After Five 262-1370 NO 57600 8 N 1 F ANSI │ │ │ │ 14 Rusty & Edies 1-216-726-3637 YES 57600 8 N 1 F ANSI │ │ │ │ 15 Radio Daze 1-256-2297 YES 57600 8 N 1 F ANSI │ │ │ │ 16 Toolkit BBS 1-696-3415 YES 57600 8 N 1 F ANSI │ │ │ │ 17 Sam's Tool Shop 1-818-891-1344 YES 57600 8 N 1 F ANSI │ │ │ │ 18 Not So Perfect 1-312-237-8365 YES 57600 8 N 1 F ANSI │ │ │ └────────────────────────────────────────────────────────────────┘ │ └────────────────────────────────────────────────────────────────────┘ You can have up to 50 entries in each directory, and by selecting a different directory using the command line switch, you can access any number of different directories. By default, GDSTERM accesses the directory named GDSTERM.DIR. Manual dialing can be accomplished by pressing the 'M' key. You'll be shown a blank entry screen, and you can fill in the blanks. The data entered will not be saved. Use the PgUp , PgDn , , Keys to navigate up and down the list. Press F1 to edit an entry. You enter the name, phone number, long distance indicator, Baud Rate, Bits, and your AUTOLOG script for each entry. See the later section about AUTOLOG . ┌─────────────────────── Dial Directory Record ──────────────────────┐ │ ┌────────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ Name : GDSOFT Support BBS │ │ │ │ Number : 875-8133 │ │ │ │ Long Distance : NO Dial String : ATB1DT │ │ │ │ Baud Rate : 38400 │ │ │ │ Parity : None Stop Bits : 1 Data Bits : 8 │ │ │ │ Duplex : FULL Terminal : CRT │ │ │ │ │ │ │ │ Command String 1 : ? |YOUR NAME │ │ │ │ Command String 2 : ? |YOUR PASSWORD │ │ │ │ Command String 3 : │ │ │ │ Command String 4 : │ │ │ │ Command String 5 : │ │ │ │ │ │ │ │ Memo : You can use this are for any information that you │ │ │ │ want !!! │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └── Line: 3 Column: 1 22% ──────────────────────────────────┘ │ └────────────────────────────────────────────────────────────────────┘ After editing, make sure to SAVE the Directory with the ' F2 ' key. You will be given an opportunity at the point to enter a PASSWORD . Doing so will require ALL future users to know the password in order to use GDSTERM. Be CAREFUL about the PASSWORD , if you forget it, your in BIGGGG TROUBLE . Use the F3 key to select a NEW dialing directory. Enter the FULL path and file name. If the file requires a password, you will be prompted. Press ESCAPE on the password screen, and you will again be prompted for another directory file name. Press ESCAPE again, and the program will end. This feature give you the ability to have multiple directories on one machine, and each user can have their own directory. Once items have been entered, simply press ENTER(┘) , and GDSTERM will dial the number and process the AUTOLOG sequence for you. The dial string is IMPORTANT !!! It should be AT LEAST "AT". If you are calling a V.42 modem, it should be ATB1. If you are calling a modem the REQUIRES compression to be off such as Compuserve 9600, it should be ATB0. If you want to call a MPN modem, it could be ATM5. Refer to your modem manual for more information about this. The important thing is that EACH LIST item MUST be on ONE line, and contain the necessary information in order to work !!! NO SPACES PLEASE between the commas !! AutoZMODEM Feature : -------------------- MOST BBS systems around the country support the very popular DSZ implementation of ZMODEM, and HSLINK by Sam Smith. If you one of these protocols as your primary transfer protocol on these BBS systems, GDSTERM will recognize the ZMODEM or HSLINK header that is transmitted during file DOWNLOADS , and automatically begin the download for you. You do not have to do ANYTHING except to tell the BBS to send the file !!! GDSTERM will do the rest. You might want to use F9 to set the directory where the downloaded files will be put. This function may be disabled by setting the switch in the configuration file. AUTOLOG feature : ----------------- Many communication programs uses SCRIPT files to automate communication sessions and for automatic log-on to BBS's. GDSTERM implements an approach to this SCRIPT mechanism at least for log-on purposes. The last 5 fields of the Dialing Directory record are for "command strings". After dialing an entry, GDSTERM will use these strings to "LOG ON" to the BBS that you call. The value BEFORE the '|' is what GDSTERM is looking for from the other modem. Once it sees this "WAIT STRING", it then transmits the string on the other side of the '|'. Here is an example command string : Enter your name:? | Gayle Davis ^WaitString | ^Send String Often, you'll want to wait for or send control characters. This is how you would do that : #10 | #13 WaitChar^ | ^Send Char Of course what this is is the decimal equivilant of ^J or a linefeed. Take special notice of the '#' pound sign. This is a MUST !! Once GDSTERM gets this character, it would transmit a CR which is decimal character 13. Multiple wait/send characters can be sent like this : #10#10 | #3#13#13 WaitChar^ | ^Send Char This would cause GDSTERM to wait for TWO linefeed and then send Ctrl C (003) and two carriage returns. This AUTOLOG process can be interrupted by pressing ESCAPE , and GDSTERM will set and wait only so long before it timesout in which case you will have to attempt to log on manually. This function may be turned ON or OFF by setting the switch in the configuration file. PROGRAMMABLE FUNCTION KEYS -------------------------- Function keys F2 - F5 can be programmed to call ANY program that you choose. To do this, include a command in your config file like this : F2=LIST.COM or F3=FM.EXE Assuming the program exists, and can be found where you say it is, pressing the appropiate key will execute it when GDSTERM is running. This is handy for looking at files with the FILE MANAGER or doing some other necessary work. GDSTERM WILL NOT look for the file on your path, so a complete path MUST be included for the file to run.