home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / grafd200.zip / GRAF-D.DOC < prev    next >
Text File  |  1993-05-13  |  9KB  |  175 lines
  1.     Program: GRAF-D v1.00
  2.      Author: Steve Catmull
  3.        Date: 05/07/93
  4.  
  5. DESCRIPTION 
  6. ========================================================================
  7.  
  8.                PPE (PCBoard Programming Executable) that you can replace
  9.                PCBTEXT record #149 with.  
  10.              
  11.                What this PPE offers that PCBoard does not is to do some 
  12.                checking for graphics capability before asking the caller 
  13.                if they want graphics or not.  
  14.               
  15.                By testing for graphics before the prompt is ever issued, 
  16.                the appropriate default value can be set for the user. If 
  17.                they have ANSI capabilities (as per the <esc>[6n test) 
  18.                then the default for the prompt will be "Yes". A test 
  19.                will also be made if they have RIPscrip capabilities (as 
  20.                per the <esc>[! test).  If neither of these are detected 
  21.                in the default wait period then the default will remain 
  22.                as no.
  23.  
  24.  
  25. INSTALLATION
  26. ========================================================================
  27.              
  28.                Installing this PPE is very simple.  Use MKPCBTXT to load 
  29.                your PCBTEXT file.  Press F3 and enter 149.  You will now 
  30.                see the "Do you want graphics" record.  Simply change it 
  31.                to an ! followed by the full path and filename to the 
  32.                ANSI-D.PPE file. 
  33.                
  34.                In addition, make sure that you have not told PCBoard 
  35.                that you want to default to graphics at login.  If you
  36.                do, GRAF-D will attempt to leave a message addressed to
  37.                the SysOp informing 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.                The following details the command line options that are 
  50.                available.
  51.                 
  52.                   /WAIT:[clock ticks]
  53.  
  54.                      Gives you the ability to over-ride the default wait 
  55.                      time for graphics detection.  The default wait is 
  56.                      for 50 clock ticks which is equal to about 3 
  57.                      seconds (There are roughly 18.2 clock ticks per 
  58.                      second). For example, if you wish to make the new 
  59.                      wait time about 4 seconds, then you would enter the 
  60.                      following in PCBTEXT:
  61.                      
  62.                          C:\PCB\PPE\GRAF-D.PPE /WAIT:73
  63.                                        
  64.                   
  65.                   /COMPATIBLE
  66.  
  67.                      Because this PPE will change the "Do you want" 
  68.                      graphics prompt based on the graphics capability 
  69.                      detected then there is a good chance that login 
  70.                      scripts might fail.
  71.                      
  72.                      In other words, a user could login and receive
  73.                         
  74.                            "Do you want graphics (Enter)=no?"
  75.                            
  76.                      but the next time they login it may say
  77.                         
  78.                            "Do you want graphics (Enter)=yes?"
  79.                            
  80.                      Obviously, if the user has a script which checks 
  81.                      for "(Enter)=no" then their second login attempt 
  82.                      will fail.
  83.                      
  84.                      This command line switch will tell ANSI-D to report 
  85.                      the graphics mode detected above the "Do you want 
  86.                      graphics" prompt and explain that it will be the 
  87.                      default response.  The prompt will then be modified 
  88.                      to always display:
  89.                      
  90.                            "Do you want grpahics (Enter)=default?"
  91.                            
  92.                      It may break a few scripts initially, but once the 
  93.                      user has modified their end they can be assured 
  94.                      that they will always receive that prompt.  The 
  95.                      following is an example of how to specify this 
  96.                      parameter on the commandline:
  97.                      
  98.                      
  99.                          C:\PCB\PPE\GRAF-D.PPE /COMPATIBLE
  100.  
  101.  
  102. ERROR RATES
  103. ========================================================================
  104.                Not every user will have their graphics capabilities 
  105.                properly detected upon login.  If an invalid (or no 
  106.                response) at all is detetcted during the wait time then 
  107.                it must be assumed that the user does not have graphics 
  108.                capabilities.
  109.                
  110.                Some terminal programs are just plain slow in responding 
  111.                to ANSI or RIPscrip requests.  I have tested with the 
  112.                following communications software and all respond 
  113.                swiftly:
  114.                
  115.                    Telemate v4.x
  116.                    Telix v4.x
  117.                    Robocomm v4.x
  118.                    ProComm Plus v2.x
  119.                    Qmodem v4.31
  120.  
  121.                Even if you are using one of these programs it would 
  122.                still be likely for a response to not be detected.  This 
  123.                may happen if you are using error-correcting modems and 
  124.                the modem happens to be experiencing line noise.  In a 
  125.                case such as this, there is nothing that can be done.                   
  126.  
  127.                In my testing (about 1800 calls to Salt Air) I have seen 
  128.                that about 17% of all connections will fail to even get a 
  129.                response from the remote user.  Another 4% of all 
  130.                connections will fail due to incorrect responses from the 
  131.                remote terminal. This may happen if you start typing 
  132.                while graphics are being attempted to be detected.
  133.  
  134.                Of course, you could bump up the wait time to catch some 
  135.                of these connections.  The problem with this thinking 
  136.                though, is that users who truly do not have graphics 
  137.                capabilities will *have* to wait for the wait period (a 
  138.                default of about 3 seconds).  Extending that time any 
  139.                longer may really cause you to have some upset callers.
  140.  
  141.                For your reference, the following report shows the statistics
  142.                for the 1800 or so calls that I talked about previously:
  143.  
  144.                
  145.                                                  +-- Number of 
  146.                                                  |   calls where
  147.                                                  |   no response   + Incomplete    
  148.                                                  |   was recorded  | responses
  149.                                                  |                 |
  150.     *************************************************************************
  151.     Report ran: 05-07-93 08:24:53
  152.  
  153.        <= 2400 : Calls: 69   Average ticks: 17  Exc: 8   Inv: 7  Inc: 2 
  154.      2400-9600 : Calls: 153  Average ticks: 12  Exc: 43  Inv: 12 Inc: 1 
  155.     9601-14400 : Calls: 1101 Average ticks: 13  Exc: 245 Inv: 68 Inc: 13
  156.         14400+ : Calls: 150  Average ticks: 15  Exc: 13  Inv: 1  Inc: 5 
  157.     *************************************************************************
  158.         |         |               |                      |
  159.  Baud---+         +-- Number      +-- Average            |
  160.                       of              clock ticks        +- Invalid
  161.                       calls           elapsed               responses
  162.                                       before a
  163.                                       response
  164.  
  165.                                       
  166. MODIFYING SOURCE
  167. ========================================================================
  168.                
  169.                Feel free to modify the PPS (source) file as your needs 
  170.                dictate.  That is why the source is included.  :-)
  171.                
  172.                Last, but certainly not least.   HAVE FUN!
  173.  
  174.  
  175.