home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / trkit_10.zip / TRACKIT!.DOC < prev    next >
Text File  |  1994-05-09  |  48KB  |  1,448 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                              /                                            
  25.    TrackIt!                //                                             
  26.                          ///           ╔══════════════════════════╗
  27.    Version 1.0         ////            ║ Program Reference Manual ║
  28.                      // //             ╚══════════════════════════╝
  29.                    //  //                                                 
  30.                  //   //                                                  
  31.                //    //                                                   
  32.              //     //////////                                            
  33.            //             //                                              
  34.          ////////////   //                                                
  35.                  //   //                                                  
  36.                //  //                                                     
  37.              //  //                                                       
  38.            // //                                                          
  39.          // //                                                            
  40.        ////                                                               
  41.      ////                                                                 
  42.    ///                                                                    
  43.  //                                                                       
  44. /          Copyright (C) 1994 by Michael S. Hogg, All Rights Reserved.    
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                     License Agreement, Disclaimer, and Legal Stuff
  71.  
  72.           Every precaution has been taken to ensure that no harm or damage
  73.           will occur on systems running TrackIt!. However, by using this
  74.           software the user assumes all responsibility for any damages or
  75.           other loss of data that may occur from the use or inability to
  76.           use TrackIt!. NO WARRANTIES ARE IMPLIED OR EXPRESSLY STATED.
  77.  
  78.           TrackIt! and this documentation are copyrighted materials. All
  79.           rights to these materials are reserved, and are protected under
  80.           United States and International Copyright Laws. No part of these
  81.           materials may be reproduced or modified in any way without the
  82.           prior express written consent of Michael S. Hogg.
  83.  
  84.           TrackIt! is a Shareware product. It is NOT freeware or public
  85.           domain. After a reasonable trial period (not to exceed 14 days),
  86.           you must register TrackIt! in order to legally use it. In return
  87.           for your registration, you will be provided a key to register
  88.           this and any future versions. Please see "Registering" for more
  89.           information.
  90.  
  91.           An unlimited license to make and distribute unregistered copies
  92.           of this software is granted. Absolutely no modifications to the
  93.           files contained in the software package, including this
  94.           documentation file, may be made before distribution. No fee may
  95.           be charged by anyone other than Michael S. Hogg beyond the actual
  96.           cost of providing these copies without the prior written consent
  97.           of Michael S. Hogg.
  98.            
  99.           TRACKIT! IS PROVIDED ON AN "AS IS" BASIS WITHOUT WARRANTY OF ANY
  100.           KIND EXPRESSED OR IMPLIED. IN NO EVENT WILL MICHAEL S. HOGG BE
  101.           LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST
  102.           SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  103.           OF THE USE OF OR INABILITY TO USE THE PROGRAM, EVEN IF MICHAEL S.
  104.           HOGG HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR  
  105.           FOR ANY CLAIM BY ANY OTHER PARTY.
  106.  
  107.           Use of TrackIt! constitutes acceptance of the stated terms and
  108.           conditions. Michael S. Hogg reserves all rights which are not
  109.           expressly granted.
  110.                
  111.           SALT and Telix are trademarks of deltaComm Development. Use of
  112.           Telix(tm) for longer than 45 days without appropriate payment to
  113.           deltaComm Development for Telix is a violation of International
  114.           Copyright Law.
  115.  
  116.           ----------------------------------------------------------------
  117.  
  118.           Note to CompuServe Users's:
  119.  
  120.           If you downloaded TRACKIT! from CompuServe, please rename the
  121.           archive to TRKIT!10.ZIP before uploading it elsewhere.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           TrackIt! v1.0                                                  ii
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                    C O N T E N T S
  138.  
  139.  
  140.  
  141.  
  142.           License Agreement, Disclaimer, and Legal Stuff...............  ii
  143.  
  144.           Introduction.................................................   1
  145.  
  146.           Quick Start Guide............................................   2
  147.  
  148.           Using TrackIt! - Detailed Guide..............................   4
  149.  
  150.             How TrackIt! Works.........................................   4
  151.  
  152.             How to Start TrackIt!......................................   4
  153.  
  154.             Using the Edit Box.........................................   5
  155.  
  156.             The Track String...........................................   5
  157.  
  158.             The Reply String...........................................   6
  159.  
  160.             Setting Maximum Hits.......................................   6
  161.  
  162.             Testing Tracks Offline.....................................   7
  163.  
  164.           Advanced Features - The @ Command Set........................   8
  165.  
  166.           The Configuration File - Basic Settings......................  10
  167.  
  168.           The Configuration File - Advanced Settings...................  11
  169.  
  170.           Tips and Tricks..............................................  12
  171.  
  172.             How to get unlimited tracks................................  13
  173.  
  174.             Working Around 20 Character Reply String...................  14
  175.  
  176.           Companion Scripts, Uploading & Downloading...................  15
  177.  
  178.           Registering TrackIt!.........................................  16
  179.  
  180.           How to Contact the Author....................................  17
  181.  
  182.           Acknowledgements.............................................  18
  183.  
  184.           Registration Form............................................  19
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           TrackIt! v1.0                                                 iii
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                      Introduction
  203.  
  204.           Welcome to TrackIt! This script represents a new approach to
  205.           taking advantage of Telix's tracking commands. You will no longer
  206.           have to worry about SALT programming to generate high speed track
  207.           scripts for your favorite BBS's. You will no longer have to worry
  208.           about a sixteen track limit per board. You won't have to worry
  209.           about recompiling a new script if a BBS changes one of the
  210.           prompts. You will never have to edit, or even look at code again.
  211.           TrackIt! will do all the work for you, and at a lightning fast
  212.           speed!
  213.  
  214.           TrackIt! is a product born of necessity. To my knowledge, there
  215.           isn't another high quality Track learner available for Telix.
  216.           There are several script learners available, but they are slow.
  217.           The other alternative was manually writing and compiling a Track
  218.           script for each board you called. Both the script learners, and
  219.           the manual method would require you to edit and recompile the
  220.           scripts if a BBS changed a single prompt. This was unacceptable.
  221.  
  222.           I have tried to design TrackIt! to be easy enough for the novice
  223.           user, and yet powerful enough to satisfy hard core users. Since
  224.           TrackIt! doesn't work like most of the popular script learners
  225.           available now, it will probably take a little getting used to.
  226.           Once you try it out on one or two BBS's you will begin to see why
  227.           TrackIt! is far superior to those other script learners. For
  228.           those of you who call long distance, TrackIt! is the script you
  229.           need to insure fast, fail-safe mail runs!
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           TrackIt! v1.0                                                   1
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   Quick Start Guide
  269.  
  270.           Installing:
  271.  
  272.           TrackIt! works from within your Telix script directory. Simply
  273.           place all the files into that one directory. Use ALT O,F to see
  274.           if you have a script directory defined in Telix's configuration
  275.           menu. If you do not, then the same directory which contains
  276.           TELIX.EXE is where you should unpack the distribution files.
  277.  
  278.  
  279.           Starting TrackIt!:
  280.  
  281.           Load Telix. Go to the dialing directory. For every BBS you wish
  282.           to use TrackIt! with, simply list TRACKIT! as your linked script
  283.           file. Call the BBS.
  284.  
  285.  
  286.           Bringing up the edit box:
  287.  
  288.           When you come to a prompt, do NOT type anything. Instead, press
  289.           the HOME key. An edit box will appear. The first line in the edit
  290.           box is the prompt (20 chr max) you were at when you hit home. The
  291.           second line, is where you place your reply to that prompt. The
  292.           last line is the maximum number of times to recognize the track.
  293.  
  294.  
  295.           How to use the edit box:
  296.  
  297.           When you bring up the edit box with the home key, you start out
  298.           at the Reply String. The red arrow will indicate this. To move to
  299.           one of the other fields, simply use the TAB key. If the edit box
  300.           is covering part of the screen you need to see, you can move the
  301.           edit box itself with the arrow keys. When you are satisfied with
  302.           all the fields, you can use HOME or END to exit from the edit
  303.           box. If you use HOME, then TrackIt! will assume you are at that
  304.           prompt now, and send the Reply String. If you use END, it will
  305.           assume you are NOT at that prompt, and simply return you to
  306.           terminal mode. Please note, if you use HOME to exit, it will
  307.           count as a hit toward the maximum hits. See "Setting Maximum
  308.           Hits" for more information.
  309.  
  310.  
  311.           Reply String:
  312.  
  313.           Simply enter what you would normally enter at the prompt in this
  314.           field. RETURNs will show up as a musical note, and ESCs will show
  315.           up as a back arrow. If you know this prompt will appear more than
  316.           once while you are online, and you will want a different reply
  317.           the second or third time, then use a PIPE to separate the
  318.           replies. You may use the INSERT key to generate the pipe.
  319.           Multiple replies are sent sequentially. The first time the track
  320.           is HIT (or is seen by TrackIt!) the first reply is sent, second
  321.           time, second reply, etc.. if it's hit more times than there are
  322.           replies, then the last reply is always sent. However, you must
  323.           have Maximum Hits set high enough to recognize multiple replies.
  324.  
  325.  
  326.  
  327.           TrackIt! v1.0                                                   2
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.           If you know the prompt will appear again, but are not sure what
  336.           reply you will want at that time, then simply leave Maximum Hits
  337.           set to one. When you see the prompt the second time, press HOME
  338.           again, and TrackIt! will go to that track automatically. Then you
  339.           may use INSERT (pipe) and put your second reply. Make sure you
  340.           update the Maximum Hits though, or this will not work.
  341.  
  342.           If you don't know how many times the prompt will appear, or know
  343.           it will appear quite often (such as "Press a key" etc..), then
  344.           set the Maximum Hits to ZERO. Doing this will cause TrackIt! to
  345.           always recognize that prompt, and send the reply.
  346.  
  347.           Once you set a track, it will take effect immediately.
  348.  
  349.  
  350.           Ending TrackIt!:
  351.  
  352.           After you have entered all the prompts you wish to track, you may
  353.           end TrackIt! by pressing the END key.
  354.  
  355.  
  356.           Now that you have entered all the prompts and replies, hang up
  357.           and call the same BBS again. This time, just set back and watch.
  358.           If the BBS should happen to give you a prompt this time that it
  359.           didn't before, simply use the HOME key and add that prompt. The
  360.           order the prompts are in doesn't matter.
  361.  
  362.           The Quick Start Guide only represents the very basics of
  363.           TrackIt!. There are several commands you may use in the tracks to
  364.           perform various task. An example would be @PASS as a reply. This
  365.           command would send whatever you have your password set to in the
  366.           dialing directory. 
  367.  
  368.           Most people prefer to see a program work before they take time to
  369.           read the documentation that comes with it. That is why I included
  370.           the Quick Start Guide. Now that you have had time to see the
  371.           basics of TrackIt!, please take time to read the rest of the
  372.           Reference Manual so that you can take full advantage of this
  373.           program.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.           TrackIt! v1.0                                                   3
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                            Using TrackIt! - Detailed Guide
  401.  
  402.           How TrackIt! Works:
  403.  
  404.           TrackIt! is a new concept in automating telecommunications. It
  405.           could be called a "Tracking System for Telix". For every BBS you
  406.           use TrackIt! with, it will create a "track file". This track file
  407.           is used to store the "tracks" for the BBS. A track is the
  408.           information TrackIt! keeps for different BBS prompts. This
  409.           information consists of the following three "fields": Track
  410.           String, the prompt; Track Reply, the response(s) to the prompt;
  411.           and Maximum Hits, how many times TrackIt! should recognize the
  412.           prompt. Each track file can hold up to sixteen tracks. TrackIt!
  413.           will make up to ninety-nine track files for each BBS, giving you
  414.           over fifteen hundred tracks available for each board name you
  415.           use. Using some advanced techniques, you can have an unlimited
  416.           number of tracks per BBS. Please see "Tips and Tricks" for more
  417.           information on unlimited tracks.
  418.  
  419.           In order to view, add, edit, or delete tracks, TrackIt! uses a
  420.           built in track editor called "The Edit Box". For a track to be
  421.           considered defined by TrackIt!, it must have a Track String.
  422.           Whenever you are not in the edit box, all defined tracks are
  423.           active. For more information on the edit box, please see "Using
  424.           The Edit Box".
  425.  
  426.           Anytime there is a match between a defined track and text coming
  427.           in the com port (including what you type), TrackIt! will send the
  428.           appropriate response. This is called a "Hit". Unless Maximum Hits
  429.           is set to zero, after the Maximum Hits for a track is exceeded,
  430.           the track is deactivated (not recognized any more).
  431.  
  432.  
  433.           How to Start TrackIt!:
  434.  
  435.           You may start TrackIt! one of two ways. If you list TRACKIT! as
  436.           the linked script for a BBS in your dialing directory, then it
  437.           will start as soon as you get a carrier. However, if you need to
  438.           edit an existing BBS's track file, or make a new one while
  439.           offline, then you can start TrackIt! using the ALT-G command, and
  440.           entering "TRACKIT!".
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.           TrackIt! v1.0                                                   4
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.           When you start TrackIt! with ALT-G, you will be prompted for the
  468.           board name to edit. To determine the board name, you need to
  469.           understand how TrackIt! does it. TrackIt! uses the board name
  470.           listed in the dialing directory. It takes the first eight
  471.           characters of the name, and then strips any spaces and periods.
  472.           Here are some examples: 
  473.  
  474.           Dialing Directory Name            How TrackIt! would refer to it
  475.           ----------------------            ------------------------------
  476.           The BBS                           thebbs
  477.           The One B.B.S.                    theone    
  478.           B.B.S. World                      bbsw
  479.           deltaComm BBS                     deltacom
  480.           - Generic BBS -                   -generi
  481.  
  482.           It's important that you understand how this works. If you create
  483.           a new track file while offline with the intention of using it
  484.           linked to a BBS in the dialing directory, you need to make sure
  485.           the board name you give TrackIt! to create is going to match what
  486.           TrackIt! will look for when run as a linked script. So if you
  487.           want to create a track file for "B.B.S. World" while offline, you
  488.           have to name it "bbsw" for TrackIt! to use that track file when
  489.           calling B.B.S. World.
  490.  
  491.  
  492.           Using the Edit Box:
  493.  
  494.           The edit box lets you view, enter, edit, and delete existing
  495.           tracks in a track file. Once TrackIt! is activated, use the HOME
  496.           key to bring up the edit box. To move the box to a different
  497.           position on the screen, use the four ARROW KEYS. To scroll
  498.           through the defined tracks for the current track file, use the
  499.           PGUP and PGDN keys. To clear the current track, use the DEL key.
  500.           To move to a different field within the box, use the TAB key. To
  501.           exit the edit box, and send the current reply, use the HOME key
  502.           again. To exit the edit box without sending anything, use the END
  503.           key. Using the HOME key to exit will count as a "hit".
  504.  
  505.  
  506.           The Track String:
  507.  
  508.           The prompt you want to respond to is called The Track String.
  509.           This string must match exactly to what the BBS will send. It is
  510.           case sensitive. This string can be a maximum of twenty characters
  511.           long. This string is used to determine if this track is "hit". If
  512.           this string matches text coming across the com port, then it is a
  513.           "hit". Here are some examples:
  514.  
  515.           Text coming in com port       Defined Track String    Hit or not
  516.           --------------------------    --------------------    ----------
  517.           Enter your name or handle?    name or handle?         IS a hit
  518.           Enter your Name or Handle?    name or handle?         NOT a hit
  519.           Press ENTER to continue:      ENTER                   IS a hit
  520.           Press ENTER to continue:      <ENTER>                 NOT a hit
  521.           Press ENTER to continue:      enter                   NOT a hit
  522.  
  523.  
  524.  
  525.           TrackIt! v1.0                                                   5
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.           The Reply String:
  534.  
  535.           What you would like to send when a hit occurs is called The Reply
  536.           String. When you enter the reply string, ENTER will show up as a
  537.           musical note, and ESC will show up as a back arrow. To enter
  538.           multiple replies, you must separate them with a PIPE symbol (|).
  539.           You can enter the pipe manually, or use the INSERT key to
  540.           generate the symbol. When more than one reply for the same track
  541.           string is defined, TrackIt! will use how many times that track
  542.           has been hit in order to determine which reply to send. It
  543.           operates sequentially. The first time the track is hit, the first
  544.           reply is sent, second time, second reply, etc... If the number of
  545.           hits exceeds the number of defined replies, the last reply will
  546.           always be sent. You can define as many replies for each track as
  547.           you can fit into the reply string. This string is set to twenty
  548.           characters max. If this isn't long enough for your needs, then
  549.           see "Tips and Tricks" on how to work around this problem. If
  550.           there is a demand for it, I may make the reply string longer in
  551.           future versions.
  552.  
  553.           A tilde (~) may be used any where in the reply string for a one
  554.           second delay. Some boards will not work if the information is
  555.           sent too fast.
  556.  
  557.  
  558.           Setting Maximum Hits:
  559.  
  560.           Maximum Hits is the maximum number of times TrackIt! will
  561.           recognize a track before it is deactivated. If this number is set
  562.           to zero, then it will recognize that track until the program is
  563.           ended, or a new track file is loaded. This number is important.
  564.           The more tracks you have active at one time, the slower the
  565.           response will be. Therefore, you want to deactivate tracks as
  566.           soon as you know they will not be needed any more. This will keep
  567.           TrackIt! working at an optimum speed. For instance, generally the
  568.           password prompt a BBS sends will only be sent once, so you would
  569.           want to set Maximum Hits to one for that prompt. After it is hit
  570.           once, the reply string is sent, and the track is deactivated.
  571.           However, with tracks that you have set to use multiple replies,
  572.           make sure that the Maximum Hits is set at least to the number of
  573.           replies you have defined or to zero, else all of the replies will
  574.           not be used. Sometimes you don't know how many times a prompt
  575.           might appear ("[pause]", "press a key..", etc), so in this case,
  576.           using zero as the Maximum Hits would be appropriate.
  577.  
  578.  
  579.           Ending TrackIt!:
  580.  
  581.           You can end TrackIt! at any time by pressing the END key while
  582.           not in the edit box. If you started TrackIt! as a linked script,
  583.           then TrackIt! will automatically end when the carrier is lost.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.           TrackIt! v1.0                                                   6
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.           Testing Tracks Offline:
  600.  
  601.           A good way to see how TrackIt! works is to play around with it
  602.           offline. Start TrackIt! using the ALT-G command. When TrackIt!
  603.           ask you for the board name, press ENTER. When board name is left
  604.           blank, TrackIt! will use "TESTBBS" as the board name.
  605.  
  606.           Use the home key and define one or two tracks, setting Maximum
  607.           Hits to zero. Now press the END key. Type in one of the Track
  608.           Strings you defined a minute ago, and the Reply string should be
  609.           sent automatically. Press ENTER and CTRL-J a couple times, then
  610.           type in the other Track String.
  611.  
  612.           Use this method to get the feel of TrackIt!. Define some more
  613.           tracks, trying out multiple responses, or using different Maximum
  614.           Hits settings. When you are done, use END key to exit TrackIt!
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.           TrackIt! v1.0                                                   7
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                         Advanced Features - The @ Command Set
  665.  
  666.           TrackIt! offers a set of commands you can imbed into your tracks.
  667.           These commands all start with the "at" symbol (@). All of the
  668.           commands that are used in reply strings can be used with multiple
  669.           reply sets. The commands are NOT case sensitive. It doesn't
  670.           matter if you type them in capital letters, lower case, or a mix.
  671.  
  672.           @logon
  673.  
  674.           This command can be used as the Track String for track number
  675.           ONE. If it's not used with track one, it will not work. When
  676.           used, the track will be considered hit as soon as TrackIt! is
  677.           run, and the Reply String will be sent. When using TrackIt! as a
  678.           linked script, TrackIt! isn't run until you have a carrier. This
  679.           command is useful for systems that require characters to be sent
  680.           as soon as a connection is made, such as CompuServe. On some
  681.           systems, you may want to add a couple tilde's (~) as the first
  682.           characters of the reply string for this to work properly.
  683.  
  684.  
  685.           @pass
  686.  
  687.           This command can be used in the Reply String. It will send what
  688.           ever you have your password set to in the dialing directory for
  689.           the board you are currently calling. If @pass is used by itself,
  690.           a RETURN is automatically sent after the password. If you need to
  691.           put a delay or any other characters after the password, put the
  692.           characters after @PASS and it will send your password and
  693.           anything else you have after the command. This command is useful
  694.           if you change your passwords often.
  695.  
  696.  
  697.           @end
  698.  
  699.           This command can be used in the Reply String. It will exit
  700.           TrackIt!. This command is useful for writing log on tracks that
  701.           get you to the main command prompt.
  702.  
  703.  
  704.           @<script> <param>
  705.  
  706.           This command can be used in the Reply String. The "at" symbol
  707.           followed by a script name will allow you to execute an external
  708.           script from within TrackIt!. Do not include an extension with the
  709.           script name, TrackIt! automatically adds ".slc" to the name. 
  710.  
  711.           The <param> is optional. If used, it will pass the parameter to
  712.           the called script. This parameter could be a filename or anything
  713.           else you wanted. Here's an example using the param field:
  714.  
  715.                               @up bbs.rep 
  716.  
  717.           When the external script ends, TrackIt! will pick up where it
  718.           left off. This command is useful for doing uploads, specialized
  719.           downloads, or anything else you may want to do online.
  720.  
  721.  
  722.  
  723.           TrackIt! v1.0                                                   8
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.           @link <#>
  732.  
  733.           This command can be used in the Reply String. This command loads
  734.           in the next Track File. When used, all current tracks are
  735.           deactivated, and a new set is loaded in. TrackIt! names the track
  736.           files with the extension ".!##". The number ranges from one to
  737.           ninety-nine. You always start out using ".!01". 
  738.  
  739.           When the @link command is executed, TrackIt! will load in the
  740.           track file specified. For example, "@link 20" would load track
  741.           twenty (".!20") into memory. 
  742.  
  743.           When the @link command is executed without a number specified,
  744.           TrackIt! will increment one to the next track file. For example,
  745.           if you were on track ".!01" and executed "@link", ".!02" would be
  746.           loaded into memory. If executed again, ".!03" would be loaded,
  747.           etc.. If you are on track ".!99" and execute @link without
  748.           specifying a number, then ".!01" would be loaded.
  749.  
  750.  
  751.           @clear #
  752.  
  753.           This command will deactivate the track specified regardless of
  754.           the maximum hits setting for the track. For example, "@clear 3"
  755.           will deactivate track 3 of the current track file.
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.           TrackIt! v1.0                                                   9
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                        The Configuration File - Basic Settings
  797.  
  798.           TrackIt!'s configuration file is designed to be easily customized
  799.           to your needs. It's set up as a straight ascii text file. You can
  800.           use any ascii text editor to change the config file, such as
  801.           DOS's "edit".
  802.  
  803.           The first number in the file should be "1" or "0". This number
  804.           tells TrackIt! if it should automatically update the file with
  805.           the last X and Y coordinates you had The Edit Box. If the number
  806.           is zero, TrackIt! will not update the config file. If the number
  807.           is one, TrackIt! will update the config file.
  808.  
  809.           The next number in the file is the default X coordinate for The
  810.           Edit Box. It represents the left side of the box. The number
  811.           should be between 0 and 39.
  812.  
  813.           The next number in the file is the default Y coordinate for The
  814.           Edit Box. It represents the top of the box. The number should be
  815.           between 0 and 11.
  816.  
  817.           The next number in the file is the background color of The Edit
  818.           Box. This number should be between 0 and 7.
  819.  
  820.           The next number in the file is the foreground color of The Edit
  821.           Box. This number should be between 0 and 15.
  822.  
  823.           The next number in the file is the arrow color of The Edit Box.
  824.           This number should be between 0 and 15.
  825.  
  826.           The next number in the file is the editing background color. This
  827.           number should be between 0 and 7.
  828.  
  829.           The next number in the file is the editing foreground color. This
  830.           number should be between 0 and 15.
  831.  
  832.  
  833.           COLOR CODES:  0 Black                 8 Dark Grey           
  834.                         1 Blue                  9 Light Blue          
  835.                         2 Green                10 Light Green         
  836.                         3 Cyan                 11 Light Cyan          
  837.                         4 Red                  12 Light Red           
  838.                         5 Magenta              13 Light Magenta       
  839.                         6 Brown                14 Yellow              
  840.                         7 Light Grey           15 White               
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.           TrackIt! v1.0                                                  10
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                       The Configuration File - Advanced Settings
  863.  
  864.           When using high speed modems, Telix will sometimes miss one or
  865.           two characters coming across the com port, and they wont be
  866.           processed through the tracking routines. TrackIt! has a built in
  867.           inactivity timer. This timer is active when nothing is coming in
  868.           over the com port and no keys are being pressed. After X seconds
  869.           elapse, TrackIt! will look at the last twenty characters and re-
  870.           send them through the track processing routines. This process is
  871.           called "re-tracking", and is transparent to the user. After X re-
  872.           tracks, TrackIt! will hang up the modem.
  873.  
  874.           TrackIt! offers a feature called AutoPrompting. The feature will
  875.           automatically call the Edit Box for you when X seconds elapse
  876.           without any key presses or anything coming from the com port.
  877.           This feature is off by default. I originally added this feature
  878.           to see how good it would work, but I personally didn't like it.
  879.           So instead of taking it out all together, I made it so it can be
  880.           activated via the config file. This option could be useful when
  881.           making several track files for different BBS's. However, if you
  882.           do use the AutoPrompting feature, the re-tracking will be
  883.           disabled.
  884.  
  885.           The number following the editing foreground color in the config
  886.           file tells TrackIt! if it should use AutoPrompting. One is on,
  887.           zero is off.
  888.  
  889.           The next number is the delay used to activate the AutoPrompting.
  890.           If AutoPrompting is off, this number must still be present, but
  891.           the value wont matter. If on, the number is in tenths of a
  892.           second. (ie, 10 is 1 second);
  893.  
  894.           The next number is the delay TrackIt! should use for every tilde
  895.           (~) in a reply string. The default is 10 (one second). The number
  896.           is in tenths of a second.
  897.  
  898.           The next number is how long TrackIt! should allow inactivity
  899.           before doing a re-track. Again, the number is in tenths of a
  900.           second. The default is 50. (5 seconds) 
  901.  
  902.           The next number is the maximum number of re-tracks TrackIt!
  903.           should allow before hanging up the modem.
  904.  
  905.  
  906.           After you have made all the track files for all the BBS's you
  907.           plan on using TrackIt! with, I would recommend changing the re-
  908.           track delay to twenty. If you do this, you may also want to set
  909.           the maximum re-tracks before hang up a little higher.
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.           TrackIt! v1.0                                                  11
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                    Tips and Tricks
  929.  
  930.           Up to this point in the documentation, I have attempted to
  931.           present the information in a way that a novice could understand.
  932.           However, for this section: you will have to be comfortable with
  933.           TrackIt! and understand everything up to this point; and you will
  934.           have to know a little about the basics of the SALT programming
  935.           language. This section is not required to be able to use
  936.           TrackIt!, so if you do not know anything about SALT, and do not
  937.           care to learn, then proceed to the next section.
  938.  
  939.           The true power behind TrackIt! lies in its flexibility and "open
  940.           architecture" design. You can call TrackIt! from your own scripts
  941.           and have it execute as it does when using it from the dialing
  942.           directory. You can have TrackIt! call your scripts when a certain
  943.           track is hit. You can have TrackIt! load into memory a new set of
  944.           tracks, or stop execution at a certain prompt and return to the
  945.           original script. In this section, I will try to demonstrate some
  946.           of these features.
  947.  
  948.           Since this is the first release of TrackIt!, I have only included
  949.           two entries for this section. Play around with TrackIt! and see
  950.           what you can come up with, it's my belief that there is no limit
  951.           to what you can automate online using TrackIt!. If you think of
  952.           any other little "power tricks" I can add to this section, then
  953.           let me know. 
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.           TrackIt! v1.0                                                  12
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.           How to get unlimited tracks:
  996.  
  997.           When TrackIt! goes to read or write the track files, it changes
  998.           to the directory defined by SALT's _script_dir environment
  999.           variable. Using this information, we can have TrackIt! execute a
  1000.           script that will change the value of _script_dir. Then have it
  1001.           set up to use the @link command. Make sure AutoPrompting is OFF.
  1002.           You can have ninety-nine track files per board per directory. The
  1003.           tracks are limited only by the number of directories you feel
  1004.           like making.
  1005.  
  1006.           Example SALT:  CD.slt
  1007.                          
  1008.                          main()
  1009.                          { _script_dir="c:\telix\scripts2";
  1010.                          }
  1011.  
  1012.           Track File   : c:\telix\scripts\unlim.!01
  1013.           Example Track: Track String: command prompt:
  1014.                          Reply String: @cd
  1015.                          Maximum Hits: 2
  1016.  
  1017.           Track File   : c:\telix\scripts2\unlim.!01
  1018.           Example Track: Track String: command prompt:
  1019.                          Reply String: x|@link
  1020.                          Maximum Hits: 2
  1021.  
  1022.           Track File   : c:\telix\scripts2\unlim.!02
  1023.           Example Track: Track String: command prompt:
  1024.                          Reply String: m
  1025.                          Maximum Hits: 1
  1026.  
  1027.           In the above example when "command prompt" is seen for the first
  1028.           time TrackIt! will execute the script "CD". This script will
  1029.           change to the new directory and return to TrackIt!. Now TrackIt!
  1030.           will sit there until the inactivity timer forces a re-track.
  1031.           Since TrackIt! hasn't reset the tracks, this will count as the
  1032.           SECOND hit for the track. So this time, @link will be executed.
  1033.           @link will cause TrackIt! to reset all the tracks and load
  1034.           "c:\telix\scripts2\unlim.!01". Then it will wait, do the re-track
  1035.           again, and then execute the new reply string.
  1036.  
  1037.           You can repeat this process all you want, but keep in mind that
  1038.           every time you do this, you are working out of a new directory.
  1039.           You will need to make sure you have any other scripts you will
  1040.           call in the directory TrackIt! is working out of when you call
  1041.           them.
  1042.  
  1043.           *NOTE: You can have an unlimited number of Tracks defined for
  1044.           each BBS. However, this does NOT mean that all of them will be
  1045.           active at the same time. You can have only sixteen tracks active
  1046.           in memory at one time. If you are calling a board with an
  1047.           extensive number of prompts, then use the @link command. Make !01
  1048.           get you to point A, !02 get you to point B, etc... There should
  1049.           never be any reason to need more than sixteen tracks ACTIVE at
  1050.           one time. 
  1051.  
  1052.  
  1053.           TrackIt! v1.0                                                  13
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.           Working Around 20 Character Reply String:
  1062.  
  1063.           Chances are that you will rarely need a reply string that is
  1064.           longer than twenty characters, even when using multiple replies.
  1065.           However, in the event that you do need more than twenty
  1066.           characters for a reply string, then there is a simple solution to
  1067.           this problem.
  1068.  
  1069.           The solution is to have the track call an external script to send
  1070.           your reply. For example, if you have a reply string that sends
  1071.           "main" on the first hit, a long string on the second hit, and
  1072.           "off" on the third hit, you could define your reply string like
  1073.           this: "main|@A|off". When the track is hit the second time
  1074.           TrackIt! will attempt to execute the script named "a.slc". The
  1075.           source for the script could be very simple. For example:
  1076.  
  1077.                              File: A.slt
  1078.  
  1079.                              main()
  1080.                              { cputs("This would be the long reply...^M");
  1081.                              }
  1082.  
  1083.           If the twenty character limit on the reply string is going to be
  1084.           a major problem for you, then let me know. If there is a big
  1085.           enough demand for it, I may lengthen the reply string in future
  1086.           versions.
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.           TrackIt! v1.0                                                  14
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                   Companion Scripts
  1127.  
  1128.           The most powerful feature of TrackIt! is it's ability to call
  1129.           external scripts. Included with your TrackIt! package are some
  1130.           companion scripts written by Bruce Thomas. These scripts are an
  1131.           excellent example of what can be done with TrackIt!. I encourage
  1132.           you as a user to write and distribute your own companion scripts
  1133.           for TrackIt!.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                                Uploading & Downloading
  1140.  
  1141.           Downloading in TrackIt! can be done two different ways. The
  1142.           easiest way is to set the auto-start Zmodem download to ON in
  1143.           your Telix configuration menu. The other way is to define a
  1144.           track. In the reply string you can have TrackIt! call an external
  1145.           script to do the download for you. For example, to call a script
  1146.           called DOWN.SLC, your reply string would look like this, "@down".
  1147.  
  1148.           To upload in TrackIt!, you have to call an external script.
  1149.           Define a track to look for the upload prompt, then use the
  1150.           @<script> <param> command in the reply string.
  1151.  
  1152.           The companion scripts written by Bruce Thomas include both upload
  1153.           and download scripts, and the source code. Scripts are included
  1154.           that use internal or external protocols.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.           TrackIt! v1.0                                                  15
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                  Registering TrackIt!
  1193.  
  1194.           The most important thing you as a user can do is register
  1195.           TrackIt!. You are granted a fourteen day license, as an
  1196.           evaluation period, to use TrackIt!. After the evaluation period,
  1197.           you are expected to register TrackIt!, or discontinue use. If you
  1198.           use TrackIt! past the evaluation period without registering, then
  1199.           you are violating U.S. and International Copyright Law.
  1200.  
  1201.           Registration for TrackIt! is only $10. In return for your
  1202.           registration you will be mailed a registration key to remove all
  1203.           the registration reminders from the program. You will also have
  1204.           an account made for you on TrackIt's support board, Salt Water
  1205.           BBS.
  1206.  
  1207.           I have a lot of ideas of things to add to future versions of
  1208.           TrackIt!. However, I will only support TrackIt! for as long as
  1209.           the users are supporting TrackIt!. Therefore, it's to your best
  1210.           interest as a user to not only register TrackIt!, but once
  1211.           registered, to not give out your registration key.
  1212.  
  1213.  
  1214.                                     -- Discount --
  1215.  
  1216.           If you already have a registered version of Record or SLearn, but
  1217.           you would rather have a registered version of TrackIt!, I will
  1218.           offer you a 25% discount. Enclose the ORIGINAL cancelled check
  1219.           you used to register Record or SLearn with your TrackIt!
  1220.           registration, and get $2.50 off TrackIt!. I'm sorry, but I cannot
  1221.           accept photocopies or the registration letter as a substitute.
  1222.  
  1223.  
  1224.  
  1225.                                 TrackIt!'s Support BBS
  1226.  
  1227.           TrackIt! does have a support board. Unregistered users only have
  1228.           access to download the latest version of TrackIt!. Registered
  1229.           users will have access to the message base, and the TrackIt!
  1230.           companion scripts file area. I may be releasing a couple NON-
  1231.           Shareware companion scripts to go along with TrackIt!. If I do,
  1232.           these scripts will be available to registered users only.
  1233.  
  1234.           Support board for TrackIt!:  Salt Water BBS
  1235.                                        (804) 989-5113
  1236.                                        Sysop: Bruce Thomas
  1237.  
  1238.           To get the latest version of TrackIt! from the support board, use
  1239.           the following information to log onto the BBS.
  1240.  
  1241.                           First Name: Long
  1242.                            Last Name: Distance
  1243.                             Password: trackit!
  1244.  
  1245.           When you get to the main menu, type GRAB and the latest version
  1246.           will be sent via ZMODEM. I will post information concerning new
  1247.           versions on the Telix conference on Fidonet.
  1248.  
  1249.  
  1250.  
  1251.           TrackIt! v1.0                                                  16
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                               How to Contact the Author
  1259.  
  1260.           I strongly encourage and welcome user feedback. Without feedback,
  1261.           I don't know what users would like to see added or changed. For
  1262.           example, if this documentation isn't clear and concise enough for
  1263.           you, then tell me how I can improve it. If the program is lacking
  1264.           in any way, then let me know. Please remember when pointing out
  1265.           any problems with the program, try to be as detailed as you can.
  1266.           Do not say something general like "it just doesn't work right." 
  1267.  
  1268.           If you have any comments or suggestions, and a little extra
  1269.           pocket change, then I would appreciate a picture postcard of
  1270.           where you live with the comments or suggestions on it.
  1271.  
  1272.  
  1273.           U.S. Mailing Address: Michael S. Hogg
  1274.                                 PO Box 8055
  1275.                                 Hampton, Va. 23666
  1276.  
  1277.  
  1278.           Online contact points: Fidonet.......... Telix Conference
  1279.                                  Fidonet Mail..... Michael Hogg 1:271/160
  1280.                                  Salt Water BBS... Use comment to sysop
  1281.                                  MajorNet......... Freebird@ORN
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.           TrackIt! v1.0                                                  17
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                                    Acknowledgements
  1325.  
  1326.           Before TrackIt! was written, I was writing a different track
  1327.           script for each BBS that I called. Bruce Thomas suggested that I
  1328.           write a track learner that would generate the same results
  1329.           without having to write and compile a script for each BBS.
  1330.  
  1331.           I would like to thank Bruce Thomas for suggesting this program be
  1332.           written. Also, for constantly nagging me to work on it. He has
  1333.           contributed many ideas and suggestions for TrackIt!, done the
  1334.           Beta testing, contributed a set of companion scripts for use with
  1335.           TrackIt!, and is currently running the support BBS for TrackIt!.
  1336.  
  1337.           I would also like to thank the makers of Telix for providing a
  1338.           quality terminal program with a powerful script language. I have
  1339.           seen no other terminal program offer the power and flexibility of
  1340.           Telix's SALT language.
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.           TrackIt! v1.0                                                  18
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                            TrackIt! Registration Form
  1391.                                  for Version 1.0
  1392.  
  1393.         Registrations are good for this version, and all future versions.
  1394.  
  1395.                                             Number of registrations  _____
  1396.     Pricing:
  1397.  
  1398.     $10 Per Registration........................................... $_____
  1399.     
  1400.     [ ] I'm enclosing the original cancelled check I used to
  1401.         register Record or SLearn to get $2.50 off TrackIt!       - $_____
  1402.  
  1403.     [ ] I admit voting for Bill Clinton. Due to the amount of
  1404.         money my vote cost you this past tax season, I'm enclosing
  1405.         an extra $5 as minor compensation.                        + $_____
  1406.  
  1407.     [ ] I have money to burn, and $10 means nothing to me, so I am
  1408.         enclosing a little extra.                                 + $_____
  1409.  
  1410.  
  1411.                                                               TOTAL $_____
  1412.  
  1413.     Make check or money order payable to Michael S. Hogg in U.S. funds.
  1414.  
  1415.     Please write for group discounts, government, corporate, or network
  1416.     license pricing.
  1417.  
  1418.  
  1419.     Name    ______________________________________________________________
  1420.  
  1421.     Company ______________________________________________________________
  1422.  
  1423.     Address ______________________________________________________________
  1424.  
  1425.             ______________________________________________________________
  1426.  
  1427.     City    ________________________________State _______ Zip ____________
  1428.  
  1429.     Where did you get TrackIt!? __________________________________________
  1430.  
  1431.        Mail to:
  1432.  
  1433.                  Michael S. Hogg
  1434.                  PO Box 8055
  1435.                  Hampton, Va 23666
  1436.  
  1437.  
  1438.     Comments, suggestions, constructive criticism:
  1439.  
  1440.  
  1441.     ______________________________________________________________________
  1442.  
  1443.     ______________________________________________________________________
  1444.  
  1445.     ______________________________________________________________________
  1446.  
  1447.     ______________________________________________________________________
  1448.