home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / GRAFD220.ZIP / GRAF-D.DOC < prev    next >
Text File  |  1993-09-10  |  13KB  |  251 lines
  1.     Program: GRAF-D v2.20  Copyright (C) 1993 Clark Development Co., Inc.
  2.      Author: Steve Catmull
  3.        Date: 09/10/93
  4.  
  5.  
  6. DESCRIPTION 
  7. ========================================================================
  8.  
  9.                PPE (PCBoard Programming Executable) that you can replace
  10.                PCBTEXT record #149 with.  
  11.              
  12.                What this PPE offers that PCBoard does not is to do some 
  13.                checking for graphics capability before asking the caller 
  14.                if they want graphics or not.  
  15.               
  16.                By testing for graphics before the prompt is ever issued, 
  17.                the appropriate default value can be set for the user. If 
  18.                they have ANSI capabilities (as per the <esc>[6n test) 
  19.                then the default for the prompt will be "Yes". A test 
  20.                will also be made if they have RIPscrip capabilities (as 
  21.                per the <esc>[! test).  If neither of these are detected 
  22.                in the default wait period then the default will remain 
  23.                as no.
  24.  
  25.  
  26. INSTALLATION
  27. ========================================================================
  28.              
  29.                Installing this PPE is very simple.  Use MKPCBTXT to load 
  30.                your PCBTEXT file.  Press F3 and enter 149.  You will now 
  31.                see the "Do you want graphics" record.  Simply change it 
  32.                to an ! followed by the full path and filename to the 
  33.                GRAF-D.PPE file. 
  34.                
  35.                In addition, make sure that you have not told PCBoard 
  36.                that you want to default to graphics at login.  If you
  37.                do, GRAF-D will warn you that your system is improperly
  38.                configured.
  39.                 
  40.                That's all there is to it.
  41.  
  42.  
  43. COMMAND LINE PARAMETERS
  44. ========================================================================
  45.  
  46.                You can control the wait time for ANSI and RIP detection 
  47.                from the command line.  You may also choose to run this 
  48.                program in "compatible" mode via command line switches. 
  49.                You can specify as many command line parameters as you
  50.                wish.  If you specify more than one, make sure each 
  51.                parameter is separated with a space.  The following 
  52.                details the command line options that are available.
  53.                 
  54.                   /WAIT:[clock ticks]
  55.  
  56.                      Gives you the ability to over-ride the default wait 
  57.                      time for graphics detection.  The default wait is 
  58.                      for 55 clock ticks which is equal to about 3 
  59.                      seconds (There are roughly 18.2 clock ticks per 
  60.                      second). For example, if you wish to make the new 
  61.                      wait time about 4 seconds, then you would enter the 
  62.                      following in PCBTEXT:
  63.                      
  64.                          C:\PCB\PPE\GRAF-D.PPE /WAIT:73
  65.                                        
  66.                   
  67.                   /COMPATIBLE
  68.  
  69.                      Because this PPE will change the "Do you want" 
  70.                      graphics prompt based on the graphics capability 
  71.                      detected then there is a good chance that login 
  72.                      scripts might fail.
  73.                      
  74.                      In other words, a user could login and receive
  75.                         
  76.                            "Do you want graphics (Enter)=no?"
  77.                            
  78.                      but the next time they login it may say
  79.                         
  80.                            "Do you want graphics (Enter)=yes?"
  81.                            
  82.                      Obviously, if the user has a script which checks 
  83.                      for "(Enter)=no" then their second login attempt 
  84.                      will fail.
  85.                      
  86.                      This command line switch will tell GRAF-D to report 
  87.                      the graphics mode detected above the "Do you want 
  88.                      graphics" prompt and explain that it will be the 
  89.                      default response.  The prompt will then be modified 
  90.                      to always display:
  91.                      
  92.                            "Do you want graphics (Enter)=default?"
  93.                            
  94.                      It may break a few scripts initially, but once the 
  95.                      user has modified their end they can be assured 
  96.                      that they will always receive that prompt.  The 
  97.                      following is an example of how to specify this 
  98.                      parameter on the command line:
  99.                      
  100.                      
  101.                          C:\PCB\PPE\GRAF-D.PPE /COMPATIBLE
  102.                          
  103.                   
  104.                   /AUTO
  105.  
  106.                      Some sysops may not want to give the user a choice 
  107.                      as to what graphics mode is selected.  If you are 
  108.                      one of these folks, then this switch is for you. 
  109.                      This switch will make the user use ANSI or RIP if 
  110.                      detected by the PPE.  If neither ANSI or RIP is 
  111.                      detected, then the user will be asked what graphics 
  112.                      mode they would like to use. 
  113.                      
  114.                      The reason that the PPE does not simply go with 
  115.                      non-graphics mode is because the user's 
  116.                      communication package may not properly handle the 
  117.                      ANSI auto-detection.  Example:
  118.                      
  119.                          C:\PCB\PPE\GRAF-D.PPE /AUTO
  120.                      
  121.            
  122.                   /NORIP
  123.                   
  124.                      Not all systems have RIPscrip screens designed.  If
  125.                      you do not want GRAF-D to automatically detect RIPscrip,
  126.                      use this command line parameter.  When this command line
  127.                      parameter is used, the auto-detection code for RIPscrip
  128.                      is not sent out.  Example:
  129.                      
  130.                          C:\PCB\PPE\GRAF-D.PPE /NORIP
  131.  
  132.                          
  133.                   /NOQUICK
  134.                   
  135.                      Some SysOps put a hefty amount of time into producing
  136.                      welcome screens for their users.  Users who are familiar
  137.                      with PCBoard may use the Q subcommand at the "Do you want
  138.                      graphics" prompt to skip the welcome screen.  When this
  139.                      option is used, you will disable the ability for users
  140.                      to skip the welcome screen by using the Q subcommand.
  141.                      Example usage:
  142.                      
  143.                          C:\PCB\PPE\GRAF-D.PPE /NOQUICK
  144.                          
  145.                   
  146.                   /DELAY:[clock ticks]
  147.                    
  148.                      When checking for an ANSI response, this PPE will wait
  149.                      for a default of 2 clock ticks if no response is received
  150.                      (after the first character).  In certain circumstances
  151.                      like excessive line noise, you may need to bump up 
  152.                      the delay time.  The delay time is expressed in clock
  153.                      ticks (18.2 per second).  Unless you need to, I suggest
  154.                      you do not use this parameter.
  155.                      
  156.                      Example usage:
  157.                      
  158.                          C:\PCB\PPE\GRAF-D.PPE /DELAY:10
  159.                   
  160.  
  161.                   /DEBUG
  162.  
  163.                      This command line switch will write some debug information
  164.                      to a file called DEBUG.GRF.  The debug information simply
  165.                      shows the contents of some variables and below that is
  166.                      a history of what is received after the ANSI request is
  167.                      sent out.  
  168.                      
  169.                      Looking at this information you will be able to determine
  170.                      if you need to increase the /WAIT time (because an
  171.                      incomplete response was received) or if the response 
  172.                      from the remote terminal program is flawed in some
  173.                      manner.
  174.                      
  175.  
  176. ERROR RATES
  177. ========================================================================
  178.                Not every user will have their graphics capabilities 
  179.                properly detected upon login.  If an invalid (or no 
  180.                response) at all is detected during the wait time then 
  181.                it must be assumed that the user does not have graphics 
  182.                capabilities.
  183.                
  184.                Some terminal programs are just plain slow in responding 
  185.                to ANSI or RIPscrip requests.  I have tested with the 
  186.                following communications software and all respond 
  187.                swiftly and accurately:
  188.                
  189.                    Telemate v4.x
  190.                    Telix v4.x
  191.                    Robocomm v4.x
  192.                    ProComm Plus v2.x
  193.                    Qmodem v4.31
  194.  
  195.                Even if you are using one of these programs it would 
  196.                still be likely for a response to not be detected.  This 
  197.                may happen if you are using error-correcting modems and 
  198.                the modem happens to be experiencing line noise.  In a 
  199.                case such as this, there is nothing that can be done.                   
  200.  
  201.                In my testing (about 1800 calls to Salt Air) I have seen 
  202.                that about 17% of all connections will fail to even get a 
  203.                response from the remote user.  Another 4% of all 
  204.                connections will fail due to incorrect responses from the 
  205.                remote terminal. This may happen if you start typing 
  206.                while graphics are being attempted to be detected.
  207.  
  208.                Of course, you could bump up the wait time to catch some 
  209.                of these connections.  The problem with this thinking 
  210.                though, is that users who truly do not have graphics 
  211.                capabilities will *have* to wait for the wait period (a 
  212.                default of about 3 seconds).  Extending that time any 
  213.                longer may really cause you to have some upset callers.
  214.  
  215.                For your reference, the following report shows the statistics
  216.                for the 1800 or so calls that I talked about previously:
  217.  
  218.                
  219.                                                  +-- Number of 
  220.                                                  |   calls where
  221.                                                  |   no response   + Incomplete    
  222.                                                  |   was recorded  | responses
  223.                                                  |                 |
  224.     *************************************************************************
  225.     Report ran: 05-07-93 08:24:53
  226.  
  227.        <= 2400 : Calls: 69   Average ticks: 17  Exc: 8   Inv: 7  Inc: 2 
  228.      2400-9600 : Calls: 153  Average ticks: 12  Exc: 43  Inv: 12 Inc: 1 
  229.     9601-14400 : Calls: 1101 Average ticks: 13  Exc: 245 Inv: 68 Inc: 13
  230.         14400+ : Calls: 150  Average ticks: 15  Exc: 13  Inv: 1  Inc: 5 
  231.     *************************************************************************
  232.         |         |               |                      |
  233.  Baud---+         +-- Number      +-- Average            |
  234.                       of              clock ticks        +- Invalid
  235.                       calls           elapsed               responses
  236.                                       before a
  237.                                       response
  238.  
  239.                                       
  240. MODIFYING SOURCE
  241. ========================================================================
  242.                
  243.                Feel free to modify the PPS (source) file as your needs 
  244.                dictate.  That is why the source is included.  :-)
  245.                If you do modify the source, please do not redistribute
  246.                your version.
  247.                
  248.                Last, but certainly not least.   HAVE FUN!
  249.  
  250.  
  251.