Current Shareware 1994 January

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

/ Current Shareware 1994 January / SHAR194.ISO / modem / smtv11.zip / SMT.DOC < prev next >

Wrap

Text File | 1993-09-30 | 49KB | 927 lines

[S]cript [M]odem [T]erminal Copy(c)right 1993, Gary Raymond, New Orleans, La. ═╡▓▓╞═ A Multi Purpose Batch and Script Driven Terminal ═╡▓▓╞═ ▓▒░ Script Modem Terminal Registration ░▒▓ Order your Registered Copy $19.00 plus $1 ship Today! Gary Raymond POB 8184 New Orleans, La. 70182 (504) 288 6550 voice SMT Ver 1.1 Release Date: Oct 1st, 1993 =========== [S]cript [M]odem [T]erminal is a multi function script driven communications terminal with built in TTY,ANSI emulation. SMT is designed for a wide variety of unusual applications. SMT is configurable to use ANY serial port paired to ANY IRQ line. SMT will work with ANY baud rate (as long as the baud speed is supported by your modem) and ANY standard line settings. SMT requires less than 40k of memory and is therefore ideal for many of the older, slower single drive PC's. Most of SMT's unique functions can be totally automated through the use of innovative script files that can be loaded from a simple batch file. Example Uses: Calling the NBS atomic clock and setting your PC's internal clock. This can now be totally automated from your PC's autoexec file if desired or necessary. Calling your Alpha Numeric Pager and dispatching a text message. Quit paying high rates to your paging vendor for dispatching text messages to your Alpha Numeric Pager. Calling Public and Private Library databases in Schools and Colleges. Great for schools etc. to connect with the Library databases of larger Universities and Colleges as well as numerous Municipal or Public Libraries providing on-line services. Calling your favorite BBS to check for new files and saving the info. Script Terminal comes with our own external EZProtocol engine and is therefore able to do fully automatic Zmodem downloads from your favorite BBS. EZP also supports X,Y and SeaLink protocols in addition to Zmodem. Calling any on-line BBS such as BloomUnit or Channel One that sends ANSI BBS Music to amuse your children. Yes, SMT can decode and play ANSI BBS Music too! The things Script Modem Terminal can do are only limited by your imagination and ability to use a text editor or word processor. Aside from having all the power derived from using an interrupt driven (ISR) serial interface, SMT has many other features normally only found in full blown terminal packages. Some of these features include the TIME LOGGING of calls, session ACTIVITY LOGGING, complete script control and EXECUTION of EXTERNAL dos commands, including dos APPLICATIONS, utilities, file transfer capability, DOORWAY terminal mode, and COLOR configurability if desired. SMT can also be used as a powerful feature packed communications terminal too! You can try this immediately by loading one of four sample "terminal ONLY" script (SMT1.STF) files we provide. (use 1,2,3 or 4 depending on your active COM port). To load SMT with a script file directly from the dos command prompt, type "SMT SMT1.STF" (assuming COM1). Or, for truly automated operation, load via a batch file (the preferred method). Four sample script files for loading SMT as a basic terminal are included. They are SMT1.STF through SMT4.STF. SMT1 will activate COM port 1 (3F8) using IRQ4 and so on. For any non standard pairing of port address and irq lines, it will be necessary to edit one of the sample .STF files to meet your exact requirments, or you may create new ones. It is also considered good operating practice to make sure there is a DOS PATH assigned to the directory you have located all of the SMT files. CONTENT of SMT2.STF (included and preset to COM2 [2F8], IRQ3) --------------------------------------------------------------------- 2F8& >3F8/2F8/3E8/2E8/3220/3228/4220/4228/5220/5228 hex IRQ3| >IRQ2/IRQ3/IRQ4/IRQ5/IRQ6/IRQ7/IRQ8/IRQ9 2400~ >300/1200/2400/4800/9600/12000/14400/16800/19200/57600 8N1+ >8N1,8N2,7E1,7E2,7O1,7O2,7M1,7S1 (data/parity/stop) ComOn= >must have to activate the above port settings 48" >set background color to cyan, foreground to black CLR_ >clear the screen and set the new colors AT&C1&D2V1X4S0=0 >sample of modem initialization string OK@ >waits for OK response from modem before proceeding SIGNAL$ >rings bell to signal completion of script END# >end script (end command is optional but nice) REMEMBER: If you are using either a non standard port address or interrupt (IRQ) request line, you will also need to edit an existing .STF file or create a new one. If you already have a favorite text editor, it can be used to create or modify script files. If you do not have a basic text editor, PED.EXE (Pro Editor - my shareware editor is included in this archive). The dos COPY CON directive can also be used to create text files as a last resort if necessary. The content of DT.BAT (used to load and run SMT as a basic ansi terminal using COM2 at 2F8/IRQ3 is: SMT SMT2.STF M The letter "M" is an optional 2nd parameter switch that activates an internal music function to plays an old Air Force tune "Off we go, into the wild blue yonder..." for the three seconds the opening screen is displayed. Remove the "M" switch to Stop the music, add the "M" parameter to hear it play. Also note that the opening screen, SMT.WEL can be edited to your requirements or eliminated if you have no use for it. If you re edit the file to suit your own special needs, keep it under 24 lines, otherwise it will scroll off the screen. The same internal music decoder automatically captures and plays ansi bbs music when it is transmitted from the host along with regular ansi screen graphics. Toggling ansi off will also toggle off the ansi music decoder. ============================================= SMTV11.EXE Self UnPacking Archive contents: ============================================= SMT EXE Script Terminal program SMT DOC DOCUMENTATION READ COM Self displaying DOCS (use via Alt-V in STM) SMT WEL WELcome file (SMT opens with this) *optional SMT HF1 Help File 1 (how to run) *optional SMT HF2 Help File 2 (Hot key info) *optional PED EXE Text Editor for Script Files PED DOC Documentation for text editor. EZP EXE EZProtocol Engine for X,Y and Zmodem EZP DOC EZProtocol Doc file SMT1 STF Samples Run SMT as basic terminal: COM1,3F8,IRQ4 SMT2 STF "" Run SMT as basic terminal: COM2,2F8,IRQ3 SMT3 STF "" Run SMT as basic terminal: COM3,3E8,IRQ4 SMT4 STF "" Run SMT as basic terminal: COM4,2E8,IRQ3 NBSCLK STF "" Script file to call NBS and set time ANPAGE STF "" Script file to call Alpha Numeric Pager COMPUSER STF "" Script file to call CompuServe EXECPC STF "" Script file to call EXECPC BBS in Milwaukee TULANE STF "" Script for Tulane University's Library Dbase NOPUBLIB STF "" Script for N.O. Public Library System Dbase R1 BAT sample batch to load SMT automatically COM1 R2 BAT sample batch to load SMT automatically COM2 R3 BAT sample batch to load SMT automatically COM3 R4 BAT sample batch to load SMT automatically COM4 ZR BAT used by SMT to do auto Zmodem downloads UTIL BAT used by SMT to run any external program COLOR EXE Color Palet you can use to pick color value *SMT TYM User date/time logging file *SMT LOG Session log capture file *created dynamically by program at runtime ___________________________________________________________________ CHECKING YOUR PC FOR ACTIVE SERIAL PORTS ---------------------------------------- SMT has built in serial diagnostics that can be used to pre test your PC's RS232 serial ports for activity, type "SMT TESTPORT" at the dos prompt. You will then receive a diagnostic report similar to the following: Port 1 (COM1 address 3F8 hex) responding! 8250 UART detected! UART set at 2400 Baud. Port 2 (COM2 address 2F8 hex) responding! 16550 FIFO UART detected! UART set at 1200 Baud. The test will echo what standard IBM default ports are installed, what baud they are presently set for, and what type of UART chip is installed in your serial card(s). Note: The presence of a UART by itself does not mean there is a modem connected to it. It might be for a mouse or other serial device. This test assumes the following com addresses: COM1=3F8, COM2=2F8, COM3=3E8, and COM4=2E8. ------------------------------------------------------------------- STATUS LINE, LINE 25, appearing at the bottom of SMT's main screen. ------------------------------------------------------------------------------- COM=2F8 IRQ3 Baud=57600 Line=8N1 Script=TERM Date: 9/26/93 -> ExitScript ------------------------------------------------------------------------------- The status line is fairly easy to interpret. All of the serial ^ parameters set by your script are echoed on the left side starting | with the hex address of the com port. In the center, you can see | the name of the script file presently running followed by the PC | date. On the extreme right hand side is the STATUS WINDOW. Here you | will see various messages appearing from time to time as things | dynamically change in the terminal environment. This window is ------ also used when you invoke the Alt R hot keys to enter a new script to load and run. Hot Key Operational function ======================================================================== Alt A > Toggle Ansi color/graphic display on or off. Alt B > Send the Modem a break signal. Alt C > Clear the terminal screen. Alt D > Drop to Dos Alt E > Set CON to Echo keystrokes. Alt H > Hang Up the phone line (Drop DTR) Alt J > Run external UTIL.BAT (run utility or external protocol) Alt L > Toggle Log capture file on or off. Alt M > Toggle HangUpDelay (one or five seconds) Alt P > Toggle Line Printer (LPT1) on or off. Alt R > Run a Script file Alt S > load Script Editor (PED.EXE) *Alt T > Toggle TimeLog record keeping Alt V > View/Read Doc File (or any file called READ.COM or READ.EXE) Alt X > Exit/Quit Terminal and return to dos. Alt Z > Show Hot Keys (this screen) Alt = > Toggle DoorWay Mode (causes term to precede the sending of the key scancode with a null character). Special use keys: ------------------------------------------------------------------------ <Esc> Key Aborts active script operation. Space Bar Jumps to next script command Ctrl Break Aborts entire program (crash exit - last option) Ctrl Home Diagnostic monitor mode performs no translation on incoming bytes, displays on screen as raw character data. ======================================================================== * The logging of calls [to the SMT.TYM file] (normally on) can be deactivated by setting a third "X" parameter on the command line or in a batch that runs SMT. Example: To stop both music and time logging, the command prompt should look similar to this: SMT MYOWN.SFT X X To have music but NO time logging: SMT MYOWN.SFT M X To have music with timlogging: SMT MYOWN.SFT M To have NO music but with timlogging: SMT MYOWN.SFT SCRIPT OPERATION: Activated via the command parameter line. ------------------------------------------------------------- What is a script language? ----------------------------------- To facilitate many automatic modes of operation, Script Modem Terminal uses a very friendly, yet powerful SCRIPT capability that can, among other things, provide fully automatic logon's to your favorite BBS or network service. This is a great convenience for those power users (or lazy people too) who logon for mail and new file checks every day. There are currently thirty two SCRIPT commands that cover most all general communications requirements! What kind of file contains the script commands? ----------------------------------------------- A simple ascii text file. Each command must be delimited by a crlf pair (in other words, placed on separate lines!) in the ascii script file. Any text or ascii editor can create or modify .STF files including the dos COPY CON function. Can anyone learn a script language? ----------------------------------- If you have avoided using a SCRIPT language in the past because you either did not have the time to figure it all out, or thought using scripts was too complicated, STOP! SMT MicroScrpt is for you! Yes, SMT's new MicroScrpt method is designed with the laymen in mind! I guarantee you can learn the basic concepts in less that five minutes, no more time than it takes to read this section! Using SMT's Micro Scrpt commands is rather intuitive. For anyone with even minor programming skills it is child's play. But, even if you are completely new to programming, there is very little technically that needs to be learned. Here is the gist of basic script programming. After your modem connects to a host (BBS etc), it begins to receive characters and is capable of sending characters through the modem and phone line. The characters received through the modem (that are originating from the host), wind up either printed on your PC screen or sent to a file on one of your disk drives, or both. This depends upon your prior instructions or the terminal programs default setup options. Characters sent out (or transmitted by you) either originate from your keyboard, a file you are uploading to the host or a SCRIPT! Your script also instructs the modem on what string of characters to be on the lookout for before proceeding with additional tasks. How does a script file actually work? ------------------------------------- The basic scenario goes like this. You log on and wait for the host to prompt you for your name at which time you send it. The prompt (as on CIS) may be as simple as "Name:" (without the quotes). So what the script needs to look for is a match of characters equaling "Name:". The command "Name:@" causes the terminal to wait until it receives an exact match, character for character - case tested, before proceeding with the next script instruction which will of course be the sending of your name (also the next line in script) "Gary Raymond!". This will normally be followed by a prompt from the host again asking for your password (or in the case of CIS [CompuServe]) your "User ID:" which you in turn wait for with "User ID:@" on the following line of your script; again followed on another line by "70613,3165!" (my CIS userid). By now you should be getting a good picture of how this basis operation works. Additional script commands can be used to set the line parameters of the modem with parity, data length, stopbit and baud before dialing out with a standard Hayes dialing string. You can also signal, capture the screen, invoke delays, turn on the log file, upload and download among the fifteen commands. Sample .SSF files are included in the archive for connecting with CompuServe and EXECPC. With a little study and effort, you will soon be writing your own script files. Welcome to the beginning of programming! Once your script is written, your first task will be to test it for correctness of operation and fix any bugs. The end of this section has information on using SMT's built in debug cmnd. It is a good idea to keep your script files located in the same directory that you have placed SMT.EXE. This is because SMT first looks there before looking elseware. You can Abort a script at any time by pressing the <Esc>ape key. When a script is running, all keyboard keys are inactive except for the Escape and Space key. To prevent endless loops occurring from unanticipated prompts coming from the host, an automatic timeout default will send the host a carriage return if nothing happens for ninety seconds after the last script command. You can override the default value of ninety seconds by use of the script timeout override command [/] (Example: "15/" changes the timeout value to fifteen seconds). Experience will dictate the circumstances when you will want to use this function. How do you begin to write a script? ----------------------------------- Assuming you have already looked over the sample script files that came with the archive package and have read the documentation up to this point, you are ready to take the next step. To write your first script file, you need a simple ascii editor such as PED.EXE that we provide. If you have a favorite editor that you are already familiar with, so much the better. You will save a little time bypassing the learning curve associated with using a text editor. The suggested method to start coding a script file for a particular system is to first run SMT in the regular terminal mode (as explained in the first paragraph) and then manually dial the targeted system, and wait for a CONNECT with SMT's log file capture option "toggled on" (via Alt-L). Assuming you have used this host service before and are therefore familiar with it, logon and manually navigate through the various prompts until you arrive at the location you wish your script to leave you. This will record (in SMT.LOG) all the necessary prompts that the host sends and that you in turn must respond to. Most users just want to use a script to do the essential rituals of setting baud, parity, dialing the remote, passing user name and password. Once you have captured this session into the log file, hangup and return to dos. The proper method would be using Alt-H followed by Alt X. I suggest renaming the log file (SMT.LOG) to a file handle (name) of your choice and adding the .STF extension. Now it will be necessary to do a doing a little trimming and soon the old log file can be converted into a script file. Triming the file will consist mostly of eliminating blank lines and shortening prompts (to just a few key characters that cannot be missunderstood for any other intermediate prompts) and adding the correct command tails to the remaining prompts and replies etc. The key insights to understanding a SMT script file can best be realized by examining the actual script files printed down below. First, here is a summary of SMT's MicroScrpt commands. NOTE: The tilde character cannot be actually shone in this text because it is a cmnd character for the text display engine. Code [explanation] Example ___________________________________________________________________ [&] = COM PORT expressed in hexadecimal --------> 3F8& [|] = IRQ Line expressed as a decimal --------> 4| (IRQ4| optional) [tilde] = Change Baud Rate 300[tilde] [+] = Reset Data,Parity & Stopbit 8N1+ *[=] = Activate above rs232 settings ComOn= [*] = wait x second (1000 = 1 second) ---------> 1000* (use milliseconds) [!] = send a string out port ATDT288-6550! [@] = Wait Until (look for incoming string match) UserID?@ *[$] = sound a signal SIG$ *[%] = hangup or drop carrier HANGUP% *[-] = Tog local Echo ECHON- *[#] = mark end of script (optional) END# [/] = Set escape delay time in whole seconds 10/ [:] = Run External program Q.EXE: *[?] = Wait for KeyPress WAITKEY? *[_] = Clear the screen CLR_ *[^] = Toggle auto det/ANSI ON/Off TOGANSI^ *[.] = Exit script if carrier dropped NCEXIT. *[`] = Quit SMT (return to DOS) QUIT` [,] = load second script file in case BUSY NEW.STF, [>] = send control code (byte) out port 13> (send carr return) [<] = trap control code (byte) from port 27< (wait on escape) *[{] = Wait until no carrier or keypress NOCARRIER{ *[}] = Wait until carrier or keypress CARRIER} *[(] = Activate DOS Time Setting function GETIME( *[;] = Your local GMT Offset in hours GMTOFF=5; *[)] = Debug Script DEBUG) *[[] = Interactive Hotkey reply no/cr) YESNO[ *[]] = Interactive String reply w/cr MYREPLY] ["] = Terminal color setting 31" [\] = Toggle Log File and pass file handle MYLOG.LOG\ --------------------------------------------------------------------- *These commands can actually be preceded by your own preferred mnemonic memory word as the characters preceding the command do nothing more than carry the command and act as code comments. All Scripts should terminate with the [#] end command or the [`] quit command on the last line in order to properly return control to the terminal keyboard or exit to dos. --------------------------------------------------------------------- Setting Terminal Screen color: ============================== The ["] quotation symbol is the color setting command character. Use the COLOR.EXE palet utility that came with the archive package to pick the background foreground color combination. Example: From the palet you will note that the attribute value for a Blue background with bright White letters is decimal 31. Next, when editing your script file, enter 31" on a line at the top of the script, all by itself. Its that easy! SMT FAQ --------- What happens if a number is BUSY while using a script? ------------------------------------------------------ An automatic re dial on BUSY has been incorporated into all releases from V6.5. This re dial function is tied to the timer dropout trigger (default 90 seconds). Meaning that if you do not override the 90 second default, the re dial will stop after a minute and a half if a CONNECT is not achieved. If you wish to allow the modem to sit and dial longer, use the set timer command [/] to adjust the timer up or down accordingly. Example: If you wish the re dial to continue for 10 minutes, use "600/" on the line preceding the dial command string in your script file. (600 seconds = 10 minutes). CAUTION: Remember to reset the timer to 90 seconds (original default) or whatever you require. You may chain one script to another in the event of a BUSY or NO CARRIER modem reply. To chain a script, add the next script file name on the line BEFORE you place the modem dial string. Example: etc etc NEXTSTF.STF, ATDT*70,1-504-288-6550! etc etc SMT will remember the chained file and if the number continues to ring busy past the time allotted for re dials (90 sec is the default) the next script will begin to run. It is entirely possible to chain several (as many as you want) files into a loop that will operate until you stop it. To form a chain loop simply have the very last script file calling the very first again. NOTE: A NO DIALTONE modem replies will cause the script file to disengage and return to terminal mode automatically. This usually indicates your phone line has become disconnected or went dead. SAMPLE's of STF Files Included in this package ---------------------------------------------- NBSCLK.STF Script to set DOS TIME from NBS ============ atomic clock. String + Code Explanations: ================================================================ GMTOFF=5; > set your local time offset from GMT 2F8& > COM2 IRQ3| > IRQ3 1200~ > set baud 8N1+ > set line ComOn= > initialize port 100* > delay one tenth a second AT&D2B1%C0N0&Q6! > send modem initialization string OK@ > wait to confirm modem got it ok 100* > delay a bit ATDT*70,1-202-653-0351! > dial number of NBS GOTCARRIER} > wait for carrier before proceeding UTC@ > wait for UTC prompt GETIME( > activate SMT TimeSet function SIGNAL$ > signal when through END# > return control to terminal ----------------------------------------------------------------- ANPAGE.STF Script to send AN Pager message ============ AN = Alpha Numeric Script Pager String + Code Explanations: ================================================================ 2F8& > set your port IRQ3| > set your IRQ 300~ > ALL AN pager hardware uses 300 baud ONLY! 7E1+ > ALL AN pager (IXO) uses 7E1 line settings ComOn= > AT&D2%C0B1N0&Q6&W! > OK@ > 300* > ATDT1-301-000-0000! > dial Vendors hardware (not pager itself) CONNECT@ > wait for 300 baud CONNECT 100* > delay a bit 13> > send a carriage return 100* > delay a bit 13> > send second carriage return ID@ > wait until system request ID M! > then send M for manual or id number if used. RETURN.@ > wait for prompt to send PIN number 12345678! > send PIN number RETURN.@ > wait for prompt to send message, then send Joe, this message sent by our new SMTV11 software, Gary! RETURN.@ > wait for prompt for next PIN Number HANGUP% > then hangup SIGNAL$ > send signal all is finished END# > and return to terminal. ----------------------------------------------------------------- EXECPC.SSF Script to logon to EXECPC BBS ============ and check for new files. String + Code Explanation: ================================================================ 2F8& > set port address in hex (must be on line one) IRQ3| > set Interrupt Request line (must be line two) 14400~ > set baud (line three) 8N1+ > set line parameters (line four) ComOn= > now initialize serial port as instructed ATV1X4&C1&D2%C0N0&Q6&W! > send your modem initialization string 100* > wait a moment for modem to swallow OK@ > look for OK from modem 100* > wait a moment for modem to swallow ATDT*70,1-414-789-4375! > dial the number CONNECT 14400@ > wait for CONNECT message before proceeding ? (y/N) ->@ > wait for this prompt N! > then send "N" RST name ->@ > wait for this prompt requesting your first name Gary! > then send it AST name ->@ > wait for request for last name Raymond! > then send it Password ->@ > wait for request for password xyzxyzxy! > then send it updates) ->@ > wait for request to read bulletins N! > say N for No ?=HELP) ->@ > wait for main menu F! > say (F)iles ?=HELP)->@ > wait for files directory menu A! > say A for Mahoneys directory BEEP$ > beep that your there END# > leave the script and enter terminal mode ----------------------------------------------------------------------- TULANE.STF Script to logon to Tulane ============ University's Public Library String + Code Explanation: System in New Orleans. ================================================================ 2F8& > By now you should have the gist of IRQ3| > the repetitive set up commands so I 1200~ > will advance down to more specifics.... 7E1+ > Log into VAX at 7E1 ComOn= > 100* > AT&D2B1%C0N0&Q6! > OK@ > 100* > ATDT*70,865-5088! > CONNECT 1200@ > 1000* > 13> > D,E,F):@ > C! > SERVICE?@ > LIBRY! > CONNECTED@ > after leaving VAX 13> > 100* > 8N1+ > reset line to 8N1 100* > 13> > AL TYPE:@ > VT100! > use VT100 for closest compatability with ANSI BEEP$ > END# > go on to do your research............ ----------------------------------------------------------------------- NOPUBLIB.STF Script to logon to the New ============ Orleans Public Library String + Code Explanation: System in New Orleans. ================================================================ 2F8& > REMEMBER...you must adjust these first IRQ3| > two line to match your modem if necessary 1200~ > 8N1+ > ComOn= > 100* > AT&D2B1%C0N0&Q6! > and this string too! OK@ > 100* > ATDT*70,595-8930! > add 1-504- if out of Louisiana CONNECT 1200@ > login:@ > nopline! > mulation :@ > 3! > 100* > (Y/[N]) ->@ > N! > BEEP$ > END# > you are now in.....do your thing. ----------------------------------------------------------------------- COMPUSER.STF Script to logon to ============ CompuServe Network String + Code Explanation: ================================================================ 2F8& > change if required to your port IRQ3| > your IRQ 300~ > your desired baud speed 7E1+ > keep this line setting ComOn= > 100* > AT&D2B1%C0N0&Q6! > use your modem string OK@ > 100* > ATDT*70,734-8150! > use your local CIS node CONNECT@ > 1000* > 13> > Name:@ > CIS! > User ID:@ > 70613,3165! > use your userid, not mine Password:@ > ABCD! > use your cis password, not this bogus one BEEP$ > END# > your in CIS! ----------------------------------------------------------------------- NOTE: TWO things may require altering timing values and or choices of other wait state commands or modem set up strings. One: the clock speed of your PC's CPU and Two: the specific model modem you have installed. HINT: The modem initialization string in any pre existing AND functional communications program will probably also work in SMT. After trying a pre functional modem string, if you are still having problems, call or e-mail me with all the particulars. ANOMALIES: ========== If for any reason you find a command character as the last character of a necessary search string, just add it twice. Examp: "countx@@" Occasionally there are some circumstances when the use of string replies are inappropriate for the circumstances. A typical example occurs when you try to log on to the TeleNet system at 2400 baud with the required "@D" attention string. Various factors, prior to the network switching to the Display Terminal Mode (via Terminal type = D1) require slight delays or pauses in between the required network command characters. So whereas the string "@D!" wont work, sending the required two characters plus a carriage return with a slight pause in between both characters will work. EXAMPLE: The following five lines of code beginning at line three will replace the "@D" string. Note that the characters must be expressed in their ascii decimal character value equivalent. (this facilitates the sending of certain non printable control codes like ctrl c etc.) For a complete listing of ascii characters with their decimal and hex values, refer to your dos manual. ATDT000-0000! CONNECT 2400@ 64> | @ = dec 64 100* | delays are expressed in milliseconds 68> | D = dec 68 100* | hence 100 equals one tenth of second pause 13> | a carriage return equals dec 13 If you want to send a control code to the host, the [>] command requires the preceding control code value to be in decimal form. Check your dos manual for additional information. Examples: --------- 13> will send a carriage return 32> will send a space 24> will send Ctrl-X 3> will send Ctrl-C etc. --------------------------------------------------------------------- to send the equivalent of Alt-B, first send a null, then the scancode. 0> null 48> scan code for Alt-B --------------------------------------------------------------------- TROUBLE SHOOTING ---------------- Putting "DEBUG)" on the first line of a script (or on any line you wish to begin debuging from) will echo the script commands to the monitor AS THEY EXECUTE. This will allow you to follow the progress of a script as it carries out each command. More importantly is allows you to see visually where trouble spots and hangups may be located. If you typo'ed and or used an invalid command character, DEBUG will also inform you of that as well. Remember, no matter how poorly your script is designed, you can always break out of most bad situations with the <Esc>ape key. In addition to the Escape Key, a tap to the Space bar will cause the script operation to jump to the next command while looking for a string match that, for whatever reason, is not occuring. Every effort was made to design SMT's script operation as intuitive and user friendly as possible. As usual, your comments and suggestions are solicited. NOTICE: All modems are NOT created equal! Ninty Nine.Nine percent of any problems you experience will NOT be with this software! The reason I can make this claim with certainty is that this product has been in use in various educational facilities around the south for several years as a custom product. I have decided to release it as shareware because many colleges and universities are now allowing the tax payers access to their various information databases, including their Library files. This program is intended to be used by the ordinary "access hungry" public who want completely automated communication features, not the typical hobbiest and or avid Telecommunicator who likes driving his modem directly. If you experience a problem getting SMT to work as claimed I will be happy to help you iron out glitches that have known work arounds. But, I cannot make your non standard modem conform to either Hayes, Bell or CCITT standards. I cannot eliminate your modems supseptability to line noises (spikes etc). I cannot make your new fancy high speed modem work at 300 baud if that speed was not supported by design [300 baud only is used by the Telocator IXO Alpha Numeric Pagers]. You should also be aware that the overall proformance difference between 2400 baud modems made over two years ago and those made today are the differences between acceptable performance and NO performance at all. GOOD current state of the art hi tech 2400 baud modems can be bought today for under $30. There is no reason not to upgrade if you have a serious need to use SMT. If you have a reasonable decent, noise free modem and still experience some glitches, most of it will probable be related to timing constraints between the speed of your PC's cpu and that of your UART's (modems) response time. These types of problems can generally be solved by adjusting and or placing timing delays of various types at particular places in your script file. Example: Typical problem; after setting up the modems port and sending the modem initilazation string, the first letter of the string gets lost! Solution: Place a small delay of say one hundred milliseconds between the ComOn= command and the string [100*], then another longer delay between the string and the first wait for "OK" [1000*]. Bottom line, you will have to tinker a bit with some hardware no matter how state of the art it is. Site Licensing Script Terminal Software -------------------------------------- Policy Effective Date: July 1st, 1993 Attractively priced site licensing is available for commercial users of SMT Terminal. Pricing for "typical" site licensing is forthcoming in this document. If you have needs which are not met by the standard license terms as outlined below, please call or write for a quote which addresses any unique support or custom product requirements. Special corporate customization is available on a PUR contract basis. Upgrade Policies ---------------- There are no upgrade charges presently associated with SMT software and I do not have any plans at present to institute such charges with future revisions. I do reserve the right to change this policy however, if in my sole opinion the nature and magnitude of SMT changes to such a degree as to constitute a substantially new product. For users unable to obtain access to current versions of SMT software via the electronic bulletin boards (my normal means of distribution), I currently charge a nominal fee of Five Dollars for supplying upgrades or current releases on diskette. On original registrations, the shipping and handling fee for the most current release on diskette is only One Dollar. I plan to continue this practice for the foreseeable future. This upgrade disk fee is subject to change without notice, however, to accommodate postage, printing, and other price increases. TECHNICAL SUPPORT ----------------- Registered Users: Full technical support is available to registered users of SMT software. I have found that the most effective product support can be delivered through the electronic services listed below. Technical Support: ---------------------------------------- E-mail Gary Raymond @ CompuServe User ID# 70613,3165 This Board BBS (504) 887-0051 EXECPC BBS (404) 789-4210 If any of these options are not open to you, I also offer full product support through the US mail, or, if the problem absolutely cannot wait, my voice telephone (no collect calls please). I will do my best to resolve any software bugs in a timely manner and I am always open to suggestions of new features or changes which are appropriate to the nature of the product. Non registered users: I will attempt to respond to software trouble reports made by non registered users if the problems concern the general functionality of the program. Such users should not, however, expect product support beyond initial aid in determining whether the program is suitable for their needs. IF YOU HAVE A PROBLEM: I ask that, before calling or writing, you take the following steps: 1) Read the documentation. We all sometimes approach a piece of software with preconceived ideas about how it should work which may not correspond to how it actually does work. (Of course, I'm interested in your input if you have this sort of experience.) 2) See if you can duplicate the problem with the original, unmodified version of SMT Terminal. (You do still have an original, unmodified backup version, don't you?) 3) If you're still having problems, please make a note of a) your PC hardware (processor, memory on board, drives etc) the operating system software and version number; b) your modem manufacturer and model number as well as the modem initialization string you are using. SMT is a very configurable program and, unfortunately, one of the down sides of this configurability is that user-defined settings can sometimes interact in unexpected ways. Finally, item c) the sequence of actions which lead to the error. If I can't reproduce the problem, it will be very difficult to correct, so your help is vital in isolating the problem. If you follow these steps, it will help me to solve your problem in a more efficient and timely manner. --------------------- General Site Licenses --------------------- Site Licenses are available for SMT Terminal. The rates below are for a "basic" site license. This includes a single corporate registration code for the specified number of copies and technical support to one authorized corporate individual. $19 1 regular registration with disk and file docs. -------------------------------------------------------------------- $15 2-5 registrations as outlined above. $12 6-9 "" $10 10-19 "" $8 20-29 "" $6 30-99 "" $5 100 up "" -------------------------------------------------------------------- Unlimited $2,500 "" The above schedule means that the first copy is $19, the 2nd through 5th copies are $15, and so forth. (The exception is the Unlimited License, which represents the Total license cost for any number of same company and or corporate site installations.) This Unlimited License shall include customers who deal direct with the licensed corporation as long as they are so involved. The Unlimited License shall not be deemed to convey any authority or licensing to resell, wholesale or retail SMT Terminal Software to other companies, corporations or individuals. SMT Terminal is currently licensed by a wide range of companies and government agencies. I'd like to see you on that list! LIMITED LICENSE: ================ You are hereby granted a limited license to use SMT for the next ten days, after which you are required to send your Nineteen Dollar registration (plus one dollar shipping) to continue operating Script Modem Terminal. The advantages of Registration are 1) You receive the latest registered release which eliminates any opening and closing advertisements. 2) You will be entitled to friendly telephone support at no additional charge. 3) You will be eligible for all future upgrades free of upgrade charges. This shareware demonstration version is FULLY operational and NOT crippled in any fashion. Name ____________________________________ Address ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ Phone (_____)_____-______ Where did you get SMT from: BBS / Service Name ______________________ Number (_____)_____-______ SMT Registration w/ diskette & file docs $ 19.00 each $ _______ Shipping (postage/ups) and handling $ 1.00 $ _______ Total $ _______ (the basic registration fee includes product support, a diskette with the latest release and all associated files and file documentation). To register, please return this form with your registration check or money order. Or, for additional information, contact: Gary Raymond P.O.B. 8184 New Orleans, La. 70182 Ph: (504) 288-6550 CompuServe: 72561,2637 EOF()