home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / e / estat21.zip / EASIDOC.ZIP / ESCHAP09.DOC < prev    next >
Text File  |  1992-06-30  |  20KB  |  529 lines

  1.  
  2.  
  3.      Chapter 9: ERROR MESSAGES AND BUGS
  4.  
  5.      9:1. List of error messages
  6.      with their meanings
  7.  
  8.      9:1.1  Syntax error
  9.  
  10.      The syntax for a command, calculation or condition is
  11.      incorrect.
  12.  
  13.      Check what you have typed in carefully and try again.
  14.      Note that this error is sometimes produced by specifying
  15.      a column number higher than the actual number of columns
  16.      in your data table. The other likely possibility is that
  17.      the rules for correctly naming columns, variables and
  18.      macros have not been observed and the parser has
  19.      therefore become confused.
  20.  
  21.      9:1.2  Missing )
  22.  
  23.      A right parenthesis is missing from a calculation or
  24.      condition, or possibly some other syntax error has
  25.      occurred.
  26.  
  27.      Check what you have typed in carefully and try again.
  28.  
  29.      9:1.3  Blank line
  30.  
  31.      A condition or other parameter is expected but has not
  32.      been entered, or begins incorrectly so is not recognised
  33.  
  34.      Check what you have typed in carefully and try again.
  35.  
  36.      9:1.4  Unknown command
  37.  
  38.      The letters you have typed at the "Select command - "
  39.      prompt do not match any of the commands available.
  40.  
  41.      Check what you have typed in carefully against the list
  42.      of commands displayed by entering HELP and try again.
  43.  
  44.      9:1.5  Bad data format
  45.  
  46.      EASISTAT could not read a data file properly. Probably
  47.      one of the data columns appears wider than the maximum
  48.      permitted width of 12 characters.
  49.  
  50.      Make sure that you have not tried to read in a command
  51.      file or something by mistake. Check the format of the
  52.      data file using a word processor or text editor, for
  53.      example the supplied EDIT program, or using the DOS TYPE
  54.      command (described in your DOS MANUAL). To do this from
  55.      EASISTAT try entering:
  56.  
  57.      SYSTEM EDIT datafile.nam
  58.  
  59.      or alternatively:
  60.  
  61.      SYSTEM TYPE datafile.nam |MORE
  62.  
  63.      substituting the name of your data file instead of
  64.      "datafile.nam". Don't forget however that the TYPE
  65.      
  66.        85 
  67.         Error messages and bugs  
  68.      
  69.      command will wrap the text round to fit onto your screen
  70.      so it may be hard to see exactly what is going on.
  71.  
  72.      9:1.6  Could not open file
  73.  
  74.      The file named could not be opened for reading or
  75.      writing.
  76.  
  77.      Check you have given the correct name for the file, and
  78.      make sure that you have also supplied the correct drive
  79.      name and subdirectory if necessary (eg
  80.      B:\ESTAT\FIXED.DAT). You can check the names of files in
  81.      the directory by entering SYSTEM DIR. If you are writing
  82.      to a file make sure the file is not set to "Read only"
  83.      and that the disk is not "Write-protected". Make sure
  84.      that you do not have more files open at once than the
  85.      number specified on your CONFIG.SYS file. Make sure that
  86.      the disk is not full. See your DOS manual for details
  87.      concerning file names, etc.
  88.  
  89.      9:1.7  Not a column
  90.  
  91.      A command or condition was expecting the name of a
  92.      column. It may be that you wanted to select an option or
  93.      row instead, in which case you have not specified them
  94.      correctly.
  95.  
  96.      Check what you have typed in carefully and try again.
  97.  
  98.      9:1.8  Bad value
  99.  
  100.      The value you have entered is not in the legal range.
  101.  
  102.      Check what you have typed in carefully and try again.
  103.  
  104.      9:1.9  Missing value
  105.  
  106.      The command was expecting more values than you typed in.
  107.  
  108.      Start the command again.
  109.  
  110.      9:1.10  Mathematical error in
  111.  
  112.      The program has tried to perform a calculation which is
  113.      nonsensical, like taking the log of a negative number.
  114.  
  115.      Check what you have asked EASISTAT to do. You may have
  116.      given it such a calculation directly, or it may have
  117.      arisen e.g. because one whole column of a chi-squared
  118.      table has zero values in every cell. Sometimes the error
  119.      can be produced by trying to calculate the significance
  120.      of a result whose p value is practically zero, such as a
  121.      t statistic of 60. If this occurs then the result given
  122.      (p = 0.0000) is actually correct and you do not need to
  123.      worry about the error message. If you cannot see any
  124.      reason for the error then it may possibly be due to a bug
  125.      in the program. If you think this may be the case then
  126.      please inform us (see the section titled "Bugs and
  127.      crashes" below).
  128.  
  129.  
  130.  
  131.      
  132.        86 
  133.         Error messages and bugs  
  134.      
  135.      9:1.11  Out of heap memory
  136.  
  137.      Either there is not enough memory available, or you have
  138.      requested an operation which would require zero memory.
  139.  
  140.      Check what you have typed in carefully and see the
  141.      section below titled "Running out of memory".
  142.  
  143.      9:1.12  Out of heap memory - cannot rank values
  144.  
  145.      This is a special message which occurs in the BASICS
  146.      command. There is not enough memory to produce a rank
  147.      table and put the values in order, so the median,
  148.      minimum, maximum and mode cannot be determined although
  149.      the other values are output. The ranks and frequency
  150.      table cannot be produced, and nor can a graph file.
  151.  
  152.      See the section below titled "Running out of memory".
  153.  
  154.      9:1.13  Out of memory in realvec (or in rv2d)
  155.  
  156.      Either there is not enough memory available, or you have
  157.      requested an operation which would require zero memory.
  158.  
  159.      Check what you have typed in carefully and see the
  160.      section below titled "Running out of memory". This error
  161.      message can mess up the appearance of the EASISTAT
  162.      screen. If this happens you can enter SCREEN to redraw
  163.      it.
  164.  
  165.      9:1.14  Stack overflow
  166.  
  167.      We think you shouldn't get this message. If you do check
  168.      you have not made any syntax error. Otherwise the message
  169.      is probably due to a bug in the program, so please inform
  170.      us of it as described below in the section on bugs. In
  171.      the meantime the stack memory available for EASISTAT can
  172.      be expanded in the following way:
  173.  
  174.      Save any data if necessary and quit EASISTAT. Then run
  175.      EASISTAT again by entering:
  176.  
  177.      EASISTAT=30000
  178.  
  179.      This allocates 30000 bytes of memory to the stack (any
  180.      value from 2000 to 30000 may be used).
  181.  
  182.      9:1.15  Not ready error reading drive A Abort, Retry,
  183.      Fail?
  184.  
  185.      This is a DOS error message. You have tried to access a
  186.      disk drive which has no disk in it, or has the door open.
  187.      If the error relates to the hard disk drive then there is
  188.      a fault with the disk and you should seek technical
  189.      assistance from your computer's supplier.
  190.  
  191.      If you meant to access that drive then put the disk in
  192.      the drive and close the door. Then enter R. If you made a
  193.      mistake about the drive you wanted keep entering F until
  194.      the error messages stop.
  195.  
  196.  
  197.      
  198.        87 
  199.         Error messages and bugs  
  200.      
  201.      For details of other disk error messages consult your DOS
  202.      manual.
  203.  
  204.      These error messages can mess up the appearance of the
  205.      EASISTAT screen. If this happens you can enter SCREEN to
  206.      redraw it.
  207.  
  208.      9:1.16  Not ready error writing device PRN Abort, Retry,
  209.      Ignore, Fail
  210.  
  211.      This is a DOS error message. You have tried to access the
  212.      printer and the printer is not turned on, is not "on
  213.      line" or is not connected properly. Please note that this
  214.      message can take a minute or two before it appears (when
  215.      the printer "times out"), giving the impression that the
  216.      program has crashed (see the section on "Bugs and
  217.      crashes" below).
  218.  
  219.      Get rid of the error message by repeatedly entering F
  220.      (for FAIL).
  221.  
  222.      Check the printer is turned on and that the on-line
  223.      switch is on and that there is paper loaded. If this does
  224.      not solve the problem then try to check which port on
  225.      your computer the printer is connected to. If it is
  226.      connected to the first parallel (Centronics) port then
  227.      using LPT1 as a filename should send output to the
  228.      printer. If it is connected to the first or second serial
  229.      port then instead of using PRN as the printer's name use
  230.      COM1 or COM2.
  231.  
  232.      Briefly here's how to find out to which port the printer
  233.      is connected:
  234.  
  235.      1. Quit EASISTAT (saving your data first if necessary).
  236.  
  237.      2. Using a word processor make a small file called TEST,
  238.      e.g. just containing the word "Hello". Quit the word
  239.      processor.
  240.  
  241.      3. Try entering each of the following lines until one of
  242.      them works:
  243.  
  244.      COPY TEST LPT1 
  245.      COPY TEST LPT2 
  246.      COPY TEST COM1 
  247.      COPY TEST COM2 
  248.  
  249.      If none of them work then you've got problems (with your
  250.      system, not with EASISTAT). Check the printer port hasn't
  251.      been assigned to another port with a MODE command in your
  252.      AUTOEXEC.BAT file. If the printer is on a serial port,
  253.      make sure that the baud rate, parity and stop bits for
  254.      that port are set to the correct values for the printer
  255.      with a MODE command in your AUTOEXEC.BAT file. See your
  256.      DOS and printer manuals for detailed instructions on
  257.      connecting the printer. Good luck.
  258.  
  259.      This error message can mess up the appearance of the
  260.      EASISTAT screen. If this happens you can enter SCREEN to
  261.      redraw it.
  262.  
  263.      
  264.        88 
  265.         Error messages and bugs  
  266.      
  267.      Note
  268.  
  269.      If you have a PostScript printer then you cannot send any
  270.      plain text output to it directly. You would have to first
  271.      read the text into a word processor that is configured to
  272.      produce PostScript output and then print the text out
  273.      from that. Computers connected to networks may also need
  274.      special printing commands to print out over a network
  275.      printer and you should consult the relevant network
  276.      documentation for instructions on how to do that.
  277.  
  278.  
  279.      9:2. What to do if you get
  280.      an error message
  281.  
  282.      There are essentially two different kinds of error
  283.      message. One is caused by the user making a mistake in
  284.      what he or she types in - a syntax error, a spelling
  285.      mistake or giving the wrong name or pathname for a file.
  286.      The other kind is when the computer runs out of memory or
  287.      runs into mathematical problems like trying to divide by
  288.      zero. Things are not quite so clear-cut, because in fact
  289.      the commonest reason for the program to produce the
  290.      second kind of error message is also because the user and
  291.      told it to do something silly, like make a chi-squared
  292.      table with zero rows. We have tried to trap most of these
  293.      errors, but a few have got through.
  294.  
  295.      If you get an error message, first check carefully that
  296.      you have not made a typing mistake. If not, and
  297.      especially if you get one of the "out of memory"
  298.      messages, then it may be that you are exceeding the
  299.      program's capacity. Although we have tried to guard
  300.      against it, there is a risk that the program may crash or
  301.      "hang up", which means that absolutely nothing at all
  302.      happens when you push any of the keys. Should this happen
  303.      there will be nothing you can do except reset the
  304.      computer or turn it off and on again. Because of the risk
  305.      of this, if you get an error message which you cannot
  306.      otherwise explain we advise you immediately to save your
  307.      data to a file and to close your output and log files. Do
  308.      not save your data to the same file that you read it
  309.      from, but to a new file with a different name. All these
  310.      precautions are to minimise the risk of an error in your
  311.      program damaging ("corrupting") any of your files or
  312.      leaving you stuck unable to save your data.
  313.  
  314.  
  315.      9:3. Running out of memory
  316.  
  317.      If you get an "Out of memory" message the most likely
  318.      reason is not that the computer is running out of memory,
  319.      but that you have asked it to do something silly which
  320.      requires zero memory, so check this first. If you get an
  321.      "Out of stack memory" message then it may be that you are
  322.      asking the program to perform an especially complicated
  323.      calculation, though to be honest we don't think that this
  324.      is likely to happen. However should it occur first check
  325.      that you have not made a mistake and then try to simplify
  326.      what you are asking the program to do, perhaps by doing
  327.      it in stages. Or see the section above on error messages
  328.      for details of expanding the available stack.
  329.      
  330.        89 
  331.         Error messages and bugs  
  332.      
  333.      EASISTAT tries very hard to use as much as of the
  334.      computer's memory as it can, and to do this it ends up
  335.      putting things in all sorts of nooks and crannies. If you
  336.      find that you are running out of memory with a particular
  337.      command it is possible that the following procedure may
  338.      help:
  339.  
  340.      Make sure that all the data you want saved is saved and
  341.      then quit EASISTAT. Make sure that no other programs are
  342.      running. Look in the CONFIG.SYS and AUTOEXEC.BAT files
  343.      for any "memory resident" programs. These are programs
  344.      that carry on running all the time the computer is turned
  345.      on - any "pop-up" programs that you can call up at any
  346.      time by hitting a certain key combination fall into this
  347.      category, including the pop-up calculator we provide,
  348.      EASIMATH. Also check that if you have a command to
  349.      install a "ramdrive" in your CONFIG.SYS file that the
  350.      drive is installed above the 640K DOS limit and not below
  351.      (see your DOS manual for details). If you have any of the
  352.      above commands in these two files, temporarily remove
  353.      them and then reset your computer. Enter CHKDSK to see
  354.      how much memory is available (if it asks you any
  355.      questions just enter N for "No"). As a rough guide a 640K
  356.      computer should normally have something over 590000 bytes
  357.      free. Now run EASISTAT and load the data. Then select the
  358.      command that made you run out of memory previously and
  359.      try to perform it again before you use any other
  360.      commands. If it still doesn't work then there really
  361.      isn't enough memory and all you can do is try to make
  362.      your data set smaller by deleting any columns that you
  363.      don't require for that analysis and trying again.
  364.  
  365.  
  366.      9:4. Bugs and crashes
  367.  
  368.      Sometimes if there is something wrong with EASISTAT or
  369.      one of the other programs your computer is running at the
  370.      same time then your computer can "hang up" or "crash". If
  371.      the computer hangs up or crashes then none of the keys
  372.      you press will have any effect, except sometimes to make
  373.      a beeping noise. If this happens you are probably going
  374.      to have to reset the computer, or turn it off and on
  375.      again. Your computer will not be damaged in any way, but
  376.      any data or results not saved to disk will be lost.
  377.      Before you do this check the following points:
  378.  
  379.      1. Make sure the program is not just performing a long
  380.      calculation.
  381.  
  382.      2. Make sure you have not tried to send something to the
  383.      printer or "PRN" without having the printer connected,
  384.      turned on and on line. If you have then you may have to
  385.      wait a couple of minutes for the printer to "time out"
  386.      and display the "Not ready writing device PRN" message.
  387.  
  388.      3. Make sure you have not tried to read or write to a
  389.      disk which is not in a drive or which has the drive door
  390.      open. If you have done this then it should time out quite
  391.      quickly and give you an error message, but it's worth
  392.      checking.
  393.  
  394.  
  395.      
  396.        90 
  397.         Error messages and bugs  
  398.      
  399.      If none of these things have happened then the program
  400.      has crashed and you will have to reset the computer and
  401.      start again. Try to see if you can see what caused the
  402.      crash.
  403.  
  404.      It is conceivable that stack overflow could cause a crash
  405.      without the "Stack overflow" message being printed. If
  406.      EASISTAT does crash and you cannot see any other reason
  407.      why then it may worth running it again with the stack set
  408.      to a higher value as described in the section above.
  409.  
  410.      Bugs
  411.  
  412.      A "bug" is something wrong with the way that the program
  413.      is written which causes it to behave in a way other than
  414.      that intended or expected. We aim to correct as many bugs
  415.      in EASISTAT as possible, and we aim to inform users of
  416.      any uncorrected bugs of which we are aware. However in
  417.      such a large and complex program it is always possible
  418.      that some bugs may have crept through of which we are
  419.      unaware, and so we ask users to inform us if they find
  420.      one of these so that it can be corrected or at least so
  421.      that other users can be warned of it. Sometimes a program
  422.      can behave in the way that the programmer wants it to,
  423.      but that may not be the way in which a particular user
  424.      expects it to behave. This turns into an argument about
  425.      whether something is a "bug" or a "feature". In this
  426.      manual we have try to clarify as far as possible exactly
  427.      what the program does, especially where it behaves in a
  428.      way which might not be expected.
  429.  
  430.      Known bugs
  431.  
  432.      Sometimes the error message produced by EASISTAT does not
  433.      give a very clear picture of what the actual problem is.
  434.  
  435.      If the program runs out of room when writing a file to
  436.      disk then it will not inform you, but leave the file
  437.      incomplete. Therefore always make sure there is plenty of
  438.      room available on disk (by using the DIR command
  439.      available from DOS e.g. by entering SYSTEM DIR).
  440.  
  441.      It is possible for mathematical overflow errors to occur
  442.      when performing some of the significance tests, in
  443.      particular those in which a value is divided by its
  444.      standard error and the result is taken to approximate a t
  445.      statistic as is done for regression tests. With large
  446.      numbers of values the significance test can then amount
  447.      to, for example, the probability value of t=69 with 1000
  448.      degrees of freedom. This is clearly highly significant,
  449.      but attempting to calculate the exact probability may
  450.      cause a mathematical error. The "correct" value of 0.0000
  451.      will still be given but an error will be reported. This
  452.      is harmless, but disconcerting if one does not know the
  453.      reason for it.
  454.  
  455.      Unknown bugs
  456.  
  457.      Apart from causing the computer to hang up, other
  458.      symptoms of bugs are that the program produces long
  459.      strings of meaningless characters and beeps, or very
  460.      large long numbers which are obviously nonsensical. Bugs
  461.      
  462.        91 
  463.         Error messages and bugs  
  464.      
  465.      may also simply produce incorrect answers. We are not
  466.      aware of any that do this, but if you suspect their
  467.      existence then please let us know at once.
  468.  
  469.      We would like to fix any bugs in the program, so please
  470.      do let us know of any circumstances which produce a crash
  471.      or garbage output. If you cannot see why the program
  472.      should have gone wrong at this point then please supply
  473.      us also with as much as possible of the following
  474.      information (on a disk if possible):
  475.  
  476.      1. Contents of your data file.
  477.  
  478.      2. Exact sequence of commands leading to crash.
  479.  
  480.      3. Make and model of your computer, plus any peripheral
  481.      devices you have connected to it.
  482.  
  483.      4. Contents of your AUTOEXEC.BAT and CONFIG.SYS files,
  484.      and the names of any memory-resident programs you have
  485.      loaded.
  486.  
  487.      5. Version of DOS (find this out by entering VER at the
  488.      DOS prompt).
  489.  
  490.      6. Version of EASISTAT (displayed when program is first
  491.      run).
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.      
  528.        92 
  529.