home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / finance / pqlite.zip / PQLITE.DOC < prev    next >
Text File  |  1990-08-23  |  418KB  |  12,674 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                   ProQube Lite (tm)
  16.                                      User Manual
  17.                                       Version 1
  18.  
  19.  
  20.  
  21.                               Copyright FormalSoft 1990
  22.                                  All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.      No part of this documentation may be reproduced in whole or in part without
  33.      the prior written permission of FormalSoft.
  34.  
  35.      Acknowledgements:   Kim  Kokkonen,  for   routines  used  to   enhance  the
  36.                          performance of ProQube Lite.
  37.  
  38.  
  39.      Trademarks:         FormalSoft, ProQube 3D, and ProQube Lite are trademarks
  40.                          of FormalSoft.
  41.  
  42.                          All other  brand and  product names  are trademarks  or
  43.                          registered trademarks of their respective companies.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.            FormalSoft  *  PO Box 1913  *  Sandy, UT 84091  *  801-565-0971
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.      CONTENTS
  76.  
  77.      ABOUT THE DOCUMENTATION . . . . . . . . . . . . . . . . . . . . . . . .   1
  78.  
  79.      GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  80.           INSTALLING PROQUBE LITE  . . . . . . . . . . . . . . . . . . . . .   2
  81.           HOW TO RUN PROQUBE LITE  . . . . . . . . . . . . . . . . . . . . .   3
  82.  
  83.      PROQUBE LITE BASICS . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  84.           THE WORKQUBE . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  85.           HOW TO GET HELP  . . . . . . . . . . . . . . . . . . . . . . . . .   7
  86.           MOVING AROUND THE WORKQUBE . . . . . . . . . . . . . . . . . . . .   8
  87.           ENTERING AND EDITING DATA  . . . . . . . . . . . . . . . . . . . .  10
  88.           HOW TO ENTER AND USE FORMULAS  . . . . . . . . . . . . . . . . . .  12
  89.           RELATIVE AND ABSOLUTE CELL REFERENCES  . . . . . . . . . . . . . .  15
  90.           DEFINING A BLOCK OF CELLS  . . . . . . . . . . . . . . . . . . . .  16
  91.           BUILT-IN @FUNCTIONS  . . . . . . . . . . . . . . . . . . . . . . .  18
  92.           USING THE COMMAND MENUS  . . . . . . . . . . . . . . . . . . . . .  19
  93.           USING THE FUNCTION KEYS  . . . . . . . . . . . . . . . . . . . . .  20
  94.           SAVING AND RETRIEVING DATA . . . . . . . . . . . . . . . . . . . .  21
  95.           USING THE FILE MANAGER . . . . . . . . . . . . . . . . . . . . . .  22
  96.           CHANGING YOUR SPREADSHEET'S APPEARANCE . . . . . . . . . . . . . .  23
  97.           USING THE MULTIPLE PAGES . . . . . . . . . . . . . . . . . . . . .  26
  98.           CHANGING THE VIEW  . . . . . . . . . . . . . . . . . . . . . . . .  28
  99.           PRINTING YOUR DATA . . . . . . . . . . . . . . . . . . . . . . . .  32
  100.           RECORDING A MACRO  . . . . . . . . . . . . . . . . . . . . . . . .  33
  101.           THE PROQUBE LITE TEXT EDITOR . . . . . . . . . . . . . . . . . . .  34
  102.           THE PROQUBE LITE APPLICATION LANGUAGE  . . . . . . . . . . . . . .  36
  103.  
  104.      REFERENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  105.           THE FUNCTION KEYS  . . . . . . . . . . . . . . . . . . . . . . . .  38
  106.           PROQUBE LITE COMMAND MENUS . . . . . . . . . . . . . . . . . . . .  43
  107.           BUILT-IN FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . .  93
  108.  
  109.      PROQUBE LITE APPLICATIONS . . . . . . . . . . . . . . . . . . . . . . . 153
  110.           CREATING AN APPLICATION  . . . . . . . . . . . . . . . . . . . . . 154
  111.           RUNNING AN APPLICATION . . . . . . . . . . . . . . . . . . . . . . 155
  112.           LANGUAGE DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . 156
  113.           SPECIAL KEY NAMES  . . . . . . . . . . . . . . . . . . . . . . . . 158
  114.           THE PROQUBE COMMAND LANGUAGE . . . . . . . . . . . . . . . . . . . 159
  115.  
  116.      APPENDIX A  SUPPLEMENT PROGRAMS . . . . . . . . . . . . . . . . . . . . 181
  117.           QUBECALC CONVERSION PROGRAM  . . . . . . . . . . . . . . . . . . . 181
  118.           THE SETUP PROGRAM  . . . . . . . . . . . . . . . . . . . . . . . . 182
  119.  
  120.      APPENDIX B  DESIGN HINTS  . . . . . . . . . . . . . . . . . . . . . . . 184
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                           i
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.      LICENSE AGREEMENT
  142.  
  143.      ProQube Lite is distributed as Shareware.  It is not free software,  nor is
  144.      it in the public domain.  You are granted a  limited license to use ProQube
  145.      Lite on  a trial basis.   If you want  to continue using ProQube  Lite, you
  146.      should register with FormalSoft using the form provided on the next page. 
  147.  
  148.      If ProQube Lite is used on multiple machines (or on a network), then a copy
  149.      must be purchased for as many copies as will be running simultaneously.
  150.  
  151.      You are also  granted a limited license to copy and distribute ProQube Lite
  152.      for evaluation by others on the following conditions:
  153.  
  154.      - You may NOT  charge anything for ProQube  Lite itself.  You may  charge a
  155.      copying fee (not to exceed $8) to cover disks and handling.  
  156.  
  157.      - You may NOT copy the printed documentation in any manner or form.  
  158.  
  159.      - You may  NOT bundle  ProQube Lite  with any other  product without  prior
  160.      written permission from FormalSoft.
  161.  
  162.      - You may NOT distribute versions of  ProQube Lite which have been modified
  163.      in any way.
  164.  
  165.      - You must  include ALL  of the  files which are  distributed with  ProQube
  166.      Lite.  These files  must  be ARCHIVED  together  if you  place  them on  an
  167.      electronic bulletin board.  
  168.  
  169.  
  170.  
  171.  
  172.      WHAT IF I NEED EVEN MORE POWER?
  173.  
  174.      FormalSoft  also  offers a  commercial  (non-Shareware) spreadsheet  called
  175.      ProQube 3D.   ProQube 3D contains all of the features of ProQube Lite, plus
  176.      presentation  graphics,  database  querying and  entry  forms, goalseeking,
  177.      auditing, network file  locking, expanded memory support,  more @functions,
  178.      enhanced macro language, file  encryption, and much more.   And ProQube  3D
  179.      can directly read your ProQube Lite files.
  180.  
  181.      According  to Jim Seymour in Today's Office, "It  is one of the best -- and
  182.      best implemented -- new ideas in spreadsheets in a long time."
  183.  
  184.      ProQube 3D is priced at  $99, and is available  either directly from us  or
  185.      through your local dealer.
  186.  
  187.      [NOTE: Because ProQube 3D is not Shareware, the ProQube 3D license does NOT
  188.      allow you to copy and distribute the program to others.]
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                           ii
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                                   Registration Form
  208.                                   -----------------
  209.      TO ORDER:
  210.  
  211.      Send this form & payment to:  FormalSoft
  212.                                    P.O. Box 1913
  213.                                    Sandy, UT. 84091-1913
  214.  
  215.      Or call our voice number:     801-565-0971
  216.  
  217.      Or call our BBS conference:   BEACONetwork 801-298-5222 (N-8-1)
  218.                                    Join  the  conference  after  logging  on  by
  219.                                    typing J PROQUBE at the main menu.
  220.  
  221.  
  222.      Please send me the following product:
  223.  
  224.      [ ] ProQube Lite for $29 ($25 + $4 s/h).  Registered ProQube Lite users may
  225.      upgrade at any time to ProQube 3D for $74.
  226.  
  227.      [  ]  ProQube 3D  for $103  ($99 +  $4  s/h).   ProQube 3D  is FormalSoft's
  228.      commercial 3D spreadsheet which  provides all the features of  ProQube Lite
  229.      plus presentation graphics, database querying and entry forms, goalseeking,
  230.      auditing, network file  locking, expanded memory support,  more @functions,
  231.      enhanced macro language, file encryption, and much more.
  232.  
  233.      * Utah residents please add 6.25% sales tax.
  234.  
  235.      Name:____________________________________________________________________ 
  236.  
  237.      Company:_________________________________________________________________
  238.                  
  239.      Address:_________________________________________________________________
  240.                  
  241.      City, State, Zip:________________________________________________________
  242.  
  243.      Country:_________________________________________________________________
  244.  
  245.                  
  246.      ___ CHECK (US $ drawn on US bank only)   ___ VISA/MC   ___ American Express
  247.  
  248.      Credit card #_________________________________   Exp date_______________
  249.  
  250.      Signature_______________________________________________________________
  251.  
  252.  
  253.  
  254.      Where did you get your copy from?______________________________________
  255.  
  256.      Comments?______________________________________________________________
  257.  
  258.      _______________________________________________________________________
  259.  
  260.                                          iii
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.      ABOUT THE DOCUMENTATION
  274.  
  275.      The  ProQube  Lite  documentation  is  divided  into several  sections,  to
  276.      accommodate  all levels  of users.   Regardless of how  much experience you
  277.      have  with  spreadsheets, you  should read  Getting  Started for  help with
  278.      installing ProQube Lite on your system.
  279.  
  280.      If you  are new to spreadsheets, then  you will want to  start with ProQube
  281.      Lite Basics,  to learn  about how  spreadsheets  work in  general, and  how
  282.      ProQube Lite works  in specific.   You may  also want to  run the  tutorial
  283.      program described in the Getting Started section.
  284.  
  285.      If  you are a spreadsheet wizard,  you may still want  to skim over ProQube
  286.      Lite Basics, because  there are many features in ProQube Lite which are not
  287.      available in any other spreadsheet.
  288.  
  289.      Getting Started               This  section  describes   how  to   install,
  290.                                    configure, and run ProQube Lite.
  291.  
  292.      ProQube Lite Basics           This section provides an overview of  ProQube
  293.                                    Lite's capabilities.
  294.  
  295.      ProQube Lite Reference        This section describes each of ProQube Lite's
  296.                                    commands, functions and  features, and how to
  297.                                    use them.
  298.  
  299.      ProQube Lite Applications     This  section  describes the  ProQube Command
  300.                                    Language (PCL), and  how to use it  to create
  301.                                    sophisticated application programs.
  302.  
  303.      Appendix                      This section provides detailed information on
  304.                                    supplementary programs, design hints, etc.
  305.  
  306.      In this documentation, special keys are surrounded  by angle brackets.  For
  307.      example  the enter  key is designated  by <Enter>,  the F1 function  key is
  308.      designated by <F1> and so on.  So when you are asked to type the following:
  309.  
  310.      PQLITE<Enter>
  311.  
  312.      it means to type the word PQLITE, then press the <Enter> key.
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                           1
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.      GETTING STARTED
  340.  
  341.      INSTALLING PROQUBE LITE
  342.      You should have the following files:
  343.  
  344.      README              Important information.
  345.      ORDER.DOC           ProQube Lite order form.
  346.      PQLITE.EXE *        The ProQube Lite program.
  347.      PQLITE.OVR *        Another part of the program.
  348.      PQLITE.HLP          The help file.
  349.      PQLITE.ERR *        The error message file.
  350.      CONVERT.EXE         Converts QubeCalc files to ProQube Lite files.
  351.      SETUP.EXE           Lets you set colors and options.
  352.      PQLITE.DOC          The on-disk ProQube Lite user manual.
  353.      PRINTDOC.EXE        Prints the on-disk manual to your printer.
  354.  
  355.      After  you  run ProQube,  you  may  also  see  files named  PQLITE.CFG  and
  356.      PQLITE.SET.  These are files which ProQube uses  to store information about
  357.      your various settings.
  358.  
  359.      * ProQube Lite works best when run from your hard disk.  If you want to run
  360.      ProQube Lite from  a floppy, the files marked with an asterisk are the only
  361.      ones that have to be on the disk.
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                           2
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.      HOW TO RUN PROQUBE LITE
  406.  
  407.      To Start       To start ProQube Lite on your computer:
  408.  
  409.                     - Turn on your computer
  410.                     - Change to the directory where the ProQube Lite files are
  411.                     - Type PQLITE<Enter>
  412.  
  413.                     If  you  want to  have  a  file  retrieved immediately  upon
  414.                     booting up ProQube Lite,  simply add the file's name  on the
  415.                     command line.  For example, if you want to start up with the
  416.                     file named EXAMPLE.PQS, then  enter PQLITE EXAMPLE<Enter> at
  417.                     the DOS prompt to begin running the program.
  418.  
  419.      The Menus      When you want to execute a command in ProQube Lite, you will
  420.                     usually select it from  ProQube Lite's menu system.   A menu
  421.                     is simply a list of commands which you can select from.  All
  422.                     you have to  do to bring up  ProQube Lite's main menu  is to
  423.                     press the /  key.  If  you are using  a mouse, then  you can
  424.                     also bring up ProQube Lite's main  menu by pressing the left
  425.                     mouse button.  This manual will often refer to menu commands
  426.                     like /File  Retrieve.  This refers to  the command performed
  427.                     when  you  press /,  then select  File  from the  menu, then
  428.                     select Retrieve from the submenu.
  429.  
  430.      Special Keys   ProQube Lite assigns several  of its commands to one  of the
  431.                     10 function  keys  (<F1> through  <F10>)  instead of  or  in
  432.                     addition  to the  command menus.   These  commands  are ones
  433.                     which  you  might normally  want  to  select with  a  single
  434.                     keystroke.
  435.  
  436.      Help           ProQube  Lite   provides  extensive  online   help  for  its
  437.                     features.  To call up this  help, simply press the <F1> Help
  438.                     key at any point in the program.  A help screen  will pop up
  439.                     which  provides  information  about  the operation  you  are
  440.                     attempting.
  441.  
  442.      To Quit        Exiting  from  ProQube Lite  is  just  one of  the  commands
  443.                     available in ProQube Lite's command menus.   To quit, simply
  444.                     press the / key to  bring up the menu, and then press  Q for
  445.                     Quit.
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                           3
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.      PROQUBE LITE BASICS
  472.  
  473.      This section  is intended  you get you  up and  running with  ProQube Lite.
  474.      Even if you are already  familiar with spreadsheet programs, you  will want
  475.      to  at least read  a few of  the chapters in this  section, because ProQube
  476.      Lite  contains  many  features  which  are   not  available  in  any  other
  477.      spreadsheet program.
  478.  
  479.  
  480.  
  481.      THE WORKQUBE
  482.  
  483.      A spreadsheet may be thought of as  a large electronic worksheet, much like
  484.      a piece of paper divided into rows and columns, like this:
  485.  
  486.                   A   B   C   D   E   F   G   H
  487.                 ---------------------------------
  488.                1|   |   |   |   |   |   |   |   |
  489.                 |---|---|---|---|---|---|---|---|
  490.                2|   |   |   |   |   |   |   |   |
  491.                 |---|---|---|---|---|---|---|---|
  492.                3|   |   |   |   |   |   |   |   |
  493.                 |---|---|---|---|---|---|---|---|
  494.                4|   |   |   |   |   |   |   |   |
  495.                 |---|---|---|---|---|---|---|---|
  496.                5|   |   |   |   |   |   |   |   |
  497.                 |---|---|---|---|---|---|---|---|
  498.                6|   |   |   |   |   |   |   |   |
  499.                 |---|---|---|---|---|---|---|---|
  500.                7|   |   |   |   |   |   |   |   |
  501.                 ---------------------------------
  502.  
  503.      A  ProQube Lite  worksheet has  512  rows and  512  columns.   In order  to
  504.      distinguish columns from each  other, ProQube Lite assigns a letter  of the
  505.      alphabet to each column.  The first 26 columns are labeled with the letters
  506.      A  through  Z.   Since  there are  512  columns  but only  26  letters, the
  507.      remaining columns  must use  2  letters to  identify  them.   ProQube  Lite
  508.      assigns each of the  rows in a worksheet a  number from 1 to 512.   The top
  509.      row in a worksheet is row 1 and the bottom row is row 512.
  510.  
  511.      ProQube  Lite provides  you with 512  of these  worksheets, one  behind the
  512.      other.  The front page  is page 1, the second is page 2,  and so on through
  513.      page 512.  This collection of pages is called the WorkQube.
  514.  
  515.      The  area where a row and a  column cross is known as  a cell. Each cell in
  516.      the WorkQube is identified  by the letter (or letters) of  the column it is
  517.      in,  the number of the row it  is in, and the number of  the page it is on.
  518.      For example, the  cell that is in  column R and row  29 on page 4  is named
  519.      R29;4 (the column letters  always come before the row number,  and the page
  520.      number is separated by a semicolon). Each one of the cells may contain some
  521.      text, a number, or a formula.
  522.  
  523.  
  524.                                           4
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.      When you first run ProQube Lite, the  following display will appear on your
  538.      monitor.
  539.  
  540.  
  541.      [Front] A1;1: (W9) BLANK <Default >
  542.  
  543.      1       A       B       C       D       E       F       G       H
  544.        1
  545.        2
  546.        3
  547.        4
  548.        5
  549.        6
  550.        7
  551.        8
  552.        9
  553.       10
  554.       11
  555.       12
  556.       13
  557.       14
  558.       15
  559.       16
  560.       17
  561.       18
  562.       19
  563.       20
  564.         1=Help 2=Edit 3=Block 4=Absolute 5=GoTo 6=Search 7=Load 8=Save 9=Recalc
  565.  
  566.  
  567.      Since it is impossible to  view all 512 rows,  columns, and pages at  once,
  568.      this display provides a window looking  into the WorkQube.  The letters  of
  569.      the columns which are on the screen are displayed in a horizontal bar above
  570.      the  columns, while  the numbers of  the rows  which are on  the screen are
  571.      displayed in a vertical bar to the left of the rows.  ProQube Lite displays
  572.      the page number in the upper left corner where these two bars meet.
  573.  
  574.      A status line is  located in the upper left corner of  the screen and looks
  575.      something like this:
  576.  
  577.      [Front] A1;1: (W9) BLANK <Default >
  578.  
  579.      Each component of the status line  tells you certain information about  the
  580.      current perspective  and cell.   [Front] tells  you that you  are currently
  581.      viewing the WorkQube from the front.   A1;1 tells you that the cell you are
  582.      currently at is in  column A, row 1, and  page 1.  (W9) tells you  that the
  583.      column you are in is 9 characters wide.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                           5
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.      BLANK tells you that  the cell you  are at is currently  blank.  This  item
  604.      tells you what is currently in the cell:
  605.  
  606.           BLANK     - a blank cell
  607.           TEXT      - a line of text
  608.           NUMBER    - a number
  609.           FORMULA   - a formula with a numeric result
  610.           TXTFORM   - a formula with a text result
  611.           FORMAT    - a blank cell which contains formatting information
  612.           ERROR     - a formula which has an error value
  613.  
  614.      The  bottom line  of the  display is  an index  to the  function  keys <F1>
  615.      through <F10>  so you don't  have to  memorize or look  them up.   Pressing
  616.      <Ctrl>  changes this index  to reflect the  operation of the  function keys
  617.      when used in combination with the <Ctrl> key.
  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.                                           6
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.      HOW TO GET HELP
  670.  
  671.      ProQube Lite  provides extensive online help for its  features.  To call up
  672.      this help, simply press the  <F1> Help key at any point in the  program.  A
  673.      help screen will pop  up which provides information about the operation you
  674.      are attempting.
  675.  
  676.      ProQube Lite's help is context-sensitive.  This means that ProQube  Lite is
  677.      always keeping  track of  what you  are doing  so that it  can provide  the
  678.      proper help  screen when you ask  for it.   For example, if you  press <F1>
  679.      when you are trying to copy a cell, then a  help screen which explains that
  680.      feature will pop up.
  681.  
  682.      ProQube Lite's help is also interactive.   This means that the help  screen
  683.      which pops  up will also list several other  help screens which are related
  684.      to what you are doing.   You may view one of these related  help screens by
  685.      simply using the <Left>  and <Right> keys (or moving the mouse) to move the
  686.      highlight bar to the name of the help screen desired, and then pressing the
  687.      <Enter> key or left mouse button, or by simply pressing the first letter of
  688.      the desired help screen's name.
  689.  
  690.      You  may also call  up a list  of help screens  called the  <HELP INDEX> by
  691.      pressing the <F1>  key a second  time, or by pressing  the right button  on
  692.      your mouse.
  693.  
  694.      After you have  read the help screens  that interest you, simply  press the
  695.      <Esc> key (or  both mouse keys simultaneously)  to return to what  you were
  696.      doing.
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                           7
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.      MOVING AROUND THE WORKQUBE
  736.  
  737.      ProQube Lite's workspace  contains over  134 million cells,  and it's  very
  738.      important to be able to move easily to all  of them.  You move from cell to
  739.      cell by moving the "cell pointer".   The cell pointer is a  highlighted bar
  740.      on the  screen which  "points to"  the cell in  the WorkQube  which is  the
  741.      current cell.  The address of the current cell is displayed on the top line
  742.      of the ProQube Lite screen.
  743.  
  744.      ProQube Lite provides many ways to move the cell pointer.
  745.  
  746.      <Up> <Down>
  747.      <Left> <Right> These keys move  the cell pointer  up, down, left, or  right
  748.                     one cell  position.   If you try  to move  the cell  pointer
  749.                     beyond  the edge  of the  display, the  display window  will
  750.                     scroll  over to the next row or  column (assuming there is a
  751.                     row or column to scroll to).
  752.  
  753.      <PgUp> *       This key  moves the cell pointer up  to the next higher page
  754.                     number.  The cell pointer will be moved to the cell with the
  755.                     same  row  coordinate and  column  coordinate (but  the next
  756.                     higher page coordinate)  as the  cell you moved  from.   For
  757.                     example, if you are in cell G5;2  and press <PgUp>, the cell
  758.                     pointer will move to cell G5;3.
  759.  
  760.      <PgDn> *       This key  moves the cell pointer down to the next lower page
  761.                     number.  The cell pointer will be moved to the cell with the
  762.                     same  row  coordinate and  column  coordinate (but  the next
  763.                     lower page  coordinate) as  the cell  you moved  from.   For
  764.                     example, if you are in cell G5;2 and press <PgUp>,  the cell
  765.                     pointer will move to cell G5;1.
  766.  
  767.      <Home>         This key  moves the cell pointer  to the top left  corner of
  768.                     the current page (cell A1 on the current page).
  769.  
  770.      <End>          This key  operates  in a  different  manner than  the  other
  771.                     movement keys.    Pressing  <End> does  not  move  the  cell
  772.                     pointer itself,  but changes  the way  the <Left>,  <Right>,
  773.                     <Up>, <Down>, <PgUp>, <PgDn>  and <Home> keys work.   If you
  774.                     press the <End> key and then one of the arrow keys or <PgUp>
  775.                     or <PgDn>, then  the cell pointer  will move in  one of  the
  776.                     following ways:
  777.  
  778.                     - If the cell pointer  is in a blank  cell, it will move  in
  779.                     the direction selected to the first non blank cell.
  780.  
  781.                     -  If the cell pointer is in a  non blank cell, it will move
  782.                     in the direction selected to the  last non blank cell before
  783.                     a blank cell.
  784.  
  785.                     If  you press  the  <End> key  followed  immediately by  the
  786.                     <Home> key, the  cell pointer will  move to the cell  in the
  787.  
  788.                                           8
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.                     lower right corner of the page.
  802.  
  803.                     If you want to cancel out the effect of the <End>  key after
  804.                     you have pressed it, simply press <End> a second time.
  805.  
  806.      <^Right>       This key sequence moves the  cell pointer one screen's worth
  807.                     of columns to the right.  This key  sequence is generated by
  808.                     holding down the <Ctrl> key and pressing <Right>.
  809.  
  810.      <^Left>        This key sequence  moves the cell pointer one screen's worth
  811.                     of columns to  the left.  This key sequence  is generated by
  812.                     holding down the <Ctrl> key and pressing <Left>.
  813.  
  814.      <^PgUp> *      This  key sequence  moves the  cell pointer up  one screen's
  815.                     worth of rows.   This key  sequence is generated by  holding
  816.                     down <Ctrl> and pressing <PgUp>.
  817.  
  818.      <^PgDn> *      This key sequence  moves the cell pointer down  one screen's
  819.                     worth of rows.   This key  sequence is generated by  holding
  820.                     down <Ctrl> and pressing <PgDn>.
  821.  
  822.      <^Home>        This key  moves the cell pointer  to the upper left  cell on
  823.                     the current display.
  824.  
  825.      <^End>         This key moves  the cell pointer to the  lower right cell on
  826.                     the current display.
  827.  
  828.      <F5>           This key moves  the cell  pointer anywhere you  tell it  to.
  829.                     ProQube Lite will  ask you which cell you want to go to, and
  830.                     you just type in the cell name and hit <Enter>.
  831.  
  832.      In addition to  the various movement  keys, ProQube Lite provides  built-in
  833.      mouse support.   If you have a  mouse and have installed  your mouse driver
  834.      before running ProQube Lite,  then you can move the cell  pointer by simply
  835.      moving the mouse in the direction you want to go.
  836.  
  837.      * The functions of the <PgUp>/<PgDn> keys can be swapped with those of  the
  838.      <^PgUp>/<^PgDn> keys  by first running  the program SETUP.COM  described in
  839.      Appendix A.
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                           9
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.      ENTERING AND EDITING DATA
  868.  
  869.      You can enter numbers  or text into any of the cells in the WorkQube.  Just
  870.      move the cell pointer  to the cell you want  to enter a number or  text in,
  871.      and type the number or text.  You may enter up to 240 characters  into each
  872.      cell.   The number  or text will  be entered into  the cell as  soon as you
  873.      press <Enter> or one of  the movement key sequences (<Up>, <Down>,  <Left>,
  874.      <Right>, <PgUp>,  or <PgDn>).   If you finish  entering the data  using the
  875.      <Enter> key, the  cell pointer will remain positioned at the same cell.  If
  876.      you finish entering the data using one of  the movement keys, the data will
  877.      be entered into the  current cell, and then the  cell pointer will move  to
  878.      another cell in the direction you specified.
  879.  
  880.      Numbers        A number can range in value from -10E+37 to 10E+37, and  can
  881.                     have up  to 11 significant places.   You can  enter a number
  882.                     into a cell using either standard  notation (like 12.345) or
  883.                     scientific notation (like 1234.5e-2).
  884.  
  885.      Text           If you enter a  line of text which contains  more characters
  886.                     than the column  is wide, it  will spill over into  adjacent
  887.                     cells (if the  adjacent cells are  blank).  If the  adjacent
  888.                     cells contain data,  then the extra  characters in the  text
  889.                     string will be hidden  from view (but they will still  be in
  890.                     the cell).   If you want to see  the entire string, you must
  891.                     widen the column containing the text.
  892.  
  893.                     The way  your text  is displayed  in a  cell depends on  the
  894.                     first character of  the text.   There are four (4)  possible
  895.                     characters which can precede your  text and which affect the
  896.                     way the text is displayed.  These characters are:
  897.  
  898.                     ' causes the text to be left justified in the cell
  899.                     " causes the text to be right justified in the cell
  900.                     ^ causes the text to be centered in the cell
  901.                     \ causes the next character to be repeated
  902.  
  903.                     If you  enter some  text without  one of  the above  special
  904.                     characters  as  the  first   character,  ProQube  Lite  will
  905.                     automatically place the global justify character on the text
  906.                     for  you.   You  can select  or  change this  global justify
  907.                     character with  the /WorkQube  Justify command  on the  main
  908.                     menu.   Once the text has been entered  into a cell, you may
  909.                     change the justification  using either the /Cell  Justify or
  910.                     the /Block Justify  commands (or  use the <F2>Edit  function
  911.                     key to  enter edit  mode and just  change the  justification
  912.                     character to the one you want).
  913.  
  914.      Editing        If you need  to change an entry in a cell, but don't want to
  915.                     retype the entire  thing, ProQube Lite provides  the ability
  916.                     to edit your entry. Simply move the cell pointer to the cell
  917.                     you want to edit, and  press the <F2> Edit key.  If there is
  918.                     anything in the  cell to edit,  ProQube Lite will enter  its
  919.  
  920.                                           10
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                     editing mode.   Also, if you make  an error when entering  a
  934.                     formula   this    editing   capability   will    be   called
  935.                     automatically.
  936.  
  937.                     When you are  in edit mode,  the following editing keys  are
  938.                     available:
  939.  
  940.                     <Left>    moves the cursor one character to the left.
  941.                     <Right>   moves the cursor one character to the right.
  942.                     <Home>    moves the  cursor to  the first  character on  the
  943.                               line.
  944.                     <End>     moves  the  cursor to  the  last character  on the
  945.                               line.
  946.                     <^Right>  moves the cursor one word to the right.
  947.                     <^Left>   moves the cursor one word to the left.
  948.  
  949.                     <BkSp>    deletes the character  to the  left of the  cursor
  950.                               and shifts the following characters in the line to
  951.                               the left to fill in the empty space.
  952.  
  953.                     <^BkSp>   deletes the entire line.  This  is not the same as
  954.                               erasing  the cell.   The cell  will still  take up
  955.                               memory, but  it will contain  a blank string.   To
  956.                               erase  the cell  completely, use  the /Cell  Erase
  957.                               command.
  958.  
  959.                     <Del>     deletes  the character  underneath the  cursor and
  960.                               shifts the following characters in the line to the
  961.                               left to fill in the empty space.
  962.  
  963.                     <Ins>     toggles between insert  and overwrite modes.  When
  964.                               you are in  insert mode,  typing a character  will
  965.                               insert  the  new character  into  the line  at the
  966.                               point where the cursor is. The character under the
  967.                               cursor and  those to the  right of the  cursor are
  968.                               shifted  to the  right to  make  room for  the new
  969.                               character. When you are in overwrite  mode, typing
  970.                               a character  will replace the character  under the
  971.                               cursor with the new character.
  972.  
  973.                               When you are in insert mode, the cursor will be an
  974.                               underline.  In overwrite mode the cursor will be a
  975.                               solid block.
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                           11
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.      HOW TO ENTER AND USE FORMULAS
  1000.  
  1001.      One  of the  most useful  features  of any  spreadsheet is  the  ability to
  1002.      perform calculations using  the numbers  and text entered  in other  cells.
  1003.      This is done by  entering a formula into a  cell.  To enter a  formula, you
  1004.      simply move the  cell pointer to  the cell you want  the formula to  be in,
  1005.      type the formula, then  press <Enter>.  When a cell  contains a formula, it
  1006.      will display  the value  that  the formula  evaluates to,  rather than  the
  1007.      formula itself.
  1008.  
  1009.      A ProQube Lite formula must begin with an equal sign '=' and may be made up
  1010.      of numbers (or  text in some cases),  references to values in  other cells,
  1011.      built-in functions, and mathematical, logical, and comparison operators.
  1012.  
  1013.      Example   Let's say  you have  a number in  cell B5;1  and another  in cell
  1014.                C6;1, and you would  like to add these two numbers  and place the
  1015.                result in cell A4;1.  Simply  move the cell pointer to A4;1,  and
  1016.                type in the following formula:  =B5;1+C6;1 (followed by <Enter>).
  1017.                Cell  A4;1  now contains  the formula  you  entered, but  it will
  1018.                display the  result of  the formula.    If you  later change  the
  1019.                number  in either  B5;1 or  C6;1,  the formula  in  A4;1 will  be
  1020.                recalculated and the new value will be displayed.
  1021.  
  1022.      You  can use  the following  operators in  a formula  (a and  b can  be any
  1023.      number, cell reference, function, or formula):
  1024.  
  1025.      Mathematical        a+b  Addition
  1026.                          a-b  Subtraction
  1027.                          a*b  Multiplication
  1028.                          a/b  Division
  1029.                          a^b  Exponentiation
  1030.  
  1031.      Logical             a&b  And (is true only if a is true AND b is true)
  1032.                          a|b  Or (is true is a is true OR b is true)
  1033.                          ~b   Not (is false  if b is true,  and is true if  b is
  1034.                          false)
  1035.  
  1036.      Comparison          a=b  is true if a is equal to b
  1037.                          a<>b is true if a is NOT equal to b
  1038.                          a<b  is true if a is less than b
  1039.                          a>b  is true if a is greater than b
  1040.                          a<=b is true if a is less than or equal to b
  1041.                          a>=b is true is a is greater than or equal to b
  1042.  
  1043.      You can also use the comparison operators to compare text strings with each
  1044.      other.  Two strings  are considered equal if they are  the same length, and
  1045.      contain the same characters in the same order.  String comparisons are case
  1046.      insensitive,  which  means  that  two  letters  are   considered  the  same
  1047.      regardless of whether one is uppercase and  one is lowercase.  For example,
  1048.      the string Test is considered equal to the string test.
  1049.  
  1050.      In addition, the + operator can also be used to concatenate 2 strings.  For
  1051.  
  1052.                                           12
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.      example, the formula:
  1066.  
  1067.      ="This is"+" a test"
  1068.  
  1069.      returns the string This is a test.
  1070.  
  1071.      If you enter  a formula which uses  more than one operator,  the operations
  1072.      are always performed in a specific order (called precedence).  The order of
  1073.      precedence is:
  1074.  
  1075.      1. Exponentiation                  ^ 
  1076.      2. Negation                        -
  1077.      3. Multiplication and Division     *   /
  1078.      4. Addition and Subtraction        +   -
  1079.      5. Comparison                      =   <   >   <=   >=   <>
  1080.      6. Not                             ~
  1081.      7. And/Or                          &   |
  1082.  
  1083.      where exponentiation is performed before negation and so on.
  1084.  
  1085.      If you want to change the order in which operations are performed, then you
  1086.      must  use parentheses  in your  formulas.   Operations which  you place  in
  1087.      parentheses will be  performed before those  outside the parentheses.   For
  1088.      example, the formula
  1089.  
  1090.      =2+3*4
  1091.  
  1092.      evaluates as 14 (not 20) because the  multiply has a higher precedence than
  1093.      the  addition.  If  you want the  addition to be  performed first, then use
  1094.      parentheses to make the equation look like
  1095.  
  1096.      =(2+3)*4
  1097.  
  1098.      When you are  entering cell references in  a formula (like B3;4),  you only
  1099.      need to add the  page number (and the  semicolon) if the reference is  to a
  1100.      cell on  a different page.  If you leave  the page number off, ProQube Lite
  1101.      will automatically  add the current page  number to the  reference when the
  1102.      formula is entered into the cell.
  1103.  
  1104.      In addition to typing cell references in  formulas, you can also enter cell
  1105.      references by  pointing to  them with the  cell pointer.   At any  point in
  1106.      entering a formula where a cell reference is allowed, you can  simply press
  1107.      any of the cell pointer movement keys to begin pointing to a  cell or block
  1108.      of cells.  The address of the cell which the cell pointer is on will appear
  1109.      in the formula.  As you move  the cell pointer around, the reference in the
  1110.      formula will be adjusted to reflect the new position of the cell pointer.
  1111.  
  1112.      When the cell pointer is  highlighting the cell reference you  want, either
  1113.      press the <Enter> key  or the character you want to  immediately follow the
  1114.      cell reference.    If you  press the  <Enter> key,  the  reference will  be
  1115.      entered  and you may continue  to enter the formula.   If you press another
  1116.      key, the reference and the key you  pressed will be entered on the  formula
  1117.  
  1118.                                           13
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.      line, and you may continue entering the formula. 
  1132.  
  1133.      If you change  your mind about pointing  to a cell reference,  simply press
  1134.      the <Esc> key and  you will be returned  to formula entry without any  cell
  1135.      reference being entered.
  1136.  
  1137.      If you  have named  any cells with  the /Block Name  command, you  may also
  1138.      select  a cell or block reference from a  list of these references.  Simply
  1139.      press the <F3> key when you want to  select a named block, and a menu  will
  1140.      pop up which  lists all the  currently defined block names.   You can  then
  1141.      select the range name you want, and it will be placed into your formula for
  1142.      you.  The <F3> key will only pop up the block name list when it is legal to
  1143.      enter a cell or block reference.
  1144.  
  1145.      If you  enter a formula which ProQube Lite  can't evaluate, the formula you
  1146.      entered will be displayed on the command line and the editing facility will
  1147.      be invoked.  The  cursor will be placed near the part  of the formula which
  1148.      ProQube  Lite didn't like,  and you may  fix the formula  using the editing
  1149.      commands.
  1150.  
  1151.      If you enter  (or edit) a formula  and the word  CIRC appears in the  upper
  1152.      right corner of the screen, this means  a circular reference exists in your
  1153.      worksheet.  A  circular reference means  that a  formula in your  worksheet
  1154.      depends on the  value of  the cell it  is in.   For example,  if cell  A1;1
  1155.      contains the formula  =2*A1;1, then the formula must  use the current value
  1156.      of cell A1;1  to calculate  the next value  of cell  A1;1.  If  you have  a
  1157.      circular  reference, the status window (<^F8>) will  tell you which cell it
  1158.      is.
  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.                                           14
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.      RELATIVE AND ABSOLUTE CELL REFERENCES
  1198.  
  1199.      When a formula  references another cell, there are  two different ways that
  1200.      the cell can be referenced; absolute and relative.  The purpose of relative
  1201.      and absolute references is to let ProQube Lite know  what to do when moving
  1202.      formulas from cell to cell.
  1203.  
  1204.      It  is  easy  to  distinguish  between  an  absolute  and  a relative  cell
  1205.      reference.   An absolute  cell reference uses  the $ character  in front of
  1206.      each of its coordinates, like $A$1;$1,  while a relative reference uses  no
  1207.      special characters, like A1;1.
  1208.  
  1209.      Absolute  An absolute cell reference in a formula points to  the exact same
  1210.                cell, regardless of where the formula is moved or copied to.
  1211.  
  1212.      Relative  A  relative cell reference in a formula  points to the cell which
  1213.                is a  certain number of  rows, columns, and  pages away.   If the
  1214.                formula is  moved,  the  new  relative  cell  reference  will  be
  1215.                adjusted to point  to the cell  the same number of  rows, columns
  1216.                and pages away from the new formula location.
  1217.  
  1218.      Example   The cell C3;1 contains the formula =$A$1;$1+A1;1.  The first cell
  1219.                reference $A$1;$1 is  an absolute reference.   The value in  cell
  1220.                A1;1 will always be used as the value of this reference,  even if
  1221.                the formula is copied.
  1222.  
  1223.                The second reference  A1;1 is a  relative reference.  Since  cell
  1224.                A1;1 is 2 columns  left of and 2 rows above  cell C3;1, the value
  1225.                of this reference  is taken from the  cell which is 2  columns to
  1226.                the left of and  2 rows above the formula, even if the formula is
  1227.                copied.
  1228.  
  1229.                If the  formula in  cell C3;1  is now  copied to  cell D5;1,  the
  1230.                contents of D5;1 will be =$A$1;$1+B3;1.  Notice that the absolute
  1231.                reference did  NOT change; it  still points "ABSOLUTELY"  to cell
  1232.                A1;1, but the relative  reference was adjusted so that  it points
  1233.                to cell  B3;1 (cell B3;1  is the cell  which is 2  columns to the
  1234.                left of and 2 rows above the new cell D5;1).
  1235.  
  1236.      Relative references  to  other pages  are  also  adjusted when  a  page  is
  1237.      inserted or deleted, or data is copied from one page to another.
  1238.      It doesn't  matter whether a cell reference is  absolute or relative when a
  1239.      formula  is evaluated; the  result will be  the same  in either case.   For
  1240.      example, the formula =2*A1;1 will have the same value as =2*$A$1;$1.    You
  1241.      can have both absolute and relative references in the same equation  if you
  1242.      want.
  1243.  
  1244.      It  is possible,  and even useful  sometimes, to mix  absolute and relative
  1245.      references in a single  cell reference.  For  example, the reference  A$2;3
  1246.      points relatively to column A and page 3, but absolutely to row 2.
  1247.  
  1248.  
  1249.  
  1250.                                           15
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.      DEFINING A BLOCK OF CELLS
  1264.  
  1265.      Many of  ProQube Lite's  commands can operate  on more  than one cell  at a
  1266.      time.   These commands will usually  ask you to define  a block of cells to
  1267.      perform the command  on.  The  block of cells  you define can  be a  single
  1268.      cell,  a two dimensional  range of cells,  or a three  dimensional block of
  1269.      cells.  A reference to a block is made  up of the cells at opposite corners
  1270.      of the block  separated by two periods.   For example, the  block reference
  1271.      A1;1..Z20;5 contains  all the  cells in  the  block bordered  by columns  A
  1272.      through Z, rows 1 through 20, and pages 1 through 5.
  1273.  
  1274.      When a command asks  you to define a block of cells,  there are 5 different
  1275.      options.
  1276.  
  1277.           - You can simply type in the block reference.
  1278.  
  1279.           - You can type  in the name of  a cell surrounded by square  brackets.
  1280.           ProQube Lite will read the name of  the range out of that cell.   This
  1281.           option  allows your application programs  to indirectly supply a range
  1282.           reference to a command.
  1283.  
  1284.           Example   If cell B5;1  contains the string 'G1;1..J10;3,  then typing
  1285.                     [B5;1]  when  you are  asked to  define  a block  will cause
  1286.                     ProQube Lite to use the block G1;1..J10;3 for the command.
  1287.  
  1288.           - If  you have named  a block using  the /Block Name command,  you may
  1289.           simply type in the name.
  1290.  
  1291.           Example   If you  assigned the  name COSTS  to the  block G1;1..J10;3,
  1292.                     then typing COSTS when you are asked to define a  block will
  1293.                     cause ProQube  Lite to  use  the block  G1;1..J10;3 for  the
  1294.                     command.
  1295.  
  1296.           -  Pressing  the <F3>  Block  key will  bring  up a  menu  of  all the
  1297.           currently defined block names.  You may pick a block from this list by
  1298.           highlighting the name and pressing the <Enter> key.  If there are more
  1299.           than 16 block names defined, you may  press the <PgUp> and <PgDn> keys
  1300.           to view more block names.
  1301.  
  1302.           - You can highlight the  block on screen using the cursor keys.   When
  1303.           you are defining a  block, all the visible cells in  the block will be
  1304.           highlighted on the screen.  On the command line you will see  either a
  1305.           single cell reference or a block  reference.  A single cell  reference
  1306.           means that  an  anchor cell  has not  been selected.    In this  case,
  1307.           pressing a  movement key simply moves the cell  pointer to a new cell,
  1308.           but does not highlight (or define) any other cells.  If an anchor cell
  1309.           has  been selected  then all  cells  between the  anchor cell  and the
  1310.           current cell are defined (and highlighted if visible).
  1311.  
  1312.           You can use any of the movement keys (including <F5> GoTo) to move the
  1313.           cell  pointer when highlighting  a block of  cells.   In addition, the
  1314.           following keys are active when defining a block:
  1315.  
  1316.                                           16
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.           <Enter>   This key  causes all the  cells in the block  on the command
  1331.                     line  to  be defined.  If only  a  single cell  reference is
  1332.                     displayed when  you press <Enter>, then only  that cell will
  1333.                     be defined.
  1334.  
  1335.           .         This key sets the anchor  to the current cell. If an  anchor
  1336.                     was already set  before you pressed  ., then it is  released
  1337.                     before the new one is set.
  1338.  
  1339.           <Esc>     This key releases  the anchor if  it is set. Pressing  <Esc>
  1340.                     when the anchor is not set  cancels the block selection, and
  1341.                     returns you to whatever you were doing before you were asked
  1342.                     to define a block.
  1343.  
  1344.           <F4>      This key cycles the block cell references among the absolute
  1345.                     and  relative  types. If  no anchor  is  set then  the first
  1346.                     coordinate is adjusted. If the anchor has been set then <F4>
  1347.                     will adjust the non-anchor reference.
  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.                                           17
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.      BUILT-IN @FUNCTIONS
  1396.  
  1397.      ProQube Lite provides over 80 built-in functions which you can use  in your
  1398.      formulas.   These built-in functions each  begin with the  character @, and
  1399.      are often called at functions.   A detailed list  of these functions is  in
  1400.      the reference section of this manual.
  1401.  
  1402.      Most of  these functions require one or  more arguments.  An  argument is a
  1403.      value which the function uses as  an input to provide an output value.   An
  1404.      argument may be a number, a text  string, a reference to a value in another
  1405.      cell, or  another formula.   In the case  of the statistical  functions, an
  1406.      argument may  also be a range  or block of  cells.  If a  function requires
  1407.      arguments, they are enclosed in parentheses and immediately follow the name
  1408.      of the  @function.  If  more than  one argument is  required, they  must be
  1409.      separated from each other with a comma.
  1410.  
  1411.      A built-in function can  return either a numerical or text value and may be
  1412.      treated exactly like a number or text would be.
  1413.  
  1414.      Example   A cell contains the formula =2*@ABS(-3).
  1415.  
  1416.                @ABS  is  the  name of  a  built-in  function  which returns  the
  1417.                absolute (positive) value of its argument.
  1418.  
  1419.                -3 is the argument to the function.
  1420.  
  1421.                The function returns a value of 3, and is used in the rest of the
  1422.                formula just like the number 3.   The value of the entire formula
  1423.                is 6 (2 times the value of the @function).
  1424.  
  1425.      If the  value  that a  function returns  is an  error, it  will return  the
  1426.      special value ERROR.   A formula which contains a function with  a value of
  1427.      ERROR will also return ERROR as the value for the cell it is in.
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                                           18
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.      USING THE COMMAND MENUS
  1462.  
  1463.      When you  want to  execute a command  in ProQube  Lite, it will  usually be
  1464.      through ProQube Lite's menu  system.  A menu  is simply a list of  commands
  1465.      which you  can pick  from.   Through the  menus you  can manipulate  cells,
  1466.      blocks, or the  entire WorkQube, graph or print data,  manipulate files, or
  1467.      even temporarily exit to the operating system.
  1468.  
  1469.      To bring up ProQube Lite's menu system, you simply press the / key.  If you
  1470.      are using a mouse,  then you may also press the left  mouse button to bring
  1471.      up  the menu.   At  the top of  the ProQube  Lite screen  you will  see the
  1472.      following menu.
  1473.  
  1474.  
  1475.      Cell  Block  Slice  WorkQube  File  Print  Data  Macro  OpSys  Quit
  1476.  
  1477.  
  1478.      The menu system uses a sliding bar  to show your choices.  There are  three
  1479.      ways you can choose an option:
  1480.  
  1481.           -  Press  the   <Left>  or  <Right>  key  until  the  sliding  bar  is
  1482.           highlighting the  option you  want.   Then press  <Enter> to  make the
  1483.           choice.   The <Home> key  can be pressed  to highlight the  first menu
  1484.           choice,  and  pressing the  <End>  key  will highlight  the  last menu
  1485.           choice.
  1486.  
  1487.           - If you are using a mouse, you may move the sliding bar by moving the
  1488.           mouse  back  and forth.    Move the  mouse  until the  sliding  bar is
  1489.           highlighting the option you want.  Then press the left mouse button to
  1490.           make the choice.
  1491.  
  1492.           - As  a shortcut you  can simply press  the highlighted letter  of the
  1493.           desired item (usually the first character) to select that option.
  1494.  
  1495.      A help  line  appears  above  the  main menu.    This  line  describes  the
  1496.      highlighted menu option.  When you move the sliding bar to a new item, this
  1497.      help line will change to display a line of help about the newly highlighted
  1498.      item.
  1499.  
  1500.      When you choose an option  from the menu, a new  submenu will pop up  which
  1501.      works the  same as  the main  menu.   As each  new submenu  is chosen,  the
  1502.      previous  menus  remain on-screen,  providing  you  with a  "tree"  of your
  1503.      commands.   To go back one level, simply press  the <Esc> key (or the right
  1504.      mouse button).  To clear all  the menus from the screen at once,  press the
  1505.      <BkSp> key (or both mouse buttons simultaneously.
  1506.  
  1507.      A  detailed list of menu commands can be  found in the reference section of
  1508.      this manual.
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.                                           19
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.      USING THE FUNCTION KEYS
  1528.  
  1529.      Several of  ProQube Lite's commands are assigned to  one of the 10 function
  1530.      keys instead of or  in addition to the  command menus.  These commands  are
  1531.      ones  which you  might normally  want to  select with  a  single keystroke.
  1532.      Several other  commands are also assigned to one  of the function keys with
  1533.      the <Ctrl> key pressed.  To execute one of these commands, simply hold down
  1534.      the <Ctrl>  key and then  press the appropriate  function key.   A detailed
  1535.      description of  each of  the function keys  may be  found in  the reference
  1536.      section of this manual.
  1537.  
  1538.      Function Keys
  1539.  
  1540.      FUNCTION KEY        WHAT IT DOES
  1541.      <F1> Help           Calls up context sensitive help.
  1542.      <F2> Edit           Allows you to edit the current cell.
  1543.      <F3> Block          Calls up a menu of defined block names.
  1544.      <F4> Absolute       Toggles absolute & relative references.
  1545.      <F5> Goto           Allows you to go to another cell.
  1546.      <F6> Search         Search and replaces the contents of cells.
  1547.      <F7> Load           Retrieves a worksheet from disk.
  1548.      <F8> Save           Saves the current worksheet to disk.
  1549.      <F9> Recalc         Recalculates the entire worksheet.
  1550.  
  1551.  
  1552.      FUNCTION KEY
  1553.      W/ <Ctrl> PRESSED   WHAT IT DOES
  1554.      <^F1> Info          Allows you to enter a worksheet description.
  1555.      <^F2> Debug         Application program debug menu.
  1556.      <^F3> Break         Breaks out of a running application.
  1557.      <^F4> Mark          Marks the current cell for later return with <^F5>.
  1558.      <^F5> ToMark        Returns to the last cell marked with <^F4>.
  1559.      <^F6> Files         Calls up the File Manager.
  1560.      <^F7> EGA43         Toggles 43/50 line mode on EGA/VGA monitors.
  1561.      <^F8> Status        Displays a status window.
  1562.      <^F9> Enter         Toggles data entry mode.
  1563.      <^F10> Record       Turns the macro recorder on and off.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.                                           20
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.      SAVING AND RETRIEVING DATA
  1594.  
  1595.      As you  are creating  and using spreadsheets,  your data  is stored  in the
  1596.      memory of your PC.  You should store your spreadsheets on disk periodically
  1597.      throughout the day or session  and definitely at the end  of each day.   In
  1598.      the event  of a  power outage  or if you  should forgetfully  turn off  the
  1599.      machine before a save  has been done, the data entered  since the last save
  1600.      to disk is lost.
  1601.  
  1602.      Saving         You  can save  your worksheet  to a  file on disk  using the
  1603.                     /File Save command.  You will be asked for the name you want
  1604.                     to  give  your  file,  and  ProQube  Lite  will  store  your
  1605.                     spreadsheet on disk in the ProQube Lite format.  If you just
  1606.                     want to save  a small  part of your  spreadsheet, the  /File
  1607.                     Xtract command will provide that capability.
  1608.  
  1609.      Retrieving     When you want  to read a file off the disk back into memory,
  1610.                     you should  use the  /File Retrieve  command.   You will  be
  1611.                     asked for the name of the file to retrieve, and ProQube Lite
  1612.                     will read the contents of that file into memory.
  1613.  
  1614.      Importing      The ability to import  files is an important function.   The
  1615.                     /File Import command lets you bring  in data from just about
  1616.                     any source and use it in your spreadsheet.  ProQube Lite can
  1617.                     import  data  from   Lotus  1-2-3   (WKS  and  WK1),   dBase
  1618.                     II/III/III+ , DIF and ASCII files.
  1619.  
  1620.      Exporting      If you wish to use your spreadsheet data with other software
  1621.                     programs, the  /File Export  command should accomplish  your
  1622.                     desired result.  ProQube Lite can export its data in several
  1623.                     different formats, and most software packages are capable of
  1624.                     reading at least one of them.  ProQube Lite can export Lotus
  1625.                     1-2-3 (in  two forms, WKS or WK1), dBase  II or dBase III or
  1626.                     III+, DIF, or ASCII files.
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.                                           21
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.      USING THE FILE MANAGER
  1660.  
  1661.      ProQube Lite  provides many features designed to simplify  its use.  One of
  1662.      these features is the  Visual File Manager.  The File Manager allows you to
  1663.      manipulate files, directories, and drives by simply pointing and selecting.
  1664.      It may be accessed by two methods.
  1665.  
  1666.      1) Any time you are asked for a file name, pressing the <Enter> key without
  1667.      a file  name will bring the File  Manager forward to assist you.   Only the
  1668.      files that satisfy the request you are making  will be shown.  For example,
  1669.      if you  have selected /File  Retrieve, then responded  to the prompt  for a
  1670.      file  name with the  <Enter> key, spreadsheet  files will be  the only ones
  1671.      listed.  You  simply highlight the  desired file with  the <Up> and  <Down>
  1672.      keys and press <Enter>.  ProQube Lite will then retrieve the selected file.
  1673.  
  1674.      2) To access  the complete listing  of files, select  /File Files from  the
  1675.      command menu.  You will  be asked to enter a mask.  A  mask is simply a way
  1676.      of telling ProQube Lite which files you want to be  displayed.  You may use
  1677.      the asterisk * in the mask.  The asterisk will match any set of characters.
  1678.      For example, if you  enter the mask *.BAK, then the  file manager will list
  1679.      every file which ends  with .BAK.  If you enter the mask Q*.*, then all the
  1680.      files beginning with the letter Q will be displayed.  Pressing <Enter> will
  1681.      use the  Mask  *.*,  which  will  display all  the  files  in  the  current
  1682.      directory.
  1683.  
  1684.      The  File  Manager  also  simplifies  the  tasks  of  changing  drives  and
  1685.      directories.   To change to another directory,  simply press the <Left> key
  1686.      to highlight the  word DIRECTORIES at the  top of the screen,  then use the
  1687.      <Up>  and <Down> keys  to highlight the  name of the  directory you want to
  1688.      change to.  Once the name is highlighted, press the <Enter> key and ProQube
  1689.      Lite will change to that directory and list the files in that directory.
  1690.  
  1691.      Changing drives  is just as  easy.  Simply press  the <Left> key  until the
  1692.      word DRV is highlighted  at the top of the screen, then press the letter of
  1693.      the  drive you want to  change to.   For example, if you  want to change to
  1694.      drive A:, then just press A.
  1695.  
  1696.      When you  bring  up the  File Manager  with the  /File  Files command,  the
  1697.      function keys perform the following functions.
  1698.           <F1>      Causes a help screen on the File Manager to appear.
  1699.           <F2>      Loads the highlighted .PQS file into memory.
  1700.           <F3>      Combines the highlighted file with the worksheet in memory.
  1701.           <F4>      Imports the highlighted file.
  1702.           <F5>      Lets you to edit the contents of the highlighted text file.
  1703.           <F6>      Causes the highlighted text file to be printed.
  1704.           <F7>      Causes the highlighted .EXE, .COM, or .BAT file to run.
  1705.           <F8>      Allows you to rename the highlighted file.
  1706.           <F9>      Copies the highlighted file to another location.
  1707.           <F10>     Deletes the highlighted file.
  1708.           <^F1>     Displays the description of the highlighted .PQS file.
  1709.           <^F2>     Rescans the current drive to update the directory tree.
  1710.  
  1711.  
  1712.                                           22
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.      CHANGING YOUR SPREADSHEET'S APPEARANCE
  1726.  
  1727.      ProQube Lite lets you change the way numbers are displayed on the screen by
  1728.      assigning a  "format" to  cells.   You might  set a  cell  to the  Currency
  1729.      format, for example, so that the number in that cell will be displayed with
  1730.      a  leading dollar sign.  Changing the format  of a cell does not change the
  1731.      value stored in the cell,  only the way it is displayed on  the screen (and
  1732.      printouts).
  1733.  
  1734.      Normally, when you enter data into a cell, the cell will take on the global
  1735.      (WorkQube) format.  You  can see what this format  is by pressing <^F8>  to
  1736.      bring  up the status window.   The WorkQube format  may be changed by using
  1737.      the /WorkQube Format command.  It is also possible to  set a default format
  1738.      for individual pages with the /Slice Page Format command.
  1739.  
  1740.      The format of  an individual  cell may  be changed using  the /Cell  Format
  1741.      command, and the format of a block of cells may be changed using the /Block
  1742.      Format command.  You should use care when formatting blocks of blank cells,
  1743.      because  formatted cells  use up memory,  even if  the cells'  contents are
  1744.      blank.
  1745.  
  1746.      A cell may be set to any of the following formats:
  1747.  
  1748.      General        The value  is displayed  with only  the necessary  number of
  1749.                     decimal places.  If the value is an integer, then no decimal
  1750.                     point is displayed.   If the column which the value is in is
  1751.                     not wide enough to display all the decimal places, then only
  1752.                     as many  decimal places as will  fit are displayed.   If the
  1753.                     column is not wide enough to display the integer part of the
  1754.                     value,  then  the  value  will  be displayed  in  scientific
  1755.                     notation.
  1756.  
  1757.      Currency       The value is  displayed with a  preceding dollar sign and  a
  1758.                     selected  number  of  decimal  places.    If  the  value  is
  1759.                     negative, the value  is enclosed in parentheses  rather than
  1760.                     displayed with a negative sign.  There are two sub-options:
  1761.  
  1762.                     Comma     A comma will be inserted every three whole digits.
  1763.                               (Example: $103,297.25)
  1764.  
  1765.                     NoComma   No comma is inserted in the number.
  1766.  
  1767.      Fixed          The  value  is  displayed with  a  fixed  number of  decimal
  1768.                     places.   Values which  are very  large or  very small  will
  1769.                     appear  in  scientific  notation.     Four  sub-options  are
  1770.                     available:
  1771.  
  1772.                     Comma     A comma will be inserted  every three whole digits
  1773.                               (Example:  12,345.67).     Negative  numbers   are
  1774.                               preceded by a negative sign.
  1775.  
  1776.  
  1777.  
  1778.                                           23
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.                     NoComma   No  comma  is inserted  in  the number.   Negative
  1792.                               numbers are preceded by a negative sign.
  1793.  
  1794.                     A ()      No  comma  is inserted  in  the number.   Negative
  1795.                               numbers are enclosed in parentheses.
  1796.  
  1797.                     B (,)     A comma will be inserted every three whole digits.
  1798.                               Negative numbers are enclosed in parentheses.
  1799.  
  1800.      Percent        The value is displayed  as a percentage with a  fixed number
  1801.                     of decimal places.   The value is multiplied by  100, and is
  1802.                     displayed with a trailing percent  sign %.  Two  sub-options
  1803.                     are available:
  1804.  
  1805.                     Comma     A comma will be inserted every three whole digits.
  1806.                               (Example: 1,024%)
  1807.  
  1808.                     NoComma   No comma is inserted in the number.
  1809.  
  1810.      Scientific     The value  is displayed in  exponential form, and  shows the
  1811.                     power  of 10  that the  number must  be multiplied by.   For
  1812.                     example, 1.78E+07 means 1.78 times 10 to the 7th power.
  1813.  
  1814.      Time           A time number (usually  provided by one of the  ProQube Lite
  1815.                     time functions) is displayed in one of two ways.
  1816.  
  1817.                     AM/PM     The time appears in the a.m.  or p.m. form.  Thus,
  1818.                               5:00 in the evening appears as 5:00 p.m.
  1819.  
  1820.                     Military  The time appears as it  would on a 24-hour  clock.
  1821.                               Thus, 5:00 in the evening appears as 17:00.
  1822.  
  1823.      Date           A date number (usually  provided by one of the  ProQube Lite
  1824.                     date functions) is displayed in one of five ways.
  1825.  
  1826.                     dd-mmm-yy June 10, 1960 appears as 10-Jun-60.
  1827.                     dd-mmm    June 10, 1960 appears as 10-Jun.
  1828.                     mmm-yy    June 10, 1960 appears as Jun-60.
  1829.                     mm/dd/yy  June 10, 1960 appears as 06/10/60.
  1830.                     month dd, yyyy June 10, 1960 appears as June 10, 1960.
  1831.  
  1832.                     If you enter a date (in one of the first four formats above)
  1833.                     into a date formatted cell, ProQube Lite will enter the date
  1834.                     number into the cell rather than  the text.  For example, if
  1835.                     you  type 4/15/89 into  a date formatted  cell, ProQube Lite
  1836.                     will enter the  value 32703  (the date value  for April  15,
  1837.                     1989) into  the cell.   This  conserves memory,  because the
  1838.                     number takes less memory than the text string would.
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.                                           24
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.      Hidden         The value will not be displayed on the screen.  If you later
  1858.                     want to unhide  a hidden cell, simply  set it to any  of the
  1859.                     other formats.
  1860.  
  1861.      Label          All formulas (rather than their values) will be displayed on
  1862.                     screen.
  1863.  
  1864.      Reset          Resets the cell to the default format.
  1865.  
  1866.  
  1867.  
  1868.      EXAMPLE FORMATS
  1869.  
  1870.      Format         12.345              -12.345             =@PI*10000
  1871.      General        12.345              -12.345             31415.92653
  1872.      Currency       $12.35              ($12.35)            $31415.93
  1873.      Currency (,)   $12.35              ($12.35)            $31,415.93
  1874.      Fixed          12.35               -12.35              31415.93
  1875.      Fixed (,)      12.35               -12.35              31,415.93
  1876.      Fixed A ()     12.35               (12.35)             31415.93
  1877.      Fixed B (,)    12.35               (12.35)             31,415.93
  1878.      Percent        1234.50%            -1234.50%           3141592.65%
  1879.      Percent (,)    1,234.50%           -1,234.50%          3,141,592.65%
  1880.      Scientific     1.2345E+01          -1.2345E+01         3.1415E+04
  1881.      Time
  1882.        AM/PM        08:16:48AM          08:16:48AM          10:14:13PM
  1883.        Military     08:16:48            08:16:48            22:14:13
  1884.      Date
  1885.        dd-mmm-yy    12-Jan-00           12-Jan-00           03-Jan-86
  1886.        dd-mmm       12-Jan              12-Jan              03-Jan
  1887.        mmm-yy       Jan-00              Jan-00              Jan-86
  1888.        mm/dd/yy     01/12/00            01/12/00            01/03/86
  1889.        m d, yyyy    January 12, 1900    January 12, 1900    January 3, 1986
  1890.      Hidden
  1891.      Label          12.345              -12.345             =@PI*10000
  1892.  
  1893.  
  1894.      If  the formatted  value contains  more characters  than the  width  of the
  1895.      column  it is in, the cell  display will be filled  with a row of asterisks
  1896.      like *******.  You can fix this condition in one of two ways.
  1897.  
  1898.           - Select a display format for the cell which requires fewer characters
  1899.           to display (or reduce the number of  digits after the decimal point to
  1900.           be displayed).
  1901.  
  1902.           - Increase the width  of the column so the formatted  cell will fit in
  1903.           it.  You can do this with the /Cell Width command.
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                           25
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.      USING THE MULTIPLE PAGES
  1924.  
  1925.      As a true  three dimensional spreadsheet  ProQube Lite uses multiple  pages
  1926.      for  storing  data.    Each page  appears  to  be  a  flat two  dimensional
  1927.      spreadsheet.  Pages are "stacked" together into a WorkQube.  You enter data
  1928.      just as it  is entered in other  spreadsheets, in rows and  columns, within
  1929.      each page.   Moving  from page  to page  is simple  - <PgUp>  moves to  the
  1930.      following pages and <PgDn> moves to the preceding pages.
  1931.  
  1932.      The multiple pages  of the WorkQube  present endless applications that  are
  1933.      impossible or very difficult with conventional spreadsheets.  Each page can
  1934.      contain the information for one year, one  department, one district, or any
  1935.      other grouping of  data that is  meaningful to you.   Each page can  have a
  1936.      completely different format  from the other pages or the same format as the
  1937.      other pages.   And  since  every cell  reference  contains a  page  number,
  1938.      formulas can access any  cell on any page, providing built in consolidation
  1939.      capabilities.
  1940.  
  1941.      Let's  work  through one  example  to see  some  of the  possibilities that
  1942.      ProQube Lite's WorkQube  present.  For a  small business, you might  have a
  1943.      spreadsheet for expenses which consists of the four pages shown on the next
  1944.      page.  Each year's detail information is  contained on a separate page with
  1945.      page 2 containing 1987 data, page 3 for 1988, and page 4 for 1989.
  1946.  
  1947.      Consolidation of  data is  one of  ProQube Lite's  most powerful  features.
  1948.      Since every cell reference includes the page number, any formula can access
  1949.      any cell on  any page.   You can  even sum  up ranges of  cells which  span
  1950.      across multiple  pages.   In our  example, cell  D5 in  pages 2,  3, and  4
  1951.      contain the January  rent for the 3 years  1987, 1988, and 1989.   In order
  1952.      for cell D5 on  page 5 to consolidate the January rent for the 3 years, you
  1953.      simply enter the formula
  1954.  
  1955.      =@SUM(D5;2..D5;4)
  1956.  
  1957.      into cell D5;5.  This formula sums up cell D5 across pages 2 through 4.
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.                                           26
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.      Example   2      A           B       C       D       E       F     
  1990.                  1 1987 Expenses
  1991.                  2
  1992.                  3              Total  Jan 87  Feb 87  Mar 87
  1993.                  4 Advertising    300    120      35     145
  1994.                  5 Rent           910    300     300     310
  1995.                  6 Taxes          108     36      36      36
  1996.                  7 Telephone      913    504     300     109
  1997.                  8 Utilities      575    225     210     140
  1998.                  9 Total         2806   1185     881     740
  1999.  
  2000.  
  2001.                3      A           B       C       D       E       F     
  2002.                  1 1988 Expenses
  2003.                  2
  2004.                  3              Total  Jan 88  Feb 88   Mar 88
  2005.                  4 Advertising    346    140      56      150
  2006.                  5 Rent          1140    380     380      380
  2007.                  6 Taxes          174     58      58       58
  2008.                  7 Telephone     1039    709     301       29
  2009.                  8 Utilities      707    257     290      160
  2010.                  9 Total         3406   1544    1085      777
  2011.  
  2012.  
  2013.                4      A           B       C       D       E       F     
  2014.                  1 1989 Expenses
  2015.                  2
  2016.                  3              Total  Jan 89  Feb 89  Mar 89
  2017.                  4 Advertising    398    170      68     160
  2018.                  5 Rent          1260    420     420     420
  2019.                  6 Taxes          267     89      89      89
  2020.                  7 Telephone     1067    608     309     150
  2021.                  8 Utilities      847    360     307     180
  2022.                  9 Total         3839   1647    1193     999
  2023.  
  2024.  
  2025.                5      A           B       C       D       E       F     
  2026.                  1 Total Expenses
  2027.                  2                       Jan     Feb     Mar
  2028.                  3              Total   Total   Total   Total
  2029.                  4 Advertising   1044    430     159     455
  2030.                  5 Rent          3310   1100    1100    1110
  2031.                  6 Taxes          549    183     183     183
  2032.                  7 Telephone     3019   1821     910     288
  2033.                  8 Utilities     2129    842     807     480
  2034.                  9 Total        10051   4376    3159    2516
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.                                           27
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.      CHANGING THE VIEW
  2056.  
  2057.      Probably the most  powerful feature of ProQube  Lite is its ability  to let
  2058.      you view your 3D  worksheets from different perspectives.   This capability
  2059.      allows  you to view  data from  different pages on  the screen at  the same
  2060.      time.
  2061.  
  2062.      ProQube  Lite's 3D workspace  is laid out  as a cube  of data  known as the
  2063.      WorkQube.  Changing  the view determines  which direction your pages  slice
  2064.      through this WorkQube.   From the  FRONT view the  pages slice through  the
  2065.      WorkQube like this:
  2066.  
  2067.  
  2068.                                ---------------------
  2069.                               | PAGE 3              |
  2070.                            ---------------------    |
  2071.                           | PAGE 2              |   |
  2072.                        ---------------------    |   |
  2073.                       | PAGE 1              |   |   |
  2074.                       |                     |   |---
  2075.                       |                     |   |
  2076.                       |                     |---   
  2077.                       |                     |
  2078.                        ---------------------
  2079.  
  2080.      Every column in  the WorkQube lies directly  behind the same column  on the
  2081.      previous page.  For example, column A on page 3 lies directly behind column
  2082.      A on page 2, which lies behind column A on page 1.
  2083.  
  2084.      If we wanted to compare the  data from each of the column A's  together, we
  2085.      could  change to the  RIGHT view  so that  the pages  slice through  the 3D
  2086.      worksheet like this:
  2087.  
  2088.  
  2089.                               /|    /|    /|
  2090.                             /  |  /  |  /  |
  2091.                           /    |/    |/    |
  2092.                         /     /     /      |
  2093.                        |  1  |  2  |  3    |
  2094.                        |     |     |      /
  2095.                        |    /|    /|    /
  2096.                        |  /  |  /  |  /
  2097.                        |/    |/    |/
  2098.  
  2099.  
  2100.      Notice that the column  A's from the FRONT view have  been combined to make
  2101.      page 1 in the RIGHT view.  Similarly, the column B's in the FRONT view have
  2102.      combined into page 2 in the  RIGHT view, the column C's have combined  into
  2103.      page 3, and so on.
  2104.  
  2105.      And suppose you view  the WorkQube from the top.  Since each of the rows in
  2106.      the FRONT view are behind one another,  they combine into pages in the  TOP
  2107.  
  2108.                                           28
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.      view, like this:
  2122.  
  2123.  
  2124.                          -----------------
  2125.                        /                /
  2126.                      /  PAGE 1        /----
  2127.                    /----------------/    /
  2128.                       /  PAGE 2        /----
  2129.                     /----------------/    /
  2130.                        /  PAGE 3        /
  2131.                      /----------------/
  2132.  
  2133.  
  2134.      Changing your view  of the WorkQube is as simple as selecting the /WorkQube
  2135.      View command.  You may view the  WorkQube from the Front, Right, Top, Back,
  2136.      Left, or from the Under side.
  2137.  
  2138.      Although  the concept of  changing the  view of  your worksheet  may appear
  2139.      complex, it is  really quite simple,  and is best  learned by practice  and
  2140.      experience.   The disk  based tutor  provides an  entire lesson  on the  3D
  2141.      aspects  of  ProQube Lite,  and  is  recommended if  you  find the  concept
  2142.      confusing.
  2143.  
  2144.  
  2145.      Example   Front     Using the 3D  worksheet from the previous  section, you
  2146.                          can see that the Front view  of the WorkQube provides a
  2147.                          page of expenses  for each year,  as well as a  summary
  2148.                          page.
  2149.  
  2150.                          Column  A  of  each  page  contains the  categories  of
  2151.                          expenses, column C contains the total for the year, and
  2152.                          columns D through O containing the expenses incurred in
  2153.                          each month (January through December).
  2154.  
  2155.                Right     Now, suppose you wanted to compare your expenses  for a
  2156.                          single month for various years.   Rotating the WorkQube
  2157.                          to the  Right view allows us to compare by column.  The
  2158.                          A  columns in the Front view combine  to make up page 1
  2159.                          in the Right  view, the Front B columns make  up page 2
  2160.                          in the Right view, and  so on.  So page 4 of  the Right
  2161.                          view   contains  the  information  from  column  D  (or
  2162.                          January) of all the front  view pages.  Therefore, from
  2163.                          the Right view all  of January's expenses from  each of
  2164.                          the years is displayed side by side, like this:
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                                           29
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.                          [Right]
  2188.                          4      A           B        C        D         E
  2189.                            1 January Expenses
  2190.                            2                                           Jan
  2191.                            3              Jan 87  Jan 88    Jan 89    Total
  2192.                            4 Advertising    120     140       170      430
  2193.                            5 Rent           300     380       420     1100
  2194.                            6 Taxes           36      58        89      183
  2195.                            7 Telephone      504     709       608     1821
  2196.                            8 Utilities      225     257       360      842
  2197.                            9 Total         1185    1544      1647     4376
  2198.  
  2199.  
  2200.                          Since some expenses  are seasonal (such as  utilities),
  2201.                          trends show up  more accurately when the  same month is
  2202.                          compared from year  to year.   When comparing the  Rent
  2203.                          paid in January 1987 ($300) to the Rent paid in January
  2204.                          1989  ($420),  you find  that  in  two  years the  Rent
  2205.                          increased 40%.
  2206.  
  2207.                          And if you want to see  the months of February compared
  2208.                          with each other, you just press  the <PgUp> key to move
  2209.                          up to the next page.
  2210.  
  2211.                Top       Now suppose you  want to  see a complete  look at  each
  2212.                          individual  expense's entries  for  all  months in  all
  2213.                          years.   This is the view you will  get from the Top of
  2214.                          the WorkQube.   The rows in  the Front view combine  to
  2215.                          make up  the pages in the Top view.   Page 1 of the Top
  2216.                          view is made up of the row 1's in the Front view.
  2217.  
  2218.                          Page 4 of the  Top view contains the Rent  expenses, or
  2219.                          the contents of row 4 of all the pages.
  2220.  
  2221.  
  2222.                          [Top]
  2223.                          5      A         B       C       D       E       F     
  2224.                            1 Rent Expenses
  2225.                            2                                        Rent
  2226.                            3           Rent 87   Rent 88  Rent 89   Total
  2227.                            4
  2228.                            5 January      300       380      420    1100
  2229.                            6 February     300       380      420    1100
  2230.                            7 March        310       380      420    1110
  2231.  
  2232.  
  2233.                          And if you  want to see the  other individual expenses,
  2234.                          simply use the <PgUp> and <PgDn> keys to move from page
  2235.                          to page in the Top view.
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                           30
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.                Others    Since the three remaining views (Back, Left, and Under)
  2254.                          slice pages the same  way as the Front, Right,  and Top
  2255.                          views, they are used to transpose the  positions of the
  2256.                          rows and columns and present the same data as viewed in
  2257.                          the Front, Right, and Top views.      
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                           31
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.      PRINTING YOUR DATA
  2320.  
  2321.      ProQube Lite allows  you to print out the  data you have entered  and gives
  2322.      you control over what is printed and how the printout looks.  You can print
  2323.      your  entire worksheet  or any  portion of  it, including  border  rows and
  2324.      columns.  The /Print Options command  gives you control over the appearance
  2325.      of your printed product.   You can set margins and  page numbering, as well
  2326.      as headers and footers.  You may print the data from the spreadsheet or the
  2327.      formulas behind  it.  You can direct the output to a printer (LPT1 or LPT2)
  2328.      or to a file.
  2329.  
  2330.      Once you have selected the data, the borders, and the options,  printing is
  2331.      accomplished by a simple command - Go.
  2332.  
  2333.  
  2334.      Example   1      A         B       C       D       E       F     
  2335.                  1                       1987 Sales
  2336.                  2
  2337.                  3             Jan     Feb     Mar     Apr     May
  2338.                  4  Joe       1234    2011    1893    1500    1438
  2339.                  5  Bill      2102    1453    2415    1627    1888
  2340.                  6  David     1845    1739    2194    1999    2003
  2341.                  7  Mike      2340    2112    1693    1429    2236
  2342.                  8
  2343.                  9
  2344.  
  2345.                You want to print the spreadsheet above.
  2346.  
  2347.                1.  Select /Print from the main menu to begin.
  2348.  
  2349.                2.    Next,  you must  tell  ProQube  Lite  what portion  of  the
  2350.                spreadsheet you wish to  print by selecting Block from  the Print
  2351.                menu.  You will  be asked to define the block  you wish to print.
  2352.                Either type in the block, like A1;1..F7;1, or highlight the block
  2353.                using the cursor keys.
  2354.  
  2355.                3.  Set  the print options to  produce the output that  you want.
  2356.                This is accomplished by  choosing Option from the pop-up menu.  A
  2357.                full screen Option menu will appear with several options that can
  2358.                be set.  Let's  set the left margin to 10 and  insert a header to
  2359.                read "Prepared on May 1, 1989".   Hit <Esc> when all the  options
  2360.                have been set to suit your needs.
  2361.  
  2362.                4.   Finally, print  your spreadsheet  by selecting  Go from  the
  2363.                menu.
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.                                           32
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.      RECORDING A MACRO
  2386.  
  2387.      Although ProQube Lite's application language  is powerful enough to  create
  2388.      sophisticated  business applications,  there are many  times when  you will
  2389.      want  to simply  repeat a sequence  of keystrokes  over and over.   ProQube
  2390.      Lite's Macro Recorder  provides an easy way  to create and play  back often
  2391.      repeated key sequences.  The macro recorder allows you to assign a sequence
  2392.      of keystrokes to a single key, and when you press that single  key, it will
  2393.      automatically play back the keystroke sequence for you.
  2394.  
  2395.      To begin recording  a macro,  you simply press  the <^F10>  key.  You  then
  2396.      press the key you  want to assign the macro to, and the word REC will begin
  2397.      flashing in  the upper  right corner  of the  screen.   As long  as REC  is
  2398.      flashing, ProQube Lite will be memorizing  any further keystrokes you type.
  2399.      When you  want to stop  recording, just press the  <^F10> key again.   Your
  2400.      macro  will be  stored in  a  file whose  name corresponds  to the  key you
  2401.      assigned  the macro to.  For example,  a macro assigned to <Ctrl>T would be
  2402.      named CTRLT.PQM.
  2403.  
  2404.      Later, when you  press <Ctrl>T, ProQube Lite  will look for the  macro file
  2405.      CTRLT.PQM,  and play back  the keystrokes which  are saved there.   You can
  2406.      assign a macro to just about  any key which isn't already defined and  used
  2407.      by ProQube Lite.   For  example, you can't  redefine the arrow  keys to  do
  2408.      something else, but you  can assign other keys to do the  same thing as the
  2409.      arrow keys.  
  2410.  
  2411.      Example   Suppose that you often  need to format individual cells  with the
  2412.                currency  format  and 2  decimal  places  (and no  commas).   The
  2413.                keystrokes needed to perform that command are:
  2414.  
  2415.                /CFCN2<Enter>
  2416.  
  2417.                Rather than type these 7 keystrokes for each cell, you want to be
  2418.                able  to  push a  single  key (lets  say <Alt>F)  to  perform the
  2419.                formatting.
  2420.  
  2421.                First, move to  one of the cells  you want to format,  then press
  2422.                <^F10> to turn on the  macro recorder.  A box will pop up telling
  2423.                you  to press the  key to assign  the macro to,  so press <Alt>F.
  2424.                The work REC will begin flashing in the upper right corner of the
  2425.                screen.    Then just  begin  typing  the keystrokes  you  want to
  2426.                record:
  2427.  
  2428.                /CFCN2<Enter>
  2429.  
  2430.                followed by <^F10> to turn the macro recorder off.
  2431.  
  2432.           You have just created  a macro.  Now, the next time you want to format
  2433.           a cell as currency, just  put the cell pointer on that  cell and press
  2434.           <Alt>F.   ProQube Lite will search  for the file named  ALTF.PQM which
  2435.           was created  by the  macro recorder,  and will  replay the  keystrokes
  2436.           which were stored in that file.
  2437.  
  2438.                                           33
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.      THE PROQUBE LITE TEXT EDITOR
  2452.  
  2453.      ProQube Lite provides a simple text editor which you can use to  create and
  2454.      edit  your  application programs.   This  editor  can be  called up  in two
  2455.      different ways.
  2456.  
  2457.           - The /Macro Edit command  will ask you for the name of a  macro.  You
  2458.           may enter a file name, or press <Enter> to select a file from the file
  2459.           manager.  You will then be placed in the ProQube Lite text editor.
  2460.  
  2461.           - You  may press <F5>  when you are  using the /File  Files command to
  2462.           edit the highlighted file.
  2463.  
  2464.      When you are  using the text editor,  the following keys are  available for
  2465.      moving around and manipulating text in your file.
  2466.  
  2467.      <Up> <Down>
  2468.      <Left> <Right> The arrow keys move the cursor up or down one line,  or left
  2469.                     or right one character.
  2470.  
  2471.      <Home>         This key moves the cursor to the beginning of the line.
  2472.      <End>          This key moves the cursor to the end of the line.
  2473.      <^Right>       This key moves the cursor one word to the right.
  2474.      <^Left>        This key moves the cursor one word to the left.
  2475.  
  2476.      <^Home>        This key moves the cursor to the top of the file.
  2477.      <^End>         This key moves the cursor to the end of the file.
  2478.  
  2479.      <PgDn>         This key moves the cursor down one screen.
  2480.      <PgUp>         This key moves the cursor up one screen.
  2481.  
  2482.      <BkSp>         This key deletes the character to the left of the cursor and
  2483.                     shifts the following characters  in the line to the  left to
  2484.                     fill in the empty space.
  2485.  
  2486.      <^BkSp>        This key deletes the entire line.
  2487.  
  2488.      <Del>          This key  deletes the  character underneath  the cursor  and
  2489.                     shifts the following characters  in the line to the  left to
  2490.                     fill in the empty space.
  2491.  
  2492.      <Ins>          This key toggles  between insert  and overwrite modes.  When
  2493.                     you are in insert  mode, typing a character will  insert the
  2494.                     new character into  the line at  the point where the  cursor
  2495.                     is. The character under the cursor and those to the right of
  2496.                     the cursor are shifted to the right to make room for the new
  2497.                     character.  When  you  are  in   overwrite  mode,  typing  a
  2498.                     character will replace  the character under the  cursor with
  2499.                     the new character.   When you are in insert mode, the cursor
  2500.                     will be an underline.  In  overwrite mode the cursor will be
  2501.                     a solid block.
  2502.  
  2503.  
  2504.                                           34
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.      In addition, the  following function keys  perform the following  functions
  2518.      when used in the text editor.   An index of these function keys  is located
  2519.      along the bottom line of the editor display.
  2520.  
  2521.      <F1> Help      This  key causes a help screen to  appear which lists all of
  2522.                     the commands available for text editing.
  2523.  
  2524.      <F2> Mark      This key  turns on marking at the  current line.  Moving the
  2525.                     cursor after pressing this key causes text between that line
  2526.                     and the new  line to be highlighted.  Pressing <F2> a second
  2527.                     time will turn off text marking.
  2528.  
  2529.      <F3> Cut       Pressing this  key with marking turned on  (<F2>) causes the
  2530.                     marked lines  to be  cut out  of the  file and  placed in  a
  2531.                     buffer.  You may then  move to another location in  the file
  2532.                     and use the <F4> key to paste  the lines back into the file.
  2533.                     The buffer will  only hold one block of lines, so if you cut
  2534.                     data a second time, the new data replaces  the older data in
  2535.                     the buffer.
  2536.  
  2537.      <F4> Paste     This keys causes  the contents  of the buffer  to be  pasted
  2538.                     into the file  at the cursor location.  This  does not clear
  2539.                     the buffer, so you may paste the  same buffer data into more
  2540.                     than one location.
  2541.  
  2542.      <F5> DelLine   This command deletes the line the cursor is on.
  2543.  
  2544.      <F6> Search    This command allows you to search  for a string in the file.
  2545.                     You will be  asked to enter the text you want to search for.
  2546.                     Simply enter  the text, and the cursor  will be moved to the
  2547.                     next  occurrence   of  that  text.    The   search  is  case
  2548.                     insensitive, which means that hello will match hello, Hello,
  2549.                     or HeLlO.
  2550.  
  2551.      <F7> Save      This command allows  you to  save the current  file to  disk
  2552.                     without having to exit.
  2553.  
  2554.      <F10> Exit     This command allows  you to  exit from the  editor.  If  you
  2555.                     have made any changes to the file, you will be asked  if you
  2556.                     want to save it first.
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.                                           35
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.      THE PROQUBE LITE APPLICATION LANGUAGE
  2584.  
  2585.      In  addition  to  the macro  recorder,  ProQube Lite  provides  a  built in
  2586.      programming  language  which  provides  additional  capabilities  such   as
  2587.      windowing, menu creation, control structures, database screen painting, and
  2588.      file, printer, and DOS access.
  2589.  
  2590.      A  ProQube  Lite  application  program  simply  consists  of  a  text  file
  2591.      containing the commands which you would like ProQube Lite to execute.   You
  2592.      may give your program files  any valid DOS name, but the  extension must be
  2593.      .PQM (for example  MYPROG.PQM).   Your application program  can consist  of
  2594.      keystroke macros, ProQube Command Language (PCL) commands, or both.
  2595.  
  2596.      Macros    A keystroke  macro is simply  a sequence of  keystrokes following
  2597.                the apostrophe character '.  When  ProQube Lite encounters one of
  2598.                these keystroke sequences in  your program, it simply  treats the
  2599.                keystrokes as if you typed them in yourself.  For example, if you
  2600.                place the line:
  2601.  
  2602.                '/sci2<Enter>
  2603.  
  2604.                into   your   application   program,  then   ProQube   Lite  will
  2605.                automatically insert two columns when it  executes this line.  It
  2606.                does this  by first typing  the / character (which  will bring up
  2607.                the menu), then  S (for slice), then <Ctrl>  (for column), then I
  2608.                (for  insert),  then the  number  2  (to insert  2  columns), and
  2609.                finally the <Enter> key (to complete the command).
  2610.  
  2611.      Commands  The ProQube Command Language (PCL) is a set of instructions which
  2612.                provides flexible I/O  capabilities, numerous control structures,
  2613.                file, printer, and DOS  access, and more.  In fact,  you may find
  2614.                that  the  PCL  commands  are  so  versatile that  many  of  your
  2615.                application programs will need few if  any keystroke macros.  The
  2616.                PCL   commands   are  described   in   detail  in   ProQube  Lite
  2617.                Applications.
  2618.  
  2619.      Creating  You create an application with  a text editor, just as  you would
  2620.                write  a  program in  any  programming  language.   ProQube  Lite
  2621.                provides a  simple text editor  which can  be called up  with the
  2622.                /Macro Edit command, or you can use your  own text editor outside
  2623.                of ProQube Lite.
  2624.  
  2625.      Running   Once you have created your application program, you will probably
  2626.                want  to run it.   There are  several ways to run  a ProQube Lite
  2627.                application program which you have created.
  2628.  
  2629.                - Using the /Macro Run command.
  2630.  
  2631.                - Pressing the key assigned to an application program.
  2632.  
  2633.                - Setting up conditions to start your program automatically using
  2634.                the /Macro Startup command.
  2635.  
  2636.                                           36
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.                - Giving  your program the  same name as one  of your worksheets.
  2651.                When a new data file (.PQS) is retrieved, ProQube Lite will check
  2652.                for a corresponding  application to run.   For example, when  you
  2653.                retrieve INVOICE.PQS, then ProQube Lite will look for and run the
  2654.                application INVOICE.PQM (if it exists).  
  2655.  
  2656.      Debugging Since few people  can create the  perfect program the first  time
  2657.                around,  ProQube  Lite   provides  several  powerful  application
  2658.                debugging features.  If  an error is encountered when  running an
  2659.                application,  then  an  error message  will  first  be displayed.
  2660.                Then, when you  press a key to  continue, ProQube Lite will  load
  2661.                the application into the editor, and place you on  the line where
  2662.                the error occurred to allow you to fix the problem.
  2663.  
  2664.                ProQube   Lite   also  provides   single   stepping,  conditional
  2665.                breakpoints, and  the ability to  examine and  edit cells  during
  2666.                program execution.
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.                                           37
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.      REFERENCE
  2716.  
  2717.  
  2718.      THE FUNCTION KEYS
  2719.  
  2720.      Several of  ProQube Lite's commands are assigned to  one of the 10 function
  2721.      keys instead of  or in addition to  the command menus.   These commands are
  2722.      ones which you might normally want to select with a single keystroke.
  2723.  
  2724.      Several other commands are  also assigned to one of the  function keys with
  2725.      the <Ctrl> key pressed.  To execute one of these commands, simply hold down
  2726.      the <Ctrl> key and then press the appropriate function key.
  2727.  
  2728.      The commands tied  to the function keys are also accessible with the mouse.
  2729.      Pressing the right button on the mouse  will turn the function key index at
  2730.      the bottom  of the screen into a moving bar menu.  Pressing the right mouse
  2731.      button additional times toggles the function  key menu between the function
  2732.      key menu with and without the <Ctrl> key pressed.
  2733.  
  2734.      Pressing  the  left mouse  button selects  the  item which  is highlighted.
  2735.      Pressing both keys together escapes from the menu.
  2736.  
  2737.  
  2738.      <F1> Help      This key calls  up context  sensitive help.   A help  screen
  2739.                     will pop up  which provides information about  the operation
  2740.                     you are currently attempting.  The help screen which pops up
  2741.                     will  also list several other help screens which are related
  2742.                     to what you  are doing.  You  may view one of  these related
  2743.                     help screens by simply using the  <Left> and <Right> keys to
  2744.                     move  the  highlight bar  to  the  name of  the  help screen
  2745.                     desired,  and then  pressing the <Enter>  key, or  by simply
  2746.                     pressing the first letter of the desired help screen's name.
  2747.  
  2748.                     You may also call up a list of help screens called the <HELP
  2749.                     INDEX> by pressing the <F1> key a second time.
  2750.  
  2751.                     After you have read the help  screens you are interested in,
  2752.                     you can simply  press the  <Esc> key to  return to what  you
  2753.                     were doing.
  2754.  
  2755.      <F2> Edit      This key allows  you to edit the current cell.  When you are
  2756.                     in edit mode, the following editing keys are available:
  2757.  
  2758.                     <Left>    moves the cursor one character to the left.
  2759.                     <Right>   moves the cursor one character to the right.
  2760.                     <Home>    moves the cursor to the first character.
  2761.                     <End>     moves the cursor to the last character.
  2762.                     <^Right>  moves the cursor one word to the right.
  2763.                     <^Left>   moves the cursor one word to the left.
  2764.  
  2765.                     <BkSp>    deletes the character  to the  left of the  cursor
  2766.                               and shifts the following characters in the line to
  2767.  
  2768.                                           38
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.                               the left to fill in the empty space.
  2782.  
  2783.                     <^BkSp>   deletes the entire line.
  2784.  
  2785.                     <Del>     deletes the  character underneath  the cursor  and
  2786.                               shifts the following characters in the line to the
  2787.                               left to fill in the empty space.
  2788.  
  2789.                     <Ins>     toggles between insert and overwrite modes.
  2790.  
  2791.      <F3> Block     This key calls up a menu  of defined block names.  This  key
  2792.                     can be used any time you are asked to define a  cell, range,
  2793.                     or  block.    You  may  pick  a  block  from  this  list  by
  2794.                     highlighting the  name and  pressing the  <Enter>  key.   If
  2795.                     there are more  than 16 block  names defined, you may  press
  2796.                     the <PgUp> and <PgDn> keys to view more block names.
  2797.  
  2798.      <F4> Absolute  This key cycles  absolute and  relative references when  you
  2799.                     are pointing out cell  references with the cursor keys.   If
  2800.                     no anchor is set  then the first coordinate is  adjusted. If
  2801.                     the anchor has been set then <F4> will adjust the non-anchor
  2802.                     reference.
  2803.  
  2804.      <F5> GoTo      This key  allows you  to move  the cell  pointer to  another
  2805.                     cell.   You will be  asked for the name  of the cell to move
  2806.                     to.  For example, if you enter Q23;43, then the cell pointer
  2807.                     will be moved to that cell.  If you enter a block name, then
  2808.                     the cell pointer will be moved to the cell in the upper left
  2809.                     corner of the  block.  You may also press the <F3> Block key
  2810.                     and pick a block name from a menu of existing names.
  2811.  
  2812.      <F6> Search    This key allows you to search  for some text in a cell,  and
  2813.                     allows you to move the cell  pointer to that cell or replace
  2814.                     the text with other text.
  2815.  
  2816.                     Find           This option allows you to  enter the text you
  2817.                                    want to search for.
  2818.  
  2819.                     Replace with   This option allows you to  enter the text you
  2820.                                    want to replace the Find text with.
  2821.  
  2822.                     Ignore case    If you set  this option to No,  then the Find
  2823.                                    text must  match text in the WorkQube exactly
  2824.                                    to be considered a match.  If this  option is
  2825.                                    Yes, then the  Find text  will match text  in
  2826.                                    the  WorkQube if  the  letters are  the same,
  2827.                                    even if some are uppercase and some are lower
  2828.                                    case.
  2829.  
  2830.                     Block          This option allows you to define the block of
  2831.                                    cells you want to search.  This allows you to
  2832.                                    limit  your  search to  as  small a  block of
  2833.  
  2834.                                           39
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.                                    cells as you want.
  2848.  
  2849.                     Start          This  command begins  the search  and replace
  2850.                                    operation.  ProQube Lite will begin searching
  2851.                                    through the defined block, and will stop when
  2852.                                    it finds a match.   The matching cell and its
  2853.                                    contents will be  displayed, and you will  be
  2854.                                    asked  if you  want to  perform  the Replace.
  2855.                                    There are 4 options.
  2856.  
  2857.                                    No   No,  don't  perform  the   replace,  but
  2858.                                         continue searching.
  2859.  
  2860.                                    Yes  Yes,  perform  the  replace,   and  then
  2861.                                         continue searching.
  2862.  
  2863.                                    All  Yes, perform  the replace  on this,  and
  2864.                                         all other matches which you find.   This
  2865.                                         is a global search  and replace, and you
  2866.                                         will  not  be  asked  for  any   further
  2867.                                         confirmation.
  2868.  
  2869.                                    GoTo No, don't perform the replace, and  just
  2870.                                         move the  cell pointer to this  new cell
  2871.                                         and quit any further searching.
  2872.  
  2873.                                    If you just want to quit, then you can simply
  2874.                                    press the <Esc> key.
  2875.  
  2876.      <F7> Load      This key retrieves a worksheet from disk.  You will be asked
  2877.                     for the name  you want the file  to retrieve.  If  you press
  2878.                     <Enter> without  entering a file name, the File Manager will
  2879.                     appear, and you may select your file from a list.
  2880.  
  2881.      <F8> Save      This  key saves the current worksheet  to disk.  You will be
  2882.                     asked for the name you want the file to be saved as.  If you
  2883.                     press <Enter> without entering a file name, the File Manager
  2884.                     will appear.
  2885.  
  2886.      <F9> Recalc    This key recalculates the entire worksheet.  This command is
  2887.                     only necessary  when you have used the /WorkQube Calc Manual
  2888.                     command to disable automatic minimal recalculation.
  2889.  
  2890.      <^F1> Info     This key allows you  to enter a worksheet description.   The
  2891.                     description may be  up to 60  characters long, and is  saved
  2892.                     along  with the worksheet.  If  you press <^F1> when you are
  2893.                     in the File Manager, it will  display the description of the
  2894.                     currently highlighted worksheet.  This  allows you to see  a
  2895.                     description of a  worksheet without having to  actually load
  2896.                     the worksheet into memory.
  2897.  
  2898.      <^F2> Debug    This key brings up  the application program debug  menu when
  2899.  
  2900.                                           40
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.                     you  are  single  stepping through  an  application program.
  2914.                     Simply  select Edit from the menu,  then type in the name of
  2915.                     the cell you want to examine.  ProQube Lite will display the
  2916.                     current contents of the  cell, and will allow you  to modify
  2917.                     those contents if  you want.   When you  press <Enter>,  the
  2918.                     ProQube   Lite  will  resume  single  stepping  through  the
  2919.                     application.
  2920.  
  2921.      <^F3> Break    This  key breaks out of a running application.  If you press
  2922.                     this key  when an  application program  is running, it  will
  2923.                     abort  the application  unless  the application  program has
  2924.                     used the #BREAK command to disable breaking.
  2925.  
  2926.      <^F4> Mark     This key marks the current cell so that you can later return
  2927.                     to it  with the <^F5> key.  For  example, if you press <^F4>
  2928.                     when the cell pointer  is on cell Q53;3,  then you can  move
  2929.                     anywhere in the worksheet and return to cell Q53;3 by simply
  2930.                     pressing the <^F5> key.
  2931.  
  2932.      <^F5> ToMark   This key returns to the last cell marked with <^F4>.
  2933.  
  2934.      <^F6> Files    This key calls  up the File Manager.   You will be  asked to
  2935.                     enter a mask to tell ProQube Lite which files you want to be
  2936.                     displayed.   Pressing <Enter> will  use the Mask  *.*, which
  2937.                     will display all of the files in the current directory.
  2938.  
  2939.                     The  following  functions  are  available  within  the  File
  2940.                     Manager:
  2941.  
  2942.                     <F1>      Help screen.
  2943.                     <F2>      Loads the highlighted .PQS file.
  2944.                     <F3>      Combines the highlighted .PQS file.
  2945.                     <F4>      Imports the highlighted file.
  2946.                     <F5>      Allows you to edit the contents of the highlighted
  2947.                               text file.
  2948.                     <F6>      Causes the highlighted text file to be printed.
  2949.                     <F7>      Runs the highlighted .EXE, .COM, or .BAT file.
  2950.                     <F8>      Allows you to rename the highlighted file.
  2951.                     <F9>      Copies the highlighted file.
  2952.                     <F10>     Deletes the highlighted file.
  2953.                     <^F1>     Displays the  description of the  highlighted .PQS
  2954.                               file.
  2955.  
  2956.                     The  File  Manager  also simplifies  the  tasks  of changing
  2957.                     drives and  directories.   To change  to another  directory,
  2958.                     simply  press  the   <Left>  key   to  highlight  the   word
  2959.                     DIRECTORIES at the top of the screen, then use the <Up>  and
  2960.                     <Down> keys to highlight the name  of the directory you want
  2961.                     to  change  to.   Once the  name  is highlighted,  press the
  2962.                     <Enter> key and ProQube  Lite will change to that  directory
  2963.                     and list the files in that directory.
  2964.  
  2965.  
  2966.                                           41
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.                     Changing drives is  just as easy.   Simply press the  <Left>
  2980.                     key until  the word DRV  is highlighted  at the  top of  the
  2981.                     screen,  then  press the  letter of  the  drive you  want to
  2982.                     change to.  For example, if you  want to change to drive A:,
  2983.                     then just press A.
  2984.  
  2985.      <^F7> EGA43    This key toggles  43/50 line mode  on EGA/VGA monitors.   If
  2986.                     you have an EGA or VGA monitor, this function allows  you to
  2987.                     see twice as many rows on the screen as normal.
  2988.  
  2989.      <^F8> Status   This key displays a status window.   The status window lists
  2990.                     the  current directory and  file name, the  amount of memory
  2991.                     available,  the  current  date  and  time, and  the  current
  2992.                     default settings.
  2993.  
  2994.      <^F9> Enter    This key toggles Enter mode.  This mode is especially useful
  2995.                     for repetitive  data entry.   When  you are  in Enter  mode,
  2996.                     pressing the  <Enter> key  to enter  data into  a cell  will
  2997.                     enter that  data and them move the  cell pointer in the last
  2998.                     direction  moved.   For example,  if the  cell pointer  last
  2999.                     moved  down, then typing  in a  number and  pressing <Enter>
  3000.                     will enter  that number into the highlighted  cell, and will
  3001.                     move the cell  pointer down to the  next cell.  This  allows
  3002.                     you  to use the numeric keypad  and the <Enter> key to enter
  3003.                     rows or columns of data.
  3004.  
  3005.      <^F10> Record  This key turns  the macro  recorder on and  off.  The  macro
  3006.                     recorder allows you to assign a  sequence of keystrokes to a
  3007.                     single key,  and when  you press  that single  key, it  will
  3008.                     automatically play back the keystroke sequence for you.
  3009.  
  3010.                     To begin recording a macro, you simply press the <^F10> key.
  3011.                     You then press the key you want to assign the macro  to, and
  3012.                     begin typing the keys to record.  The word REC will flash in
  3013.                     the upper right corner of the  screen while recording is on.
  3014.                     When you are ready to stop  recording, just press the <^F10>
  3015.                     key again.  Your  macro will be stored in a  file whose name
  3016.                     corresponds  to  the key  you assigned  the  macro to.   For
  3017.                     example,  a  macro  assigned  to   <Ctrl>T  would  be  named
  3018.                     CTRLT.PQM.
  3019.  
  3020.                     Later, when  you press <Ctrl>T,  ProQube Lite will  look for
  3021.                     the macro file CTRLT.PQM, and play back the keystrokes which
  3022.                     are saved there.
  3023.  
  3024.                     If a macro already exists for the key you want to record to,
  3025.                     ProQube Lite will provide the following options:
  3026.  
  3027.                     Replace        Replace the existing macro with this new one.
  3028.                     Edit           Edit the existing macro.
  3029.                     Cancel         Cancel this operation.
  3030.  
  3031.  
  3032.                                           42
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.      PROQUBE LITE COMMAND MENUS
  3046.  
  3047.      When you  want to  execute a command  in ProQube  Lite, it will  usually be
  3048.      through ProQube Lite's menu  system.  A menu  is simply a list of  commands
  3049.      which you  can pick  from.   Through the  menus you  can manipulate  cells,
  3050.      blocks, or the  entire WorkQube, graph or print data,  manipulate files, or
  3051.      even temporarily exit to the operating system.
  3052.  
  3053.      To bring up  ProQube Lite's menu  system, you  simply press the  / key  (or
  3054.      press the  left button  on your  mouse).  At  the top  of the  ProQube Lite
  3055.      screen you will see the following menu.
  3056.  
  3057.  
  3058.      Cell  Block  Slice  WorkQube  File  Print  Data  Macro  OpSys  Quit
  3059.  
  3060.      The  menu system uses  a sliding bar to  show your choices.   There are two
  3061.      ways to choose an option:
  3062.  
  3063.           -  Press  the  <Left>  or  <Right>  key  until  the  sliding   bar  is
  3064.           highlighting  the option  you want.   Then press  <Enter> to  make the
  3065.           choice.   The <Home>  key can be  pressed to highlight  the first menu
  3066.           choice,  and  pressing the  <End>  key  will highlight  the  last menu
  3067.           choice.
  3068.  
  3069.           - As a  shortcut you can  simply press the  highlighted letter of  the
  3070.           desired item (usually the first character) to select that option.
  3071.  
  3072.      A  help  line  appears  above the  main  menu.    This  line describes  the
  3073.      highlighted menu option.  When you move the sliding bar to a new item, this
  3074.      help line will change to display a line of help about the newly highlighted
  3075.      item.
  3076.  
  3077.      When you choose an option  from the menu, a new  submenu will pop up  which
  3078.      works exactly  the same  way as  the main  menu.   As each  new submenu  is
  3079.      chosen, the previous menus remain on-screen, providing you with a "tree" of
  3080.      your commands.  To go back one level, simply press the <Esc> key.  To clear
  3081.      all of the menus from the screen at once, press the <BkSp> key.
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.                                           43
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.      --------------------------------------------------------------------------
  3112.      /Cell Format
  3113.      --------------------------------------------------------------------------
  3114.      Function  Change the way a value in a cell is displayed.
  3115.  
  3116.      Remarks   This command allows you to modify the display of the current cell
  3117.                by setting its format.  If the  value using the format you select
  3118.                is too  long to  fit into  the cell's  assigned width,  a row  of
  3119.                asterisks will appear.
  3120.  
  3121.      Options   General,  Currency,  Fixed,  Percent,  Scientific,  Time,   Date,
  3122.                Hidden, Label, and Reset.
  3123.  
  3124.  
  3125.      --------------------------------------------------------------------------
  3126.      /Cell Width
  3127.      --------------------------------------------------------------------------
  3128.      Function  Change a column width.
  3129.  
  3130.      Remarks   This command allows you to make the column the cell pointer is in
  3131.                wider or narrower (or even hide it).  This command is  often used
  3132.                when the formatted values  in a column exceed its  current width,
  3133.                and  a  row  of  asterisks  appear.   This  situation  is  easily
  3134.                corrected by widening the cell.
  3135.  
  3136.                If  you set  a  column width  to  zero, the  column  will not  be
  3137.                displayed.   You may still move the  cell pointer into the hidden
  3138.                column, but it will not be visible on the screen.  If you want to
  3139.                make the column visible again, simply  move the cell pointer into
  3140.                the column and reset the width or set it to a new wider value.
  3141.  
  3142.      Options   Set       The set option  allows you  to change the  width.   You
  3143.                          will be asked  how wide the column should be.   You may
  3144.                          either enter a number, or use  the arrow keys to change
  3145.                          the width.  <Left> will narrow the column,  and <Right>
  3146.                          will widen the column.
  3147.  
  3148.                Reset     Resets the column the cell pointer  is in to the global
  3149.                          width.
  3150.  
  3151.                All       Sets the width of the current column on all pages.  For
  3152.                          example, if the cell pointer is in column F, then using
  3153.                          this command to set the column width to 15 will set the
  3154.                          width of column F to 15 on all 512 pages.  This is much
  3155.                          more memory  efficient than setting the  column's width
  3156.                          on all 512 pages individually.  The arrow keys may also
  3157.                          be used to change the column width.
  3158.  
  3159.                Clear     Resets the width of the current column on all pages (if
  3160.                          it was  set with  the /Cell  Width All  command).   Any
  3161.                          individual column  widths  which were  set using  /Cell
  3162.                          Width Set will retain that setting.
  3163.  
  3164.                                           44
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.      --------------------------------------------------------------------------
  3178.      /Cell Erase
  3179.      --------------------------------------------------------------------------
  3180.      Function  Erase a cell from memory.
  3181.  
  3182.      Remarks   This command  erases the contents of  the current cell.   This is
  3183.                important, since editing the  cell's contents using the  <F2> key
  3184.                will not completely blank the cell; the cell will still  be using
  3185.                memory.  The cell will retain its formatting; for example, a cell
  3186.                formatted for percent will still be formatted for percent.
  3187.  
  3188.  
  3189.  
  3190.      --------------------------------------------------------------------------
  3191.      /Cell Justify
  3192.      --------------------------------------------------------------------------
  3193.      Function  Justify text in a cell.
  3194.  
  3195.      Remarks   This  command  allows you  to  change  the way  text  strings are
  3196.                displayed in the  cell which the cell pointer is in.  The command
  3197.                has three options:
  3198.  
  3199.      Options   Left      Justifies text in the current cell  to the left edge of
  3200.                          the cell.   When  a label  is entered,  it will  appear
  3201.                          beginning in the leftmost character of the cell.
  3202.  
  3203.                Right     Justifies text in the current cell to the right edge of
  3204.                          the cell.   When  a label  is entered,  it will  appear
  3205.                          flush right in the cell.
  3206.  
  3207.                Center    Justifies text in the current cell to the center of the
  3208.                          cell.  When a label is entered, it will appear centered
  3209.                          in the cell.
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.                                           45
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.      --------------------------------------------------------------------------
  3244.      /Cell Copy
  3245.      --------------------------------------------------------------------------
  3246.      Function  Copy a cell to another cell or block of cells.
  3247.  
  3248.      Remarks   This  command  copies the  contents  of  the cell  that  the cell
  3249.                pointer is  in to another  cell or block of  cells.  You  will be
  3250.                asked  to define the cell or block of  cells you want to copy to.
  3251.                If you copy  the cell to more  than one cell, an  individual copy
  3252.                will be made in each of the destination cell.  If the source cell
  3253.                contains a formula, all relative references will be adjusted when
  3254.                the formula is copied.
  3255.  
  3256.      Example   Cell B12;1 sums up the cells above it with the formula:
  3257.  
  3258.                =@SUM(B1;1..B11;1)
  3259.  
  3260.                You want cells C12;1 through X12;1 to sum up the cells above each
  3261.                of  them.   Simply move the  cell pointer  to cell  B12;1, select
  3262.                /Cell Copy, and define the block to copy to as C12;1..X12;1.  The
  3263.                formula will be copied to each  of those cells, and the  relative
  3264.                references in  the formula will be  adjusted so that they  sum up
  3265.                the  proper  cells.   For example,  cell  S12;1 will  contain the
  3266.                formula:
  3267.  
  3268.                =@SUM(S1;1..S11;1)
  3269.  
  3270.  
  3271.      --------------------------------------------------------------------------
  3272.      /Cell Move
  3273.      --------------------------------------------------------------------------
  3274.      Function  Move the contents of a cell to another cell.
  3275.  
  3276.      Remarks   This command moves the contents of the cell that the cell pointer
  3277.                is in to a different location.   You will be asked to define  the
  3278.                destination cell.  If  the current cell contains a  formula, then
  3279.                the  references  will be  adjusted  to  point to  the  same data.
  3280.                References in other cells which refer to the moved cell will also
  3281.                be adjusted so that they continue to point to the same data.
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.                                           46
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.      --------------------------------------------------------------------------
  3310.      /Cell Protect
  3311.      --------------------------------------------------------------------------
  3312.      Function  Set protection on a cell.
  3313.  
  3314.      Remarks   This  command allows  the current  cell to  be protected  against
  3315.                changes.  If, for example,  the cell contains a formula that  you
  3316.                do not  want changed, use the /Cell  Protect Yes command to guard
  3317.                against changes.  If  you thereafter want to edit  or change that
  3318.                formula, use the  /Cell Protect No command to unprotect the cell.
  3319.                The default mode is "protected."
  3320.  
  3321.                A protected cell may still be modified until WorkQube  protection
  3322.                is enabled  using the /WorkQube Protect Enable command.  WorkQube
  3323.                Protect is  much like  a "master  switch" which  turns protection
  3324.                capabilities on and off for the entire WorkQube.
  3325.  
  3326.      Options   Yes  Enables protection on the current cell.
  3327.                No   Disables protection on the current cell.
  3328.  
  3329.  
  3330.      --------------------------------------------------------------------------
  3331.      /Cell Setup
  3332.      --------------------------------------------------------------------------
  3333.      Function  Select a setup string to a cell.
  3334.  
  3335.      Remarks   This command allows you  to select a setup string for the current
  3336.                cell  (for printing--the style will  not change on-screen).  This
  3337.                allows for very sophisticated printouts  of spreadsheets.  Bottom
  3338.                lines may be boldfaced, for example, or may appear in a different
  3339.                font.
  3340.  
  3341.      Options   The options depend  on your  printer.  If  your printer  supports
  3342.                boldfacing,  underlining,  italics,  and  condensed  print,  your
  3343.                options would include those choices.
  3344.  
  3345.                If, for example,  your printer allows  italics, "Italics" can  be
  3346.                one of the  option choices.  To change the current cell's font to
  3347.                italic, issue the command /Cell Setup and select Italics from the
  3348.                menu.
  3349.  
  3350.                In order  to use the  /Cell Setup command,  you must first  enter
  3351.                your setup strings using the /Print Setup Fonts command.
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.                                           47
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.      --------------------------------------------------------------------------
  3376.      /Block Format
  3377.      --------------------------------------------------------------------------
  3378.      Function  Change the way values in a block of cells is displayed.
  3379.  
  3380.      Remarks   This command allows  you to choose the best format  for the cells
  3381.                in a block.  You  will be asked to define the block  of cells you
  3382.                want to change the format of.
  3383.  
  3384.      Options   General,  Currency,  Fixed,  Percent,   Scientific,  Time,  Date,
  3385.                Hidden, Label, and Reset.
  3386.  
  3387.  
  3388.      --------------------------------------------------------------------------
  3389.      /Block Width
  3390.      --------------------------------------------------------------------------
  3391.      Function  Set the width of several columns at once.
  3392.  
  3393.      Remarks   This command allows you to make several columns wider or narrower
  3394.                (or even hide  them).  You will  be asked to define  the block of
  3395.                columns  to widen or narrow.  If you  set a column width to zero,
  3396.                the column will  not be displayed.   You may still move  the cell
  3397.                pointer into the hidden column, but it will not be visible on the
  3398.                screen.   If you want  to make the  column visible  again, simply
  3399.                move the cell pointer into the column  and reset the width or set
  3400.                it to a new wider value.
  3401.  
  3402.                This command is often used when  the formatted values in a column
  3403.                exceed  its current width,  and a row  of asterisks  appear.  The
  3404.                situation is easily corrected by widening the column.
  3405.  
  3406.      Options   Set       The  set  option  allows you  to  change  the  width of
  3407.                          several columns at the same time.  You may either enter
  3408.                          a number, or  use the arrow  keys to change the  width.
  3409.                          <Left> will narrow  the column, and <Right>  will widen
  3410.                          the column.
  3411.  
  3412.                Reset     Resets the columns in the block to the global width.
  3413.  
  3414.                All       Sets  the  width of  the columns  in  the block  on all
  3415.                          pages.  For example,  if the cell pointer is  in column
  3416.                          F, then using this  command to set the column  width to
  3417.                          15 will set  the width  of column  F to 15  on all  512
  3418.                          pages.  This is much more memory efficient than setting
  3419.                          the  column's width on all 512 pages individually.  The
  3420.                          arrow keys  may  also  be used  to  change  the  column
  3421.                          widths.
  3422.  
  3423.                Clear     Resets the width  of the  columns in the  block on  all
  3424.                          pages (if it was set with the /Cell Width All command).
  3425.                          Any individual column widths which were set using /Cell
  3426.                          Width Set will retain that setting.
  3427.  
  3428.                                           48
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.      --------------------------------------------------------------------------
  3442.      /Block Erase
  3443.      --------------------------------------------------------------------------
  3444.      Function  Erase a block of cell's contents from memory.
  3445.  
  3446.      Remarks   This command  erases the contents of a block  of cells.  You will
  3447.                be asked to define the block of cells you want to erase.  This is
  3448.                important, since editing  each cell in  the block using the  <F2>
  3449.                key  will not completely blank the block; the block will still be
  3450.                using memory.   The cells in the block will retain their formats;
  3451.                for example, cells in the block  formatted for percent will still
  3452.                be formatted for percent.
  3453.  
  3454.  
  3455.  
  3456.      --------------------------------------------------------------------------
  3457.      /Block Justify
  3458.      --------------------------------------------------------------------------
  3459.      Function  Justify text in a block of cells.
  3460.  
  3461.      Remarks   This  command  allows you  to  change  the way  text  strings are
  3462.                displayed in each cell in a  block.  You will be asked to  define
  3463.                the block  of cells you  want to change.   The command  has three
  3464.                options:
  3465.  
  3466.      Options   Left      Justifies text in  each cell of  the block to the  left
  3467.                          edge of the  cell.   When a label  is entered, it  will
  3468.                          appear beginning in the leftmost character of the cell.
  3469.  
  3470.                Right     Justifies text in each  cell of the block to  the right
  3471.                          edge of  the cell.   When a label  is entered, it  will
  3472.                          appear flush right in the cell.
  3473.  
  3474.                Center    Justifies text in each cell of  the block to the center
  3475.                          of  the cell.  When a  label is entered, it will appear
  3476.                          centered in the cell.
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.                                           49
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.      --------------------------------------------------------------------------
  3508.      /Block Copy
  3509.      --------------------------------------------------------------------------
  3510.      Function  Copy a block of cells to another location.
  3511.  
  3512.      Remarks   This command copies  the contents of a block of  cells to another
  3513.                location.  You will first be asked to define the cell or block of
  3514.                cells you want to copy (source block), and then the  location you
  3515.                want  to copy to (destination).  If the destination you define is
  3516.                a single cell, the source block  will be copied starting at  that
  3517.                location.  If  the destination contains  more than one cell,  the
  3518.                source  block  will be  copied to  each  cell in  the destination
  3519.                block.  This  is useful for copying  a block of cells  to several
  3520.                adjacent locations at once.  If any of the source cells contain a
  3521.                formula,  all  relative  references  will  be adjusted  when  the
  3522.                formula is copied.
  3523.  
  3524.      Example   Column A contains a list of formulas from row  1 through 10.  You
  3525.                want to  copy this  block  of formulas  to columns  B through  F.
  3526.                Select  /Block Copy,  and  select the  block  A1;1..A10;1 as  the
  3527.                source block.   Since  you want to  copy the  block to  columns B
  3528.                through  F,  you  should  select  the  block  B1;1..F1;1  as  the
  3529.                destination.  ProQube  Lite will  then copy the  source block  to
  3530.                each cell in the destination block.
  3531.  
  3532.  
  3533.  
  3534.      --------------------------------------------------------------------------
  3535.      /Block Move
  3536.      --------------------------------------------------------------------------
  3537.      Function  Move the contents of a block of cells.
  3538.  
  3539.      Remarks   This  command  moves the  contents  of  a  block  of cells  to  a
  3540.                different location.  You will be asked  to first define the block
  3541.                of cells  to move (source  block), and then the  destination.  If
  3542.                any of the cells in the source block contains a formula, then the
  3543.                references will  be adjusted  to continue  to point  to the  same
  3544.                data.  References in  other cells which refer  to the moved  cell
  3545.                will also be adjusted so that they continue to point to  the same
  3546.                data.
  3547.  
  3548.                When you define the destination, you only need to supply a single
  3549.                cell address; the source block will be copied with the upper left
  3550.                corner in the destination cell.
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.                                           50
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.      --------------------------------------------------------------------------
  3574.      /Block Name
  3575.      --------------------------------------------------------------------------
  3576.      Function  Give a name to a block of cells.
  3577.  
  3578.      Remarks   This  command allows you  to give  a name to  a cell  or block of
  3579.                cells.  This name  can then be used anywhere that  a cell address
  3580.                or block reference  can be used  by either typing in  the block's
  3581.                name or  by pressing the  <F3> Block key  and selecting the  name
  3582.                from a menu.  Single cells are acceptable as named blocks.
  3583.  
  3584.                A formula may also  reference a named range absolutely  by simply
  3585.                putting a $ character in front of the range name.
  3586.  
  3587.      Options   Create    Allows you to name the cell or block.  When this option
  3588.                          is selected, you  are asked what  you want to name  the
  3589.                          cell or  block.  The name  must begin with a  letter of
  3590.                          the alphabet and can be  up to 8 characters long.   You
  3591.                          are then asked to define the block to name by typing in
  3592.                          the block address or by pointing out the block with the
  3593.                          cursor keys.
  3594.  
  3595.                Delete    Releases  the  block name  which  is associated  with a
  3596.                          block.   You  will  be asked  to  type in  the name  to
  3597.                          delete.  You may  press <Enter> without typing  a name,
  3598.                          and a menu of the current  block names will appear, and
  3599.                          you may select the name to delete from the menu.  Up to
  3600.                          16 names will be displayed at a time.  If you don't see
  3601.                          the name you want to delete,  use the <PgDn> and <PgUp>
  3602.                          keys to see more names.
  3603.  
  3604.                Reset     Deletes all block names.
  3605.  
  3606.                List      Causes a list of the current block names to appear.  Up
  3607.                          to 16  names will be  displayed at a time.   Use <PgUp>
  3608.                          and <PgDn> to see more names.
  3609.  
  3610.      Example   If you  assigned the  name PRICES  to the  block B3;1..C6;3,  the
  3611.                formula   @AVG(PRICES)  will   be   identical  to   the   formula
  3612.                @AVG(B3;1..C6;3).  Other  /Block commands  which request a  block
  3613.                reference,  such  as /Block  Erase, will  accept  the name  as an
  3614.                address.  Pressing <F3> will bring up a menu of range names.  The
  3615.                <F5> GoTo key will also accept block names.
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.                                           51
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.      --------------------------------------------------------------------------
  3640.      /Block Protect
  3641.      --------------------------------------------------------------------------
  3642.      Function  Set protection on a block of cells.
  3643.  
  3644.      Remarks   This  command allows you  to protect a  block of cells.   If, for
  3645.                example,  the  block  contains  formulas  that you  do  not  want
  3646.                changed,  use the  /Block  Protect Yes  command to  guard against
  3647.                changes.  If  you thereafter want to edit or change a cell in the
  3648.                block, use the  /Cell Protect No  command to unprotect the  cell.
  3649.                The default mode is "protected."
  3650.  
  3651.                A protected cell may still be modified until WorkQube  protection
  3652.                is enabled  using the /WorkQube Protect Enable command.  WorkQube
  3653.                Protect is  much like  a "master  switch" which  turns protection
  3654.                capabilities on and off for the entire WorkQube.
  3655.  
  3656.                You will be asked to define the block you want to protect.
  3657.  
  3658.      Options   Yes  Enables protection on the selected block.
  3659.                No   Disables protection on the selected block.
  3660.  
  3661.  
  3662.  
  3663.      --------------------------------------------------------------------------
  3664.      /Block Setup
  3665.      --------------------------------------------------------------------------
  3666.      Function  Select a setup string for a block of cells.
  3667.  
  3668.      Remarks   This command  allows you to select a setup  string for a block of
  3669.                cells (for printing--the style will not change on-screen).   This
  3670.                allows for very sophisticated printouts  of spreadsheets.  Bottom
  3671.                lines may be boldfaced, for example, or may appear in a different
  3672.                font.
  3673.  
  3674.      Options   The options depend  on your  printer.  If  your printer  supports
  3675.                boldfacing,  underlining,  italics,  and  condensed  print,  your
  3676.                options would include those choices.
  3677.  
  3678.                If, for example,  your printer allows  italics, "Italics" can  be
  3679.                one of  the option choices.  To  change the current block's setup
  3680.                string  to italic,  issue  the command  /Block  Setup and  select
  3681.                Italics from the menu.
  3682.  
  3683.                In order to  use the /Block Setup  command, you must first  enter
  3684.                your setup strings using the /Print Setup Fonts command.
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.                                           52
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.      --------------------------------------------------------------------------
  3706.      /Slice Column Insert
  3707.      --------------------------------------------------------------------------
  3708.      Function  Insert one or more blank columns.
  3709.  
  3710.      Remarks   This command inserts  one or  more blank columns  at the  current
  3711.                cell pointer position.  The current column and all the columns to
  3712.                the  right  will be  shifted  right to  make  room for  the blank
  3713.                columns.  Relative references in formulas  will be updated by the
  3714.                change;  absolute references will remain  unchanged.  You will be
  3715.                asked how many  blank columns you want  to insert.  You  may also
  3716.                use  the  arrow  keys to  highlight  how  may  columns should  be
  3717.                inserted.
  3718.  
  3719.  
  3720.  
  3721.      --------------------------------------------------------------------------
  3722.      /Slice Column Delete
  3723.      --------------------------------------------------------------------------
  3724.      Function  Delete one or more columns.
  3725.  
  3726.      Remarks   This command  deletes one  or more  columns at  the current  cell
  3727.                pointer position.   The contents of  the deleted columns will  be
  3728.                erased, and all of the columns to the right will be  shifted left
  3729.                to fill in the deleted columns.   Relative references in formulas
  3730.                will be  updated by the  change; absolute references  will remain
  3731.                unchanged.    You will  be asked  how  many columns  you  want to
  3732.                delete.  You may also use the arrow keys to highlight the columns
  3733.                that should be deleted.
  3734.  
  3735.  
  3736.  
  3737.      --------------------------------------------------------------------------
  3738.      /Slice Column Erase
  3739.      --------------------------------------------------------------------------
  3740.      Function  Erase the contents of a column of cells.
  3741.  
  3742.      Remarks   This  command erases the contents of all  the cells in the column
  3743.                which the cell  pointer is in.  This is  important, since editing
  3744.                each  cell  in  the  column using  the  <F2>  Edit  key  will not
  3745.                completely blank the column;  the cells in the column  will still
  3746.                be using  memory.   The cells  in  the column  will retain  their
  3747.                formatting;  for  example, a  column  formatted for  percent will
  3748.                still be formatted for percent.
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.                                           53
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.      --------------------------------------------------------------------------
  3772.      /Slice Column Copy
  3773.      --------------------------------------------------------------------------
  3774.      Function  Copy a column of cells to another column or columns.
  3775.  
  3776.      Remarks   This command copies the contents of  one or more columns of cells
  3777.                to another  location.   You  will first  be asked  to define  the
  3778.                column or columns you want to copy (source columns), and then the
  3779.                location you want to copy to (destination).
  3780.  
  3781.                If the  destination you  define is  a single  column, the  source
  3782.                column  will  be  copied  starting  at  that location.    If  the
  3783.                destination contains more than one column, the source column will
  3784.                be  copied to  each of the  destination columns.   If any  of the
  3785.                source cells contain  a formula, all relative  references will be
  3786.                adjusted when the formula is copied.
  3787.  
  3788.                Because ProQube Lite only looks at  the column coordinates in the
  3789.                destination range,  you only  need to  include one  cell in  each
  3790.                column you want to copy to.
  3791.  
  3792.      Example   If you want  to copy column  A to  columns B through  F, you  can
  3793.                select a destination range  of B1;1..F1;1, or B4;1..F4;1, or  any
  3794.                other range which includes columns B through F.
  3795.  
  3796.  
  3797.      --------------------------------------------------------------------------
  3798.      /Slice Column Move
  3799.      --------------------------------------------------------------------------
  3800.      Function  Move a column's data to another column.
  3801.  
  3802.      Remarks   This command moves the contents of one or more columns to another
  3803.                location.  You will be asked to first define the columns  to move
  3804.                (source columns), and then the destination.   If any of the cells
  3805.                in the  source columns contains  a formula,  then the  references
  3806.                will  be  adjusted  to  continue  to  point  to  the  same  data.
  3807.                References in other  cells which  refer to the  moved cells  will
  3808.                also be adjusted so that they continue to point to the same data.
  3809.  
  3810.                When you define the destination, you only need to supply a single
  3811.                cell address; the  source columns will  be copied with the  first
  3812.                column in the same column as the destination cell.
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.                                           54
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.      --------------------------------------------------------------------------
  3838.      /Slice Row Insert
  3839.      --------------------------------------------------------------------------
  3840.      Function  Insert one or more blank rows.
  3841.  
  3842.      Remarks   This command inserts  one or more blank rows at  the current cell
  3843.                pointer position.  The current row and all the rows below will be
  3844.                shifted  down  to  make  room  for  the  blank  rows.    Relative
  3845.                references  in formulas will  be updated by  the change; absolute
  3846.                references will remain  unchanged.   You will be  asked how  many
  3847.                blank rows you  want to insert.  You may also  use the arrow keys
  3848.                to highlight the number of rows that should be inserted.
  3849.  
  3850.  
  3851.      --------------------------------------------------------------------------
  3852.      /Slice Row Delete
  3853.      --------------------------------------------------------------------------
  3854.      Function  Delete one or more rows.
  3855.  
  3856.      Remarks   This command deletes one or more rows at the current cell pointer
  3857.                position.  The contents of the  deleted rows will be erased,  and
  3858.                all of the rows below will  be shifted up to fill in the  deleted
  3859.                rows.  Relative  references in  formulas will be  updated by  the
  3860.                change; absolute references  will remain unchanged.   You will be
  3861.                asked how many  rows you want to  delete.  You  may also use  the
  3862.                arrow keys to highlight the rows that should be deleted.
  3863.  
  3864.  
  3865.      --------------------------------------------------------------------------
  3866.      /Slice Row Erase
  3867.      --------------------------------------------------------------------------
  3868.      Function  Erase the contents of a row of cells.
  3869.  
  3870.      Remarks   This command erases  the contents  of all  the cells  in the  row
  3871.                which  the cell pointer is in.   This is important, since editing
  3872.                each cell in the row using the <F2> Edit key will  not completely
  3873.                blank the row; the  cells in the row will still  be using memory.
  3874.                The cells in the row will retain their formatting; for example, a
  3875.                row formatted for percent will still be formatted for percent.
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.                                           55
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.      --------------------------------------------------------------------------
  3904.      /Slice Row Copy
  3905.      --------------------------------------------------------------------------
  3906.      Function  Copy a row's contents to another row or rows.
  3907.  
  3908.      Remarks   This command copies the contents of one or more rows of  cells to
  3909.                another location.  You  will first be asked to define  the row or
  3910.                rows you want  to copy (source  rows), and then the  location you
  3911.                want to copy to (destination).
  3912.  
  3913.                If the  destination you define is  a single row, the  source rows
  3914.                will be copied  starting at  that location.   If the  destination
  3915.                contains more than one row, the source row will be copied to each
  3916.                of the destination  rows.  If any  of the source cells  contain a
  3917.                formula,  all  relative  references  will  be adjusted  when  the
  3918.                formula is copied.
  3919.  
  3920.                Because ProQube Lite  only looks  at the row  coordinates in  the
  3921.                destination range, you only need to include one cell in  each row
  3922.                you want to copy to.
  3923.  
  3924.      Example   If you want to copy row 1 to rows  2 through 10, you can select a
  3925.                destination range of  A2;1..A10;1, or  F2;1..F10;1, or any  other
  3926.                range which includes rows 2 through 10.
  3927.  
  3928.  
  3929.      --------------------------------------------------------------------------
  3930.      /Slice Row Move
  3931.      --------------------------------------------------------------------------
  3932.      Function  Move a row's contents to another row.
  3933.  
  3934.      Remarks   This command moves  the contents of one  or more rows  to another
  3935.                location.   You will  be asked to  first define the  rows to move
  3936.                (source rows), and then the destination.   If any of the cells in
  3937.                the source rows contains  a formula, then the references  will be
  3938.                adjusted to continue to  point to the  same data.  References  in
  3939.                other cells  which refer to the moved cells will also be adjusted
  3940.                so that they continue to point to the same data.
  3941.  
  3942.                When you define the destination, you only need to supply a single
  3943.                cell address;  the source rows will be  copied with the first row
  3944.                in the same row as the destination cell.
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.                                           56
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.      --------------------------------------------------------------------------
  3970.      /Slice Page Insert
  3971.      --------------------------------------------------------------------------
  3972.      Function  Insert one or more blank pages.
  3973.  
  3974.      Remarks   This command inserts one or more  blank pages at the current cell
  3975.                pointer position.  The current page and all the pages behind will
  3976.                be shifted  back to  make  room for  the blank  pages.   Relative
  3977.                references  in formulas will  be updated by  the change; absolute
  3978.                references will remain  unchanged.   You will be  asked how  many
  3979.                blank pages you want to insert.  You may also use the arrow  keys
  3980.                to highlight the number of pages that should be inserted.
  3981.  
  3982.  
  3983.      --------------------------------------------------------------------------
  3984.      /Slice Page Delete
  3985.      --------------------------------------------------------------------------
  3986.      Function  Delete one or more pages.
  3987.  
  3988.      Remarks   This  command  deletes one  or  more  pages at  the  current cell
  3989.                pointer position.   The  contents of  the deleted  pages will  be
  3990.                erased, and  all of the pages  behind will be shifted  forward to
  3991.                fill in the deleted pages.   Relative references in formulas will
  3992.                be  updated  by  the  change;  absolute  references  will  remain
  3993.                unchanged.  You will be asked how  many pages you want to delete.
  3994.                You  may also  use the  arrow keys  to  highlight the  pages that
  3995.                should be deleted.
  3996.  
  3997.  
  3998.      --------------------------------------------------------------------------
  3999.      /Slice Page Erase
  4000.      --------------------------------------------------------------------------
  4001.      Function  Erase a page of cells.
  4002.  
  4003.      Remarks   This command erases the contents of all the cells  in the current
  4004.                page.   This is  important, since editing  each cell in  the page
  4005.                using the <F2> Edit key  will not completely blank the  page; the
  4006.                cells  in the  page will still  be using  memory.  The  page will
  4007.                retain its formatting; for example, a page  formatted for percent
  4008.                will still be formatted for percent.
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.                                           57
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.      --------------------------------------------------------------------------
  4036.      /Slice Page Copy
  4037.      --------------------------------------------------------------------------
  4038.      Function  Copy data in a page to one or more pages.
  4039.  
  4040.      Remarks   This command copies the contents of  one or more pages to another
  4041.                location.  You  will first be asked  to define the page  or pages
  4042.                you want  to copy (source pages), and  then the location you want
  4043.                to copy to (destination).
  4044.  
  4045.                If the destination you define is  a single page, the source pages
  4046.                will be copied  starting at  that location.   If the  destination
  4047.                contains more  than one page,  the source page will  be copied to
  4048.                each of  the  destination pages.    If any  of  the source  cells
  4049.                contain a formula, all relative  references will be adjusted when
  4050.                the formula is copied.
  4051.  
  4052.                Because ProQube Lite  only looks at  the page coordinates in  the
  4053.                destination range, you only need to include one cell in each page
  4054.                you want to copy to.
  4055.  
  4056.      Example   If you want to copy page 1 to pages 2 through 4, you can select a
  4057.                destination range of  A1;2..A1;4, or  F12;2..F12;4, or any  other
  4058.                range which includes pages 2 through 4.
  4059.  
  4060.  
  4061.      --------------------------------------------------------------------------
  4062.      /Slice Page Move
  4063.      --------------------------------------------------------------------------
  4064.      Function  Move data in a page to another page.
  4065.  
  4066.      Remarks   This command moves the contents of  one or more pages to  another
  4067.                location.  You  will be asked to  first define the pages  to move
  4068.                (source pages), and then the destination.  If any of the cells in
  4069.                the source pages contains a formula,  then the references will be
  4070.                adjusted to continue to  point to the  same data.  References  in
  4071.                other cells  which refer to the moved cells will also be adjusted
  4072.                so that they continue to point to the same data.
  4073.  
  4074.                When you define the destination, you only need to supply a single
  4075.                cell address; the source pages will be copied with the first page
  4076.                in the same page as the destination cell.
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                           58
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.      --------------------------------------------------------------------------
  4102.      /Slice Page Format
  4103.      --------------------------------------------------------------------------
  4104.      Function  Format a page of cells.
  4105.  
  4106.      Remarks   This command allows you to select  a format for the current page.
  4107.                A page may  individually be  using one format,  while the  global
  4108.                format is set differently.
  4109.  
  4110.      Options   General,  Currency,  Fixed,  Percent,   Scientific,  Time,  Date,
  4111.                Hidden, Label, and Reset.
  4112.  
  4113.  
  4114.  
  4115.      --------------------------------------------------------------------------
  4116.      /WorkQube Format
  4117.      --------------------------------------------------------------------------
  4118.      Function  Set the global default format.
  4119.  
  4120.      Remarks   This  command allows you to choose a global format for the entire
  4121.                WorkQube.  When the  WorkQube Format is changed, all  cells which
  4122.                use the default  format will be  displayed with the new  WorkQube
  4123.                format.  Otherwise,  this command does  not affect the format  of
  4124.                cells which already contain data; it only determines which format
  4125.                will be  used  for blank  cells  which may  contain  data in  the
  4126.                future.
  4127.  
  4128.      Options   General,  Currency,  Fixed,  Percent,   Scientific,  Time,  Date,
  4129.                Hidden, and Label.
  4130.  
  4131.  
  4132.  
  4133.      --------------------------------------------------------------------------
  4134.      /WorkQube Width
  4135.      --------------------------------------------------------------------------
  4136.      Function  Set the global default width.
  4137.  
  4138.      Remarks   This  command allows you to set the  default width of all columns
  4139.                in the  WorkQube.  This command is often  used when the values in
  4140.                an entire  WorkQube are  expected  to exceed  the default  column
  4141.                width,  and  the telltale  row of  asterisks  would appear.   The
  4142.                situation  is easily  corrected by  widening the  columns in  the
  4143.                WorkQube.  You  will be prompted to  enter the new  global column
  4144.                width.  You may either enter  a number, or use the arrow  keys to
  4145.                change the width.   <Left>  will narrow the  column, and  <Right>
  4146.                will widen the column.
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.                                           59
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.      --------------------------------------------------------------------------
  4168.      /WorkQube Erase
  4169.      --------------------------------------------------------------------------
  4170.      Function  Erase the entire 3D worksheet from memory.
  4171.  
  4172.      Remarks   This command  erases the  current  WorkQube's contents  entirely.
  4173.                All of the WorkQube settings are restored to their defaults.  You
  4174.                will be asked  to confirm whether  you really want  to erase  the
  4175.                worksheet.
  4176.  
  4177.      Options   Yes  Erase the Worksheet from memory.
  4178.                No   Don't erase the Worksheet from memory.
  4179.  
  4180.  
  4181.  
  4182.      --------------------------------------------------------------------------
  4183.      /WorkQube Justify
  4184.      --------------------------------------------------------------------------
  4185.      Function  Set the global default text justification.
  4186.  
  4187.      Remarks   This  command  allows you  to  change  the way  text  strings are
  4188.                displayed in  each cell of the  WorkQube.  This command  will not
  4189.                change  they  way existing  text cells  are  justified.   It only
  4190.                determines how text entered in the future will be displayed.  The
  4191.                command has three options:
  4192.  
  4193.      Options   Left      Justifies text in cells  to the left edge of  the cell.
  4194.                          When a label  is entered, it  will appear beginning  in
  4195.                          the leftmost character of the cell.
  4196.  
  4197.                Right     Justifies text in cells to the  right edge of the cell.
  4198.                          When a label is entered, it  will appear flush right in
  4199.                          the cell.
  4200.  
  4201.                Center    Justifies  text in  cells  to the  center of  the cell.
  4202.                          When a label is entered, it will appear centered in the
  4203.                          cell.
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.                                           60
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.  
  4233.      --------------------------------------------------------------------------
  4234.      /WorkQube View
  4235.      --------------------------------------------------------------------------
  4236.      Function  View the 3D worksheet from other perspectives.
  4237.  
  4238.      Remarks   ProQube Lite allows you to view, enter or manipulate your data in
  4239.                any of the six faces of the WorkQube.
  4240.  
  4241.                The current face  is shown in the  upper left corner in  front of
  4242.                the current cell name (like [Front]).   The view of the  WorkQube
  4243.                may be changed using the /WorkQube View command.
  4244.  
  4245.      Options   Front     The WorkQube is viewed from the front.
  4246.                Right     The WorkQube is viewed from the right side.
  4247.                Top       The WorkQube is viewed from the top.
  4248.                Back      The WorkQube is viewed from the back.
  4249.                Left      The WorkQube is viewed from the left side.
  4250.                Under     The WorkQube is viewed from the bottom.
  4251.  
  4252.      Example   For an example of how the various views can be used, see Changing
  4253.                The View in ProQube Lite Basics.
  4254.  
  4255.  
  4256.      --------------------------------------------------------------------------
  4257.      /WorkQube Title
  4258.      --------------------------------------------------------------------------
  4259.      Function  Lock title rows and columns on the screen.
  4260.  
  4261.      Remarks   This  command allows you  to lock (or  hold) rows  and columns on
  4262.                screen.   The command acts as a toggle;  invoking it a first time
  4263.                turns the title locking  ON, and invoking it a  second time turns
  4264.                the title locking OFF.
  4265.  
  4266.                With title locking  ON, the rows above  the current cell and  the
  4267.                columns to the left of the current cell will be locked on screen.
  4268.                The  cell pointer will  not move into  the locked title  rows and
  4269.                columns.  Pages which lie below the  page where you set the title
  4270.                locking ON will also be inaccessible.
  4271.  
  4272.                If you  don't want to lock rows, make sure the cell pointer is in
  4273.                row 1 when  you title lock.   If you don't want  to lock columns,
  4274.                make sure  the cell pointer is in  column  A when you title lock.
  4275.                If you don't want to lock pages, make sure the cell pointer is in
  4276.                page 1 when you title lock.
  4277.  
  4278.                Each face may be locked individually.
  4279.  
  4280.      Example   If you  turn on title locking with the  cell pointer in cell D5;3
  4281.                then the rows on  the screen above row  5 and the columns  on the
  4282.                screen to the left of column D will be locked on the  screen.  In
  4283.                addition, you will be unable  to move the cell pointer back  past
  4284.                page 3.
  4285.  
  4286.                                           61
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.      --------------------------------------------------------------------------
  4300.      /WorkQube Protect
  4301.      --------------------------------------------------------------------------
  4302.      Function  Enable or disable cell protection.
  4303.  
  4304.      Remarks   This command enables or disables  the protection in the WorkQube.
  4305.                When  the  WorkQube  protection  is  disabled, any  cell  in  the
  4306.                WorkQube  may be  modified,  regardless of  whether  the cell  is
  4307.                protected or not.  When the WorkQube protection is enabled, those
  4308.                cells  which are  protected using  the cell  or  block protection
  4309.                commands may not be modified or altered in any way.
  4310.  
  4311.      Options   Enable         Turns WorkQube protection on.
  4312.                Disable        Turns WorkQube protection off.
  4313.  
  4314.  
  4315.  
  4316.      --------------------------------------------------------------------------
  4317.      /WorkQube Setup
  4318.      --------------------------------------------------------------------------
  4319.      Function  Select the global print setup string.
  4320.  
  4321.      Remarks   This command allows you to select a  setup string for the current
  4322.                WorkQube  (for printing--the  style will  not change  on-screen).
  4323.                The   WorkQube  setup   string   affects  the   entire  printout.
  4324.                Individual cells or  blocks may use  other fonts by invoking  the
  4325.                Cell Setup or Block Setup commands.
  4326.  
  4327.      Options   The  options  depend on  the  printer  driver.   If  your printer
  4328.                supports boldfacing,  underlining, italics, and  condensed print,
  4329.                your options would include those choices.
  4330.  
  4331.                If, for example,  your printer allows italics,  "Italics" can one
  4332.                of the option choices.   To change the WorkQube's global  font to
  4333.                italic, issue the command /WorkQube Setup and select Italics from
  4334.                the menu.
  4335.  
  4336.                In order to use the /WorkQube Setup command, you must first enter
  4337.                setup strings  for  your printer  using  the /Print  Setup  Fonts
  4338.                command.
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.                                           62
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.      --------------------------------------------------------------------------
  4366.      /WorkQube Zero
  4367.      --------------------------------------------------------------------------
  4368.      Function  Suppress the display of zeros.
  4369.  
  4370.      Remarks   This command  allows you  to suppress  the display  of all  cells
  4371.                which have a  value of zero.   There are many times  when a large
  4372.                number of  formulas in a  worksheet evaluate to  zero, especially
  4373.                when the  worksheet is  only partially  filled with  data.   Many
  4374.                times it is  advantageous to suppress the display of all of these
  4375.                zeros to make non zero values stand out more.
  4376.  
  4377.      Options   No   Don't suppress the display of zeros.
  4378.                Yes  Suppress the display of zeros.
  4379.  
  4380.  
  4381.  
  4382.      --------------------------------------------------------------------------
  4383.      /WorkQube Calc
  4384.      --------------------------------------------------------------------------
  4385.      Function  Select recalculation options.
  4386.  
  4387.      Remarks   This  command allows  you to  select whether ProQube  Lite should
  4388.                recalculate the WorkQube after any cell  is changed, or only when
  4389.                the <F9> Recalc  key is pressed.  Very  complex worksheets with a
  4390.                large number of inter-related formulas can often take a long time
  4391.                to recalculate.    Since  any  delay  can  become  annoying  when
  4392.                entering a large amount of data, it is often desirable to be able
  4393.                to turn off automatic recalculation.
  4394.  
  4395.      Options   Auto      Recalculate the  cells which  need recalculation  after
  4396.                          any cell is changed.
  4397.  
  4398.                Manual    Only recalculate the worksheet when the <F9> Recalc key
  4399.                          is  pressed.    Since the  recalculation  state  of the
  4400.                          worksheet  will usually  not be  current,  ProQube Lite
  4401.                          will write the word CALC in the upper right corner when
  4402.                          the worksheet needs to be recalculated.
  4403.  
  4404.                Limited   Allows you to limit recalculation to a block of  cells.
  4405.                          You will be asked to define a range (or block) of cells
  4406.                          which  should  be recalculated  instead  of  the entire
  4407.                          worksheet.  This is useful, for  example, when you only
  4408.                          want the  current page to  recalculate, and not  all of
  4409.                          the previous pages.
  4410.  
  4411.                Full      Restores recalculation to the entire worksheet.
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.                                           63
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.      --------------------------------------------------------------------------
  4432.      /File Retrieve
  4433.      --------------------------------------------------------------------------
  4434.      Function  Retrieves a 3D worksheet from disk.
  4435.  
  4436.      Remarks   This command retrieves a file from disk into memory.  You will be
  4437.                asked for  the name of  the file to retrieve.   If you  press the
  4438.                <Enter> key without  a file name,  the ProQube Lite file  manager
  4439.                will appear,  from which you  may select a  file with the  cursor
  4440.                keys.  When  a file is  read in, all of  the data, settings,  and
  4441.                current face and pointer position are loaded.
  4442.  
  4443.                All current data will  be cleared from memory when a  new file is
  4444.                loaded.  ProQube  Lite checks to see if you have made any changes
  4445.                to the current file,  and will ask if you want  to save your data
  4446.                before loading the new file.
  4447.  
  4448.      Options   A file can  be loaded immediately  upon booting up ProQube  Lite.
  4449.                If you  want to  start  up with  the file  named EXAMPLE  loaded,
  4450.                simply enter 
  4451.  
  4452.                PQLITE EXAMPLE<Enter>
  4453.  
  4454.                at the DOS prompt.
  4455.  
  4456.  
  4457.  
  4458.      --------------------------------------------------------------------------
  4459.      /File Save
  4460.      --------------------------------------------------------------------------
  4461.      Function  Saves the 3D worksheet in memory to disk.
  4462.  
  4463.      Remarks   This command asks  you for a name  to save the WorkQube  as, then
  4464.                proceeds  to  save the  file to  disk  in the  current directory.
  4465.                Pressing  the  <Enter> key  without  a  file name  brings  up the
  4466.                ProQube Lite File Manager, from which a file may be selected with
  4467.                the cursor  keys.   In  addition to  data,  all of  the  WorkQube
  4468.                settings are saved to disk.
  4469.  
  4470.                If  the  file name  you  provide  already exists  in  the current
  4471.                directory,  ProQube  Lite  will  ask  you  whether  you  want  to
  4472.                overwrite  the existing  file,  or back  it  up.   If  you select
  4473.                Backup, the extension of the existing file's name will be changed
  4474.                from .PQS  to .BAK, and  the current  file will receive  the .PQS
  4475.                extension.
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.                                           64
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.      --------------------------------------------------------------------------
  4498.      /File Directory
  4499.      --------------------------------------------------------------------------
  4500.      Function  Changes the current directory.
  4501.  
  4502.      Remarks   This command allows you to change the current directory or drive.
  4503.                You may enter either a full DOS pathname or simply a subdirectory
  4504.                name  to  be appended  to the  current  directory.   Pressing the
  4505.                <Enter> key without a  file name brings up the  ProQube Lite File
  4506.                Manager, from which a  directory may be selected with  the cursor
  4507.                keys.
  4508.  
  4509.      Example   If the current directory is B:\dir1, then entering:
  4510.  
  4511.                C:             switches to the active directory on drive C:
  4512.  
  4513.                C:\            switches to the root directory on drive C:
  4514.  
  4515.                C:\dir2        switches to dir2 on drive C:
  4516.  
  4517.                dir2           switches to B:\dir1\dir2 (if dir2 exists)
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.                                           65
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.      --------------------------------------------------------------------------
  4564.      /File Files
  4565.      --------------------------------------------------------------------------
  4566.      Function  Brings up the ProQube Lite File Manager.
  4567.  
  4568.      Remarks   This  command  presents a  File  Manager, and  allows "point-and-
  4569.                shoot" operations on files, directories, and drives.
  4570.  
  4571.                You will  be asked to enter  a mask.  A  mask is simply  a way of
  4572.                telling ProQube Lite which files you  want to be displayed.   You
  4573.                may use the asterisk * in the mask.  The asterisk will match  any
  4574.                set of characters.   For example,  if you  enter the mask  *.BAK,
  4575.                then the file manager will list every file which  ends with .BAK.
  4576.                If you enter  the mask Q*.*, then all of the files beginning with
  4577.                the letter  Q will be displayed.   Pressing <Enter>  will use the
  4578.                Mask *.*,  which will  display all  of the  files in the  current
  4579.                directory.
  4580.  
  4581.      Options   <Up> <Down>    Using these keys, you can highlight files, drives,
  4582.                               or directories (depending on what area of the file
  4583.                               manager the highlighted  bar is  in).   Operations
  4584.                               can then be performed on the selected file, drive,
  4585.                               or directory.
  4586.  
  4587.                <Left> <Right> Allows   you   to   change   files,   drives,   or
  4588.                               directories.  If, for example, the highlighted bar
  4589.                               is in the "Directory" section of the file manager,
  4590.                               and you wanted to change  drives, hitting the left
  4591.                               arrow  key  will  move the  bar  into  the "Drive"
  4592.                               section.  A new drive may be selected by using the
  4593.                               down arrow and Enter keys.
  4594.  
  4595.                <Enter>        Causes the  highlighted file, drive,  or directory
  4596.                               to be selected.
  4597.  
  4598.                <F1>           Causes a Help screen to appear, giving help on how
  4599.                               to use the File Manager.
  4600.  
  4601.                <F2>           Causes  the  currently   highlighted  file  to  be
  4602.                               loaded.
  4603.  
  4604.                <F3>           Causes the highlighted  file to be combined.   For
  4605.                               more details see /File Combine.
  4606.  
  4607.                <F4>           Causes the highlighted  file to be imported.   For
  4608.                               more details see /File Import.
  4609.  
  4610.                <F5>           Allows you to edit the contents of the highlighted
  4611.                               text  file.   Although  the  macro editor  will be
  4612.                               used, you are  not limited  to editing just  macro
  4613.                               (.PQM) files.  See /Macro  Edit for details on the
  4614.                               options available when editing.
  4615.  
  4616.                                           66
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.                <F6>           Causes  the highlighted text  file to  be printed.
  4631.                               This  function  is   primarily  for  printing  out
  4632.                               application programs.
  4633.  
  4634.                <F7>           Causes the  highlighted file  to run,  if it  is a
  4635.                               program or  batch file,  and if  enough memory  is
  4636.                               available.
  4637.  
  4638.                <F8>           Allows you to  rename the  highlighted file.   You
  4639.                               will be prompted for a new name.
  4640.  
  4641.                <F9>           Copies  the  highlighted  file  to another  drive,
  4642.                               directory, or  name.  You  will be prompted  for a
  4643.                               new drive, directory, or name.
  4644.  
  4645.                <F10>          Deletes the  highlighted file.  ProQube  Lite will
  4646.                               request confirmation before actually  deleting the
  4647.                               file.
  4648.  
  4649.                <^F1>          Displays  the  description  for   the  highlighted
  4650.                               worksheet  file.   This allows you  to find  out a
  4651.                               little  information  about  a   worksheet  without
  4652.                               having to load it into memory first.
  4653.  
  4654.                <^F2>          Scans the  current drive  to update  the directory
  4655.                               tree.
  4656.  
  4657.                The File Manager also simplifies the tasks of changing drives and
  4658.                directories.   To change  to another directory,  simply press the
  4659.                <Left>  key to highlight the  word DIRECTORIES at  the top of the
  4660.                screen, then use the <Up> and  <Down> keys to highlight the  name
  4661.                of the  directory  you want  to  change to.    Once the  name  is
  4662.                highlighted, press the <Enter>  key and ProQube Lite  will change
  4663.                to that directory and list the files in that directory.
  4664.  
  4665.                Changing  drives is  just as easy.   Simply press  the <Left> key
  4666.                until the word  DRV is highlighted at the top of the screen, then
  4667.                press the  letter  of the  drive  you want  to  change to.    For
  4668.                example, if you want to change to drive A:, then just press A.
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.                                           67
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.      --------------------------------------------------------------------------
  4696.      /File Combine
  4697.      --------------------------------------------------------------------------
  4698.      Function  Combines all or part of a 3D worksheet on disk with the worksheet
  4699.                currently in memory.
  4700.  
  4701.      Remarks   This command allows  you to  combine several  ProQube Lite  files
  4702.                into a  single file.  You will be asked  for the name of the file
  4703.                to be  read in, and the file will  be loaded without clearing the
  4704.                WorkQube.  Pressing the <Enter> key without a file name brings up
  4705.                the ProQube Lite File Manager, from  which a file may be selected
  4706.                with the cursor keys.   The original cells will  remain unchanged
  4707.                unless the new file contains data in the same cells.  Blank cells
  4708.                in the new  file will not affect existing  cells in the WorkQube.
  4709.                Current WorkQube settings will be retained.
  4710.  
  4711.      Options   Copy      The data  in the  new file  will be  combined into  the
  4712.                          current  WorkQube.   If the  new  file and  the current
  4713.                          WorkQube contain any data in the same cell, the data in
  4714.                          the new file  will be copied  over the data already  in
  4715.                          memory.
  4716.  
  4717.                Add       The data  in the  new file  will be  combined into  the
  4718.                          current  WorkQube.   If the  new file  and the  current
  4719.                          WorkQube contain values in the same  cell, the value in
  4720.                          the new  file will  be added  to the  value already  in
  4721.                          memory.     Since  this   command   is  primarily   for
  4722.                          consolidating  data  from  several   worksheets,  cells
  4723.                          containing text will  not be combined into  the current
  4724.                          file.
  4725.  
  4726.                Subtract  The data  in the  new file  will be  combined into  the
  4727.                          current  WorkQube.   If the  new file  and the  current
  4728.                          WorkQube contain values in the same  cell, the value in
  4729.                          the new file will be subtracted from the  value already
  4730.                          in  memory.    Since  this  command  is  primarily  for
  4731.                          consolidating  data  from  several   worksheets,  cells
  4732.                          containing text will  not be combined into  the current
  4733.                          file.
  4734.  
  4735.                Each of these options has two suboptions which determine how much
  4736.                of the new file should be combined in.
  4737.  
  4738.                All       Combines in the  entire file.   Every cell  in the  new
  4739.                          file will  be combined  into the same  location in  the
  4740.                          current WorkQube.   For  example, cell  X23;46 will  be
  4741.                          combined into cell X23;46 in the current worksheet.
  4742.  
  4743.                Part      Combines in a block  from the file.   The cells in  the
  4744.                          block you combine in  will be combined starting at  the
  4745.                          location of the cell pointer.  For example, if the cell
  4746.                          pointer is in cell  D5;3, and you combine in  the block
  4747.  
  4748.                                           68
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.                          A1;1..D12;4 from the  other file, then cell A1;1 in the
  4762.                          new file will be combined into cell D5;3 in the current
  4763.                          worksheet.
  4764.  
  4765.                          You will be asked for the block in the other file which
  4766.                          you  want to  combine in.   If  you type  in the  block
  4767.                          reference  like  A1;1..F12;4, it  is very  important to
  4768.                          remember the page numbers.
  4769.  
  4770.                          If the block  you want to combine in was named with the
  4771.                          /Block Name command,  you can press the  <F3> Block key
  4772.                          to bring up a menu of all the named blocks in the other
  4773.                          file.
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.                                           69
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.      --------------------------------------------------------------------------
  4828.      /File Xtract
  4829.      --------------------------------------------------------------------------
  4830.      Function  Saves part of the 3D worksheet in memory to disk.
  4831.  
  4832.      Remarks   This command is similar to the /File Save command, except that it
  4833.                saves a block of cells rather than the entire WorkQube.  You will
  4834.                be asked  for the name of the file to  save to, and to define the
  4835.                block of  cells to save.  ProQube Lite  saves all of the WorkQube
  4836.                settings with the saved block.   Pressing the <Enter> key without
  4837.                a file name brings up the ProQube Lite File Manager, from which a
  4838.                file may be selected with the cursor keys.
  4839.  
  4840.                This  command  is useful  for extracting  single  pages out  of a
  4841.                larger 3D worksheet, so that  it may be combined into  another 3D
  4842.                worksheet with the /File Combine command.
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.                                           70
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.      --------------------------------------------------------------------------
  4894.      /File Import
  4895.      --------------------------------------------------------------------------
  4896.      Function  Imports data  from 1-2-3,  dBase, DIF,  or ASCII  files into  the
  4897.                current page.
  4898.  
  4899.      Remarks   This command imports data files from  other programs into ProQube
  4900.                Lite.   The file is imported onto the  current page.  You will be
  4901.                asked for  the name  of the  file  to import.   Pressing  <Enter>
  4902.                without a file name brings up the ProQube Lite File Manager, from
  4903.                which a file may be selected with the cursor keys.
  4904.  
  4905.      Options   1-2-3     Imports a Lotus 1-2-3 (tm) file into the current  page.
  4906.                          If  ProQube  Lite encounters  a  formula which  uses an
  4907.                          unsupported @function, it  will read  the value of  the
  4908.                          formula rather than the formula itself.
  4909.  
  4910.                          If  the  1-2-3 file  contains  more  than  512 rows,  a
  4911.                          message will appear and  you will be asked if  you want
  4912.                          to Truncate the  imported data at  512 rows, or if  you
  4913.                          want to Wrap the remaining rows onto subsequent pages.
  4914.  
  4915.                dBase     Imports selected records  from a  dBase (tm) file  into
  4916.                          the current page.   Fields will appear  as columns, and
  4917.                          records will appear as rows.  You do not have to import
  4918.                          every field  of  the  data  base.   Before  the  import
  4919.                          begins, ProQube  Lite will  step through  the names  of
  4920.                          each field and  ask if you  want to import that  field.
  4921.                          You may select:
  4922.  
  4923.                          Yes  Import this field.
  4924.                          No   Don't import this field.
  4925.                          All  Import this and all the remaining fields.
  4926.  
  4927.                          If  there  are   more  than  511  records   to  import,
  4928.                          additional records  will be imported into the following
  4929.                          pages.
  4930.  
  4931.                DIF       Imports a Data  Interchange Format (DIF) file  into the
  4932.                          current  page.   Many  databases  and spreadsheets  are
  4933.                          capable of creating DIF files.
  4934.  
  4935.                          If  the  DIF  file  contains  more  than  511  records,
  4936.                          additional records will be imported into  the following
  4937.                          pages.
  4938.  
  4939.                ASCII     Imports a comma delimited or space delimited ASCII file
  4940.                          into the current  page.   Each line in  the ASCII  file
  4941.                          will be imported  into a  row in the  worksheet.   Each
  4942.                          line may contain multiple fields  (cells) of data, each
  4943.                          of which  must be separated by a comma  or space.  If a
  4944.                          string  which  contains  spaces  or  commas  is  to  be
  4945.  
  4946.                                           71
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.                          imported  into a single cell,  then that string must be
  4960.                          surrounded by quotation marks ".  For example:
  4961.  
  4962.                          ASCII line read in  Translated like this
  4963.                          1,2,3,4,5      Each number in a separate cell
  4964.                          1 2 3 4 5      Each number in a separate cell
  4965.                          Hello and Goodbye   Each word in a separate cell
  4966.                          Hello,and,Goodbye   Each word in a separate cell
  4967.                          "Hello and Goodbye" Entire line in a single cell
  4968.                          "Hello,and,Goodbye" Entire line in a single cell
  4969.                          Hello 23       Word and number in separate cells
  4970.                          Hello,23       Word and number in separate cells
  4971.                          "1 2 3 4 5"         Entire line in a single cell
  4972.                          "1,2,3,4,5"         Entire line in a single cell
  4973.                          "Hello 23"          Entire line in a single cell
  4974.  
  4975.                          If  the  ASCII  file  contains  more  than  511  lines,
  4976.                          additional lines  will be imported  into the  following
  4977.                          pages.
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.                                           72
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.      --------------------------------------------------------------------------
  5026.      /File Export
  5027.      --------------------------------------------------------------------------
  5028.      Function  Exports part of the current page to a 1-2-3, dBase, DIF, or ASCII
  5029.                file.
  5030.  
  5031.      Remarks   This command  exports  a range  of cells  to the  file format  of
  5032.                another program.  You will be asked for the file name you want to
  5033.                export to,  and to define the range of  cells you want to export.
  5034.                If the file name you provide exists, ProQube Lite will ask you if
  5035.                you want to Overwrite the existing file or Cancel the operation.
  5036.  
  5037.      Options   1-2-3     This option allows you  to export the range to  a 1-2-3
  5038.                          R1 (WKS) or R2 (WK1) file.  You must select from a menu
  5039.                          which version you want to export  to.  Any ProQube Lite
  5040.                          formula  which  references a  cell  in another  page or
  5041.                          which  contains   an  @function  which   1-2-3  doesn't
  5042.                          support,  will be  exported as  a  value rather  than a
  5043.                          formula.
  5044.  
  5045.                dBASE     This option allows you  to export the range to  a dBase
  5046.                          II, III,  or III+ file.   You  must select from  a menu
  5047.                          which version you want to export to.
  5048.  
  5049.                          ProQube Lite  will use  the top  row of  the range  you
  5050.                          define as the field names for  the data to be exported.
  5051.                          The widths of  each column  will be used  as the  field
  5052.                          width in the  dBase file.   For example, if you  select
  5053.                          the  range  A3;1..C9;1 below  as  the range  to export,
  5054.                          ProQube Lite will use Name, Division, and  Sales as the
  5055.                          field names for the data in their columns.
  5056.  
  5057.  
  5058.                          1      A                 B           C
  5059.                            1 1988 Sales
  5060.                            2
  5061.                            3 Name            Division       Sales
  5062.                            4 Joe Smith       West           1049354
  5063.                            5 Bill Jones      Southwest      1345938
  5064.                            6 Dave Adams      South          1234823
  5065.                            7 Don Nielson     Midwest         934834
  5066.                            8 Sam Davis       Southeast      1834735
  5067.                            9 Jim Turner      Northeast      1634868
  5068.  
  5069.                          Before  the actual  export is  performed, ProQube  Lite
  5070.                          will step through each field name and ask you what type
  5071.                          of field it should be.  The available field types are:
  5072.  
  5073.                          Character      The values in the field are text.
  5074.  
  5075.                          Number         The values in the field are numbers.
  5076.  
  5077.  
  5078.                                           73
  5079.  
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089.  
  5090.  
  5091.                          Logical        The  values  in  the field  are  TRUE or
  5092.                                         FALSE.
  5093.  
  5094.                          Date           The values in the field are dates.  This
  5095.                                         option is available only when you export
  5096.                                         to dBase III or III+.
  5097.  
  5098.  
  5099.                DIF       The  file will be exported in the DIF (Data Interchange
  5100.                          Format) format.
  5101.  
  5102.                ASCII     The  file will be  exported to a  comma delimited ASCII
  5103.                          file.  Each row of the range will be on a separate line
  5104.                          of the ASCII file,  and the value  of each cell in  the
  5105.                          row will be separated by  a comma.  Text items  will be
  5106.                          surrounded by quotes ".
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.                                           74
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.      --------------------------------------------------------------------------
  5158.      /File Link
  5159.      --------------------------------------------------------------------------
  5160.      Function  Link to a .PQS file on disk.
  5161.  
  5162.      Remarks   This  command  allows  you  to   link  multiple  3D  spreadsheets
  5163.                together.  You are not limited to linking a single cell.  You may
  5164.                link  to  an  entire   three-dimensional  block  within   another
  5165.                spreadsheet.
  5166.  
  5167.                The current cell  will contain the link.  If you change the value
  5168.                of  the  cell in  the other  spreadsheet,  this "link  cell" will
  5169.                change accordingly.
  5170.  
  5171.                If you  create a link  to a block of  cells in another  file, the
  5172.                link cell will  take on the same value  as the cell in  the upper
  5173.                left corner  of the block in  the other file.   The cells  to the
  5174.                right of  and below  the link  cell will  take on  the values  of
  5175.                corresponding cells from the other file.
  5176.  
  5177.                If  a change  is made to  any of  the linked  cells in  the other
  5178.                worksheet, the current worksheet will be updated to reflect those
  5179.                changes.
  5180.  
  5181.                Each time you retrieve a file which is linked to other files, you
  5182.                will be  asked if you want  to update all  of the links.   If you
  5183.                select Yes then ProQube  Lite will update every link in the file.
  5184.                If you select  No then ProQube  Lite will not  update any of  the
  5185.                links in the file.
  5186.  
  5187.                If none of the files which were linked to have been changed, then
  5188.                selecting No can greatly speed up the retrieval of the file.
  5189.  
  5190.                If  your file has a large number of  links in it, but only one of
  5191.                the links needs to be updated, you should select No, and then use
  5192.                the /File Link Update command to update the single link.
  5193.  
  5194.      Options   Create         Create or  edit a  link to  another 3D  worksheet.
  5195.                               You will be asked for two items.
  5196.  
  5197.                               - The name of the file  you want to link to.   The
  5198.                               file must already be in existence.
  5199.  
  5200.                               -  The  name of  the block  you  want to  link to.
  5201.                               Pressing <F3> will  allow you to pick from  a list
  5202.                               of all the named blocks in  the other file.  While
  5203.                               the program  accepts cell and block  addresses, it
  5204.                               is  best  to  use  a  block name;  otherwise,  the
  5205.                               reference may be modified in the other file (as by
  5206.                               an addition or deletion  of a row or column),  and
  5207.                               the link may be disturbed.
  5208.  
  5209.  
  5210.                                           75
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.                Delete         Delete an existing link  to another 3D  worksheet.
  5224.                               A menu of all existing  links will appear, and you
  5225.                               may pick the link you want to delete.
  5226.  
  5227.                List           List all of the links in the current WorkQube.
  5228.  
  5229.                Edit           Allows you  to edit  an existing  link to  another
  5230.                               file.  A menu of all the links in the file will be
  5231.                               displayed, from which you may  select the link you
  5232.                               want to edit.  You may then change either the file
  5233.                               to link to, or the range in the file, or both.
  5234.  
  5235.                Update         Allows you to  update a link  to another file.   A
  5236.                               menu  of  all  the  links  in  the  file  will  be
  5237.                               displayed, and you may select the link you wish to
  5238.                               be updated.
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.                                           76
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.      --------------------------------------------------------------------------
  5290.      /Print Block
  5291.      --------------------------------------------------------------------------
  5292.      Function  Defines the block of cells to print.
  5293.  
  5294.      Remarks   This  command allows you to define a block to print.  You will be
  5295.                asked to define  the block  to be  printed.  The  block will  not
  5296.                actually be printed  until the /Print  Go command is issued.   If
  5297.                you select  a 3 dimensional  block, each page  of the block  will
  5298.                begin printing at the top of a page of paper.
  5299.  
  5300.  
  5301.      --------------------------------------------------------------------------
  5302.      /Print Rows
  5303.      --------------------------------------------------------------------------
  5304.      Function  Defines rows to print above the print block on each page.
  5305.  
  5306.      Remarks   This command allows you to define one or more rows which  will be
  5307.                printed above your  data on each  page.  This  command is  useful
  5308.                when you are printing a range  which has more rows than will  fit
  5309.                on a single sheet of paper; it allows you to have a row of header
  5310.                data printed at the top of each page.
  5311.  
  5312.      Example   1      A                B             C         D
  5313.                  1 1988 Sales
  5314.                  2
  5315.                  3 Name            Division       Sales
  5316.                  4 Joe Smith       West           1049354
  5317.                  5 Bill Jones      Southwest      1345938
  5318.                  6 Dave Adams      South          1234823
  5319.                  7 Don Nielson     Midwest         934834
  5320.                  8 Sam Davis       Southeast      1834735
  5321.                  9 Jim Turner      Northeast      1634868
  5322.  
  5323.                You have 200  sales people  in this worksheet,  which takes  more
  5324.                than a single page  to print out.  You want row 3 to print out at
  5325.                the top of each page to show what the columns are.  Simply select
  5326.                the /Print Rows command and mark row 3 as the row border.
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.                                           77
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.      --------------------------------------------------------------------------
  5356.      /Print Columns
  5357.      --------------------------------------------------------------------------
  5358.      Function  Defines columns to print  to the left of the print  block on each
  5359.                page.
  5360.  
  5361.      Remarks   This command allows you to define one or  more columns which will
  5362.                be  printed to the left of your data  on each page.  This command
  5363.                is  useful when you are  printing a range  which has more columns
  5364.                than will fit on a single sheet of paper; it allows you to have a
  5365.                column of titles printed at the left of each page.
  5366.  
  5367.      Example   1      A                B             C         D
  5368.                  1 1988 Sales
  5369.                  2
  5370.                  3 Name            Division       Sales
  5371.                  4 Joe Smith       West           1049354
  5372.                  5 Bill Jones      Southwest      1345938
  5373.                  6 Dave Adams      South          1234823
  5374.                  7 Don Nielson     Midwest         934834
  5375.                  8 Sam Davis       Southeast      1834735
  5376.                  9 Jim Turner      Northeast      1634868
  5377.  
  5378.                You have  30  columns  of  data on  each  sales  person  in  this
  5379.                worksheet, which takes more than a single page to print out.  You
  5380.                want column A to print out at the left of each page to show which
  5381.                sales person  the data  is associated  with.   Simply select  the
  5382.                /Print Columns command and mark column A as the column border.
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.                                           78
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.      --------------------------------------------------------------------------
  5422.      /Print Undefine
  5423.      --------------------------------------------------------------------------
  5424.      Function  Undefines the current Print, Rows, and Columns blocks.
  5425.  
  5426.      Remarks   Since ProQube Lite remembers which block  you printed last, it is
  5427.                sometimes  necessary  to reset  the /Print  Block setting.   When
  5428.                doing  so,  it is  usually easiest  to  clear the  previous block
  5429.                setting entirely by using the /Print Undefine command.
  5430.  
  5431.      Options   Block     Clears the previous /Print Block setting.
  5432.  
  5433.                Rows      Clears the previous /Print Rows setting.
  5434.  
  5435.                Columns   Clears the previous /Print Columns setting.
  5436.  
  5437.                All       Clears all previous /Print block settings.
  5438.  
  5439.  
  5440.      --------------------------------------------------------------------------
  5441.      /Print Align
  5442.      --------------------------------------------------------------------------
  5443.      Function  Align the paper in the printer.
  5444.  
  5445.      Remarks   This command sets  the current position  of the printhead as  the
  5446.                top of the  page.  This is important; the printer and the program
  5447.                will be keeping individual track  of the top of the page.   It is
  5448.                good habit to precede the /Print Go command with the /Print Align
  5449.                command.
  5450.  
  5451.  
  5452.      --------------------------------------------------------------------------
  5453.      /Print Line
  5454.      --------------------------------------------------------------------------
  5455.      Function  Advance the printer by one line.
  5456.  
  5457.      Remarks   This  command  sends a  line  feed  to the  printer,  causing the
  5458.                printer to print a blank line.  Since the printer and the program
  5459.                are keeping separate track of the pagination, sending a line feed
  5460.                through  the  printer  control  panel  will cause  the  program's
  5461.                pagination to be off by a line, resulting in unwanted  offsets in
  5462.                your printout.  More importantly, though, it is usually easier to
  5463.                advance the paper one line using  this command than by using  the
  5464.                printer's control panel.
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.                                           79
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.      --------------------------------------------------------------------------
  5488.      /Print Page
  5489.      --------------------------------------------------------------------------
  5490.      Function  Advance the printer to the top of the next page.
  5491.  
  5492.      Remarks   This command sends a form feed  to the printer, causing the paper
  5493.                to  advance one  page.   This is  usually done  at the  end of  a
  5494.                printout, since  printing will stop  with the last  line actually
  5495.                printed.    Thus, to  remove the  page  from the  printer, simply
  5496.                select  the  /Print Page  command.    Since the  printer  and the
  5497.                program are keeping  separate track of the  pagination, sending a
  5498.                form  feed  through  the  printer control  panel  will  cause the
  5499.                program's pagination to be off, resulting in unwanted offsets  in
  5500.                your printout.
  5501.  
  5502.  
  5503.  
  5504.      --------------------------------------------------------------------------
  5505.      /Print Options
  5506.      --------------------------------------------------------------------------
  5507.      Function  Set options for your printout.
  5508.  
  5509.      Remarks   This  command allows  complete  control over  the  format of  the
  5510.                printout.  There are numerous options,  all visible from a single
  5511.                pop-up screen.   You may select an option  either by pressing the
  5512.                first letter of  the option name  (highlighted), or by using  the
  5513.                arrow keys to highlight the option and pressing the <Enter> key.
  5514.  
  5515.      Options   Left Margin    Lets you set  the number  of characters from  left
  5516.                               edge of the page to begin printing.
  5517.  
  5518.                Right Margin   Lets you set  the number  of characters from  left
  5519.                               edge of the  page that you want  your right margin
  5520.                               set to.  The right margin must be greater than the
  5521.                               left margin or an error will occur.
  5522.  
  5523.                Top Margin     Lets you set the number of blank lines to print at
  5524.                               the  top of each page.  If  you set this option to
  5525.                               3, ProQube Lite will begin  printing on the fourth
  5526.                               line of the page.
  5527.  
  5528.                Bottom Margin  Lets you set the number of blank lines to print at
  5529.                               the  bottom  of  each  page.   ProQube  Lite  will
  5530.                               automatically  advance the paper  to the next page
  5531.                               before it resumes printing.
  5532.  
  5533.                Page Length    Lets you  set the  number of  physical lines  on a
  5534.                               page.   On an  8 1/2" x  11" paper at  6 lines per
  5535.                               inch, there are 66 lines.  ProQube Lite must  have
  5536.                               this  information  so that  it  can keep  track of
  5537.                               where it is on the page.
  5538.  
  5539.  
  5540.                                           80
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.                Header         Allows you to enter a header, which will appear at
  5554.                               the  top of  every page.   There  are two  special
  5555.                               characters that you can use in headers:
  5556.  
  5557.                               @    will be replaced by the current date.
  5558.                               #    will be replaced by the current page number.
  5559.  
  5560.                               The header may start with one of the  text justify
  5561.                               characters to  determine  where on  the  line  the
  5562.                               header will be placed.  These characters are
  5563.  
  5564.                               '    left justify the header
  5565.                               "    right justify the header
  5566.                               ^    center the header
  5567.  
  5568.                               For example, if you enter the header:
  5569.  
  5570.                               ^Page #
  5571.  
  5572.                               Then on page 3, the header Page 3 will be centered
  5573.                               at the top of the page.
  5574.  
  5575.                               If no header is defined, then a blank line will be
  5576.                               printed in its place.
  5577.  
  5578.                Footer         Allows you to enter a footer, which will appear at
  5579.                               the bottom of  every page.  There are  two special
  5580.                               characters that you can use in footers:
  5581.  
  5582.                               @    will be replaced by the current date.
  5583.                               #    will be replaced by the current page number.
  5584.  
  5585.                               The footer may start with  one of the text justify
  5586.                               characters  to  determine where  on  the line  the
  5587.                               header will be placed.  These characters are
  5588.  
  5589.                               '    left justify the footer
  5590.                               "    right justify the footer
  5591.                               ^    center the footer
  5592.  
  5593.                               For example, if you enter the footer:
  5594.  
  5595.                               "@
  5596.  
  5597.                               Then the current  date will be right  justified at
  5598.                               the bottom of each page.
  5599.  
  5600.                               If no header is defined, then a blank line will be
  5601.                               printed in its place.
  5602.  
  5603.  
  5604.  
  5605.  
  5606.                                           81
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.  
  5618.  
  5619.                Mode           Lets you decide what type of printout you want.
  5620.  
  5621.                               Display   The  printout will  appear  as the  file
  5622.                                         does  on-screen;  that  is,  the  values
  5623.                                         calculated  by  the  formulas   will  be
  5624.                                         printed.
  5625.  
  5626.                               Formula   The formulas themselves will be printed,
  5627.                                         one cell per  line.  This is  useful for
  5628.                                         documentation and error-handling.
  5629.  
  5630.                Output         Lets you decide where to send your output.
  5631.  
  5632.                               Printer   All output will be sent to the printer.
  5633.  
  5634.                               File      All output will be sent to  a file.  You
  5635.                                         will be asked  for the name of  the file
  5636.                                         you want to send the printout to.
  5637.  
  5638.                Number (page)  Displays  the current  page number, which  you can
  5639.                               set or reset.
  5640.  
  5641.                Device         Allows you to select whether  to send the printout
  5642.                               to LPT1 or LPT2.
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.                                           82
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.      --------------------------------------------------------------------------
  5686.      /Print Setup
  5687.      --------------------------------------------------------------------------
  5688.      Function  Setup ProQube Lite to handle various printer controls.
  5689.  
  5690.      Remarks   This command allows you to map  screen characters to your printer
  5691.                character  set  and enter  printer  setup strings.    This allows
  5692.                ProQube Lite  to take  advantage of  the various  characteristics
  5693.                which  your printer offers.  ProQube Lite stores this information
  5694.                in  a file  named ProQube  Lite.SET which  is stored in  the user
  5695.                directory.
  5696.  
  5697.                Map       Most printers do not have the exact same character  set
  5698.                          that  IBM  PCs  and compatibles  use  on  screen.   The
  5699.                          mapping option displays a table which allows you to map
  5700.                          your printers character  set to the IBM  character set.
  5701.                          The  table displays all of the  IBM characters, as well
  5702.                          as the ASCII  value that  will be sent  to the  printer
  5703.                          when that character is encountered.
  5704.  
  5705.                          For  example,  ProQube Lite  normally  sends  the ASCII
  5706.                          value 156 when it encounters the pound symbol.  If your
  5707.                          printer set  defines the  pound symbol  as ASCII  value
  5708.                          192, then  you would  use the  arrow keys  to move  the
  5709.                          cursor to the  pound symbol  on the  screen, press  the
  5710.                          <Enter> key, and replace the value 156 with 192.
  5711.  
  5712.                Fonts     This option  allows you  to enter  the printer  control
  5713.                          codes necessary to turn printer features on and off.  A
  5714.                          screen will appear which contains 3 columns.  The first
  5715.                          column  is for  a  descriptive  name  for each  of  the
  5716.                          printer  fonts/characteristics  (for  example, italics,
  5717.                          bold, or condensed).   The  second column contains  the
  5718.                          printer codes necessary to turn each characteristic on,
  5719.                          and the  third column contains  the codes  to turn  the
  5720.                          characteristic off.
  5721.  
  5722.                          To change a  description or code,  move the bar to  the
  5723.                          desired  row  and  column with  the  arrow  keys, press
  5724.                          <Enter>, and type in the description or code.
  5725.  
  5726.                          Most  printer codes  contain  control characters  which
  5727.                          can't  be  entered  directly.     To  enter  a  control
  5728.                          character  into  your  ON/OFF  codes,  simply  enter  a
  5729.                          backslash character  \ followed  by the  3 digit  ASCII
  5730.                          code (in decimal) for the control character.
  5731.  
  5732.                          For example, since the ASCII value (in decimal) for the
  5733.                          <Esc> character is 27, you would  use a setup string of
  5734.                          \027E to send an  <Esc>E to the printer (this  sequence
  5735.                          selects emphasized print on an EPSON printer).
  5736.  
  5737.  
  5738.                                           83
  5739.  
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.  
  5750.  
  5751.                          Your printer manual  should list  all of the  available
  5752.                          printer codes for your particular printer.
  5753.  
  5754.                Save      This option will save the  printer setup information to
  5755.                          the ProQube Lite.SET file in the user directory.
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.  
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.                                           84
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.      --------------------------------------------------------------------------
  5818.      /Print Go
  5819.      --------------------------------------------------------------------------
  5820.      Function  Send your data to the printer (or print file).
  5821.  
  5822.      Remarks   This command begins the  process of printing.  ProQube  Lite will
  5823.                not begin printing until it receives this command.
  5824.  
  5825.                If the block you are trying  to print is wider than the left  and
  5826.                right  margins allow,  ProQube Lite  will ask  if you want  if to
  5827.                break the page  into smaller pieces  for printing.  These  pieces
  5828.                can then be put back together into a larger sheet.
  5829.  
  5830.                If you don't want the printout to be broken into smaller  pieces,
  5831.                then you must go back into the /Print Options and reset your left
  5832.                and right margins to allow for a wider printout.
  5833.  
  5834.                If you  want to abort the print job  after it has started, simply
  5835.                press the <Esc>  key (printers with  built-in print buffers  will
  5836.                continue to print until the print buffer has been emptied).
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.                                           85
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.      --------------------------------------------------------------------------
  5884.      /Data Sort
  5885.      --------------------------------------------------------------------------
  5886.      Function  Sort a range of data.
  5887.  
  5888.      Remarks   This  command allows  you to  sort rows  or columns  of data,  in
  5889.                either ascending or descending  order.  A window of  options will
  5890.                appear on the  screen.  To change an option, either press the key
  5891.                corresponding  to  the first  letter of  the  option name  (D for
  5892.                Direction  for  example), or  use  the  cursor keys  to  move the
  5893.                lightbar to the  option you want to change and  press the <Enter>
  5894.                key.
  5895.  
  5896.      Options   Direction      Determines how your data is to be sorted.
  5897.  
  5898.                               Row       Rows will be sorted.
  5899.                               Column    Columns will be sorted.
  5900.  
  5901.                Block          You will  be asked  to define  the block to  sort.
  5902.                               This  block  should  include all  of  the  rows or
  5903.                               columns which you want rearranged.
  5904.  
  5905.                1st - 9th Key  The Key  options indicate the fields to be used in
  5906.                               determining the  sorted (new)  order of  the data.
  5907.                               You will be prompted to indicate the column or row
  5908.                               that contains the data by which  the sort is to be
  5909.                               performed.   The column  or row  may be  indicated
  5910.                               either  by  pointing or  by typing  an appropriate
  5911.                               cell address.
  5912.  
  5913.                               You will also be asked whether the sort should  be
  5914.                               in  Ascending or  Descending  order.   Sorting the
  5915.                               data in  ascending order causes numerical  data to
  5916.                               be sorted from the smallest  number to the largest
  5917.                               number (1, 2, 3, 4, etc.), while textual data will
  5918.                               be  sorted  alphabetically  (A,  B,  C,  D,  etc).
  5919.                               Sorting  the  data  in  descending  order has  the
  5920.                               opposite  effect; numbers  will  be arranged  from
  5921.                               large to small (5,4,3,2,1, etc), and textual  data
  5922.                               will be  sorted in reverse alphabetical  order (Z,
  5923.                               Y, X, W, etc).
  5924.  
  5925.                Reset          This  command  resets  all of  the  sort settings.
  5926.                               This  function  is  necessary  when  you  need  to
  5927.                               undefine the sort keys.
  5928.  
  5929.                Start          Pressing the Start  key in  the options menu  will
  5930.                               cause the sort to be performed as indicated in the
  5931.                               menu.
  5932.  
  5933.  
  5934.  
  5935.  
  5936.                                           86
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.      --------------------------------------------------------------------------
  5950.      /Data Fill
  5951.      --------------------------------------------------------------------------
  5952.      Function  Fill a block of cells with data.
  5953.  
  5954.      Remarks   This command allows  you to fill a specified block  of cells with
  5955.                text or numbers.  You will be asked for an equation which is used
  5956.                to determine the values placed in each of the cells to be filled.
  5957.  
  5958.                A variable named  # is initialized to  0 and is incremented  by 1
  5959.                for each cell in the block.  The # variable may be used  anywhere
  5960.                in the equation to  provide an endless number of sequences.   The
  5961.                equation  entered  with this  command  may be  any  legal formula
  5962.                containing  numbers,   operators,  cell   or  block   references,
  5963.                functions, or the # variable.
  5964.  
  5965.                Cell references in the formula are treated as relative unless you
  5966.                specifically make them absolute using the $ symbol.
  5967.  
  5968.      Examples  #
  5969.                generates a sequence starting with 0 and incrementing by 1.
  5970.  
  5971.                1000+#
  5972.                generates a sequence starting with 1000 and incrementing by 1.
  5973.  
  5974.                5+#*3
  5975.                generates a sequence starting with 5 and incrementing by 3.
  5976.  
  5977.                @TODAY+#
  5978.                generates  a sequence of  date numbers starting  with the current
  5979.                date.
  5980.  
  5981.                Assume you have a column of values in the range A1;1..A20;1.  You
  5982.                want to  fill column  B with  a running  total of  the values  in
  5983.                column A.   Simply  copy the  value in  cell A1;1  to cell  B1;1,
  5984.                select /Data Fill,  define B2;1..B20;1 as  the range you want  to
  5985.                fill, and enter the equation B1;1+A2;1.
  5986.  
  5987.                Since the cell  address in the  Data Fill equation are  relative,
  5988.                they will be adjusted for each cell in the fill range.  Each cell
  5989.                in the fill range will be filled with the value of the cell above
  5990.                it added to the cell  to the left of it.  This  gives you exactly
  5991.                what you wanted, a running total of column A in column B.
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.                                           87
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.  
  6014.  
  6015.      --------------------------------------------------------------------------
  6016.      /Data Value
  6017.      --------------------------------------------------------------------------
  6018.      Function  Convert formulas in a block to their values.
  6019.  
  6020.      Remarks   This command converts  formulas in a block to their  values.  You
  6021.                will be  asked to  define a  block of  cells to  convert.   Since
  6022.                formulas  require  more memory  than  values, this  command helps
  6023.                conserve  memory when you just  need a set  of values rather than
  6024.                the formulas.
  6025.  
  6026.  
  6027.  
  6028.      --------------------------------------------------------------------------
  6029.      /Data Modify
  6030.      --------------------------------------------------------------------------
  6031.      Function  Modify all numerical values in a block.
  6032.  
  6033.      Remarks   This command allows you  to modify all of the values  in a block.
  6034.                You may specify that each cell in a specified block be multiplied
  6035.                by 5, or subtracted from the average value of the block,  or that
  6036.                they be modified  in any  of the  ways that a  legal formula  may
  6037.                provide.   You will be  asked to define  the block to  modify, as
  6038.                well as an equation to modify the cells with.
  6039.  
  6040.                This command  provides a  variable named  # which is  set to  the
  6041.                value of  each cell in the block.  This variable may be used just
  6042.                like a number or cell reference in the formula.
  6043.  
  6044.      Example   Below  are  examples of  equations and  the  way they  modify the
  6045.                block.
  6046.  
  6047.                2*#       doubles all of the values in the block.
  6048.                #^2       squares all of the values in the block.
  6049.                #+3       adds 3 to all of the values in the block.
  6050.                @ABS(#)   makes all of the values in the block positive.
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.                                           88
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.      --------------------------------------------------------------------------
  6082.      /Macro Edit
  6083.      --------------------------------------------------------------------------
  6084.      Function  Edit or create a macro.
  6085.  
  6086.      Remarks   This command allows you  to edit or create a macro.   You will be
  6087.                asked for the name of a macro  to edit.  Pressing <Enter> without
  6088.                entering a macro name will cause the ProQube Lite File Manager to
  6089.                appear on-screen; the macro name may then be chosen from the File
  6090.                Manager.  Once a macro is  chosen, the ProQube Lite Macro  Editor
  6091.                will display the macro and allow  you to edit it.  The  following
  6092.                commands are available for editing the macro.
  6093.  
  6094.  
  6095.                <Up> <Down>
  6096.                <Left> <Right> The  arrow  keys move  the cursor  up or  down one
  6097.                               line, or left or right one character.
  6098.  
  6099.                <Home>         This key moves  the cursor to the beginning of the
  6100.                               line.
  6101.                <End>          This key moves the cursor to the end of the line.
  6102.                <^Right>       This key moves the cursor one word to the right.
  6103.                <^Left>        This key moves the cursor one word to the left.
  6104.  
  6105.                <^Home>        This key moves the cursor to the top of the file.
  6106.                <^End>         This key moves the cursor to the end of the file.
  6107.  
  6108.                <PgDn>         This key moves the cursor down one screen.
  6109.                <PgUp>         This key moves the cursor up one screen.
  6110.  
  6111.                <BkSp>         This key deletes the character to the left of  the
  6112.                               cursor and shifts the following characters in  the
  6113.                               line to the left to fill in the empty space.
  6114.  
  6115.                <^BkSp>        This key deletes the entire line.
  6116.  
  6117.                <Del>          This  key  deletes  the  character underneath  the
  6118.                               cursor and shifts the  following characters in the
  6119.                               line to the left to fill in the empty space.
  6120.  
  6121.                <Ins>          This key  toggles  between  insert  and  overwrite
  6122.                               modes.  When  you  are in  insert  mode,  typing a
  6123.                               character will insert the  new character into  the
  6124.                               line  at  the  point  where  the  cursor  is.  The
  6125.                               character under the cursor and  those to the right
  6126.                               of the  cursor are  shifted to  the right to  make
  6127.                               room  for  the  new  character.  When you  are  in
  6128.                               overwrite  mode, typing  a character  will replace
  6129.                               the  character  under  the  cursor  with  the  new
  6130.                               character.    When  you are  in  insert  mode, the
  6131.                               cursor will be  an underline.   In overwrite  mode
  6132.                               the cursor will be a solid block.
  6133.  
  6134.                                           89
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.                <F1> Help      This  key  causes a  help  screen to  appear which
  6149.                               lists  all  of  the commands  available  for  text
  6150.                               editing.
  6151.  
  6152.                <F2> Mark      This key  turns on  marking at  the current  line.
  6153.                               Moving the cursor  after pressing this key  causes
  6154.                               lines  between   that  line  and  the  new  cursor
  6155.                               position  to  be  highlighted.    Pressing <F2>  a
  6156.                               second time will turn off text marking.
  6157.  
  6158.                <F3> Cut       Pressing this  key with  marking turned  on (<F2>)
  6159.                               causes the marked lines to be  cut out of the file
  6160.                               and placed  in a  buffer.   You may  then move  to
  6161.                               another location in the file  and use the <F4> key
  6162.                               to paste the lines back into the file.  The buffer
  6163.                               will only hold one  block of lines, so if  you cut
  6164.                               data  a  second time,  the  new data  replaces the
  6165.                               older data in the buffer.
  6166.  
  6167.                <F4> Paste     This keys causes the contents of the  buffer to be
  6168.                               pasted into the file at the cursor location.  This
  6169.                               does not  clear the buffer,  so you may  paste the
  6170.                               same buffer data into more than one location.
  6171.  
  6172.                <F5> DelLine   This command deletes the line the cursor is on.
  6173.  
  6174.                <F6> Search    This command allows  you to search for a string in
  6175.                               the file.  You will be asked to enter the text you
  6176.                               want  to search for.   Simply enter  the text, and
  6177.                               the cursor will be moved to the next occurrence of
  6178.                               that text.  The search  is case insensitive, which
  6179.                               means  that  hello  will match  hello,  Hello,  or
  6180.                               HeLlO.
  6181.  
  6182.                <F7> Save      This command allows  you to save the  current file
  6183.                               to disk without having to exit.
  6184.  
  6185.                <F10> Exit     This command allows  you to exit from  the editor.
  6186.                               If you have made any changes to the file, you will
  6187.                               be asked if you want to save it first.
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.  
  6197.  
  6198.  
  6199.  
  6200.                                           90
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.  
  6212.  
  6213.      --------------------------------------------------------------------------
  6214.      /Macro Delete
  6215.      --------------------------------------------------------------------------
  6216.      Function  Deletes a macro file from the disk.
  6217.  
  6218.      Remarks   This  command deletes a  macro file from  the disk.   You will be
  6219.                asked for the  name of a macro  to delete.  Pressing  the <Enter>
  6220.                key  without  indicating a  macro to  be  deleted will  cause the
  6221.                ProQube Lite  File Manager  to appear  on-screen.   You may  then
  6222.                choose the macro to be deleted using the File Manager.
  6223.  
  6224.  
  6225.  
  6226.      --------------------------------------------------------------------------
  6227.      /Macro List
  6228.      --------------------------------------------------------------------------
  6229.      Function  List all macros in the current directory.
  6230.  
  6231.      Remarks   This command lists  all of the  macros in the current  directory.
  6232.                The command uses the ProQube Lite File Manager to find files with
  6233.                the .PQM extension.
  6234.  
  6235.  
  6236.  
  6237.      --------------------------------------------------------------------------
  6238.      /Macro Run
  6239.      --------------------------------------------------------------------------
  6240.      Function  Run a macro or application program.
  6241.  
  6242.      Remarks   This command executes a macro (or application program).  You will
  6243.                be asked for the name  of a macro to  run.  Pressing the  <Enter>
  6244.                key without indicating a macro to  be run will cause the  ProQube
  6245.                Lite File Manager  to appear on-screen.  You may  then choose the
  6246.                macro  to  be run  using the  File Manager.   For  information on
  6247.                creating macros and application programs, see the section ProQube
  6248.                Lite Applications.
  6249.  
  6250.  
  6251.  
  6252.  
  6253.  
  6254.  
  6255.  
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.  
  6266.                                           91
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.  
  6273.  
  6274.  
  6275.  
  6276.  
  6277.  
  6278.  
  6279.      --------------------------------------------------------------------------
  6280.      /OpSys
  6281.      --------------------------------------------------------------------------
  6282.      Function  Temporarily returns to DOS.
  6283.  
  6284.      Remarks   This command allows you to temporarily  return to the DOS command
  6285.                line, where you can execute DOS commands or other programs.  When
  6286.                you are ready to return to ProQube Lite, simply type:
  6287.  
  6288.                EXIT<Enter>
  6289.  
  6290.                at the DOS prompt.
  6291.  
  6292.                If  enough  expanded  memory or  hard  disk  space  is available,
  6293.                ProQube Lite  will swap  most of itself  out to  free up  as much
  6294.                memory as possible.  When swapping out to your hard disk, ProQube
  6295.                Lite will print the message Swapping... to your screen.
  6296.  
  6297.                IMPORTANT:  Never run  TSRs from  the /OpSys  command  line (this
  6298.                includes the DOS PRINT  command).  Doing so can  cause unexpected
  6299.                problems to occur.
  6300.  
  6301.  
  6302.      --------------------------------------------------------------------------
  6303.      /Quit
  6304.      --------------------------------------------------------------------------
  6305.      Function  Exits from ProQube Lite.
  6306.  
  6307.      Remarks   This command allows you to leave ProQube Lite  entirely.  This is
  6308.                an  intelligent exit command;  if you have  made changes, ProQube
  6309.                Lite will  allow you  to save  the file  before exiting.   If  no
  6310.                changes  have been  made,  ProQube  Lite  will  simply  exit  the
  6311.                program.
  6312.  
  6313.      Options   If changes have been made to the WorkQube since the last time you
  6314.                saved it, you will be  asked if you want to lose  the changes you
  6315.                made:
  6316.  
  6317.                No        Returns  you  to  the  WorkQube  without  exiting   the
  6318.                          program.
  6319.  
  6320.                Yes       Exits ProQube Lite.   Any changes made  to the WorkQube
  6321.                          will be lost.
  6322.  
  6323.                Save      Saves  the  WorkQube,  then   exits  the  ProQube  Lite
  6324.                          program.
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.                                           92
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.      BUILT-IN FUNCTIONS
  6346.  
  6347.      ProQube Lite provides over 80 built-in functions which you can use  in your
  6348.      formulas.   These built-in functions each  begin with the  character @, and
  6349.      are often called at functions.  
  6350.  
  6351.      Most of these  functions require one or  more arguments.  An  argument is a
  6352.      value which  the function uses as an input to  provide an output value.  An
  6353.      argument may  be a number, a text string, a reference to a value in another
  6354.      cell, or another  formula.  In  the case of  the statistical functions,  an
  6355.      argument may  also be a  range or block of  cells.  If  a function requires
  6356.      arguments, then they are enclosed in parentheses and immediately follow the
  6357.      name of the @function.  If more than one argument is required, they must be
  6358.      separated from each other with a comma.
  6359.  
  6360.      A built-in function can return either a numerical or text value and  may be
  6361.      treated exactly like a number or text would be.
  6362.  
  6363.      Example   A cell contains the formula =2*@ABS(-3).
  6364.  
  6365.                @ABS  is  the  name of  a  built-in  function  which returns  the
  6366.                absolute (positive) value of its argument.
  6367.  
  6368.                -3 is the argument to the function.
  6369.  
  6370.                The function returns a value of 3, and is used in the rest of the
  6371.                formula just like the number 3.  The value of the  entire formula
  6372.                is 6 (2 times the value of the @function).
  6373.  
  6374.      If the  value that  a function  returns is  an error,  it  will return  the
  6375.      special value ERROR.  A formula  which contains a function with a  value of
  6376.      ERROR will also return ERROR as the value for the cell it is in.
  6377.  
  6378.  
  6379.      Mathematical   ProQube Lite's math functions allow your formulas to perform
  6380.                     more   sophisticated   mathematical   operations  than   the
  6381.                     operators alone can provide.
  6382.  
  6383.                     FUNCTION       RETURNS
  6384.                     @ABS(x)        the absolute value of x.
  6385.                     @EXP(x)        e to the xth power.
  6386.                     @FACT(x)       x factorial.
  6387.                     @FRAC(x)       the fraction part of x.
  6388.                     @INT(x)        the integer part of x.
  6389.                     @LN(x)         the natural log of x.
  6390.                     @LOG(x)        the common log of x.
  6391.                     @MOD(x,y)      x modulo y.
  6392.                     @RAND          a uniform random number.
  6393.                     @ROUND(x,n)    x rounded to n decimal places.
  6394.                     @SIGN(x)       the sign of x.
  6395.                     @SQRT(x)       the square root of x.
  6396.  
  6397.  
  6398.                                           93
  6399.  
  6400.  
  6401.  
  6402.  
  6403.  
  6404.  
  6405.  
  6406.  
  6407.  
  6408.  
  6409.  
  6410.  
  6411.      Trigonometric  ProQube Lite's trigonometry  functions work the same  way as
  6412.                     the  mathematical functions, but  they specialize in working
  6413.                     with angles.
  6414.  
  6415.                     All angle arguments and results are  in radians.  To convert
  6416.                     from  degrees to  radians,  use the  @RADIAN  function.   To
  6417.                     convert from radians to degrees, use the @DEGREE function.
  6418.  
  6419.                     FUNCTION       RETURNS
  6420.                     @ACOS(x)       the arc cosine of x.
  6421.                     @ASIN(x)       the arc sine of x.
  6422.                     @ATAN(x)       the 2 quadrant arc tangent of x.
  6423.                     @ATAN2(x,y)    the 4 quadrant arc tangent of y/x.
  6424.                     @COS(x)        the cosine of x.
  6425.                     @DEGREES(x)    x converted from radians to degrees.
  6426.                     @PI            the value pi (3.14159..)
  6427.                     @RADIANS(x)    x converted from degrees to radians.
  6428.                     @SIN(x)        the sine of x.
  6429.                     @TAN(x)        the tangent of x.
  6430.  
  6431.  
  6432.      Statistical    ProQube Lite's  statistical functions  allow you to  analyze
  6433.                     and  summarize  your  data  in  a  variety  of  ways.    The
  6434.                     statistical   functions   calculate   and   return   various
  6435.                     statistics  of a list  of values.   The list may  consist of
  6436.                     numbers, references to values in other cells, formulas, or a
  6437.                     range or block  of cells.   Ranges and  blocks of cells  are
  6438.                     defined by using the  cell names of two opposite  corners of
  6439.                     the   block   separated   by  two   periods   (for  example:
  6440.                     C14;2..D16;3).   Each individual  item in  the list  must be
  6441.                     separated by a comma.
  6442.  
  6443.                     For example, suppose you want to  sum 1.23, the value in the
  6444.                     cell A1;1, and the values in each  cell in the block defined
  6445.                     by the  cells C14;2 and  D16;3.   You would  simply use  the
  6446.                     formula:
  6447.  
  6448.                     =@SUM(1.23,A1;1,C14;2..D16;3)
  6449.  
  6450.                     FUNCTION       RETURNS
  6451.                     @AVG(list)     the average of a list of values.
  6452.                     @COUNT(list)   the number of items in a list.
  6453.                     @MAX(list)     the maximum value in a list of values.
  6454.                     @MIN(list)     the minimum value in a list of values.
  6455.                     @STD(list)     the   standard  deviation   of   a  list   of
  6456.                                    population values.
  6457.                     @SUM(list)     the sum of a list of values.
  6458.                     @VAR(list)     the variance of a list of population values.
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.                                           94
  6465.  
  6466.  
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.  
  6475.  
  6476.  
  6477.      Financial      ProQube Lite's financial functions allow you to perform many
  6478.                     powerful  analyses.  Functions  include formulas  to compute
  6479.                     time value of money calculations, depreciation calculations,
  6480.                     and growth rate calculations.
  6481.  
  6482.                     FUNCTION                 RETURNS
  6483.                     @CTERM(rate,fv,pv)       the  number  of   periods  for   an
  6484.                                              investment to reach a future value.
  6485.                     @DDB(cost,salv,l,p)      the  amount  of depreciation  of an
  6486.                                              asset  using  the  Double-Declining
  6487.                                              Balance method.
  6488.                     @FV(pmt,int,term)        the future value of an annuity.
  6489.                     @IRR(guess,range)        the internal  rate of  return of  a
  6490.                                              cash flow.
  6491.                     @NPV(int,range)          the net  present value of  a series
  6492.                                              of future cash flows.
  6493.                     @PMT(prin,int,term)      the payment required to  amortize a
  6494.                                              loan amount.
  6495.                     @PV(pmt,int,term)        the present value of an annuity.
  6496.                     @RATE(fv,pv,term)        the  interest  rate   at  which   a
  6497.                                              present value will grow to a future
  6498.                                              value.
  6499.                     @SLN(cost,salv,life)     the  amount  of depreciation  of an
  6500.                                              asset  using   the  straight   line
  6501.                                              method.
  6502.                     @SYD(cost,salv,l,p)      the  amount  of depreciation  of an
  6503.                                              asset using  the sum of  the years'
  6504.                                              digits method.
  6505.                     @TERM(pmt,int,fv)        the  number  of   periods  for   an
  6506.                                              investment to reach a future value.
  6507.  
  6508.  
  6509.  
  6510.  
  6511.  
  6512.  
  6513.  
  6514.  
  6515.  
  6516.  
  6517.  
  6518.  
  6519.  
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.                                           95
  6531.  
  6532.  
  6533.  
  6534.  
  6535.  
  6536.  
  6537.  
  6538.  
  6539.  
  6540.  
  6541.  
  6542.  
  6543.      Date/Time      ProQube Lite represents  dates as the  number of days  since
  6544.                     December 31, 1899.  For example:
  6545.  
  6546.                     Jan 1, 1900 = 1
  6547.                     Jan 2, 1900 = 2
  6548.  
  6549.                     and so on.
  6550.  
  6551.                     Time is  represented as  a fraction  of a  day (starting  at
  6552.                     midnight).  For example:
  6553.  
  6554.                     midnight = 0.0
  6555.                     noon = 0.5 because it is half way through the day,
  6556.                     6:00PM = 0.75 because it is 3/4 way through the day,
  6557.  
  6558.                     and so on.
  6559.  
  6560.                     This  allows dates and times to be manipulated with ordinary
  6561.                     math operations.  For example, you could find out what  day,
  6562.                     month,  and year 90 days  from today is by simply adding  90
  6563.                     to the number which represents today's date.
  6564.  
  6565.                     FUNCTION            RETURNS
  6566.                     @DATE(yr,mnth,day)  the date number of day,mnth,yr.
  6567.                     @DAY(date#)         the day (1..31) for date number.
  6568.                     @HOUR(time#)        the hour (0..23) for time number.
  6569.                     @MINUTE(time#)      the minute (0..59) for time number.
  6570.                     @MONTH(date#)       the month (1..12) for date number.
  6571.                     @NOW                the combined  time and  date number  for
  6572.                                         the current moment.
  6573.                     @SECOND(time#)      the second (0..59) for time number.
  6574.                     @TIME(hr,min,sec)   the time number of hr,min,sec.
  6575.                     @TODAY              the date number for the current date.
  6576.                     @YEAR(date#)        the year (0..200) for date number.
  6577.  
  6578.  
  6579.      Logical        The ProQube Lite logical functions evaluate  their arguments
  6580.                     to  determine  one  thing:  truth  or falsity.    Typically,
  6581.                     logical functions supply  the value 1 as  the representative
  6582.                     of truth, and 0 as the representative of falsity.
  6583.  
  6584.                     FUNCTION            RETURNS
  6585.                     @FALSE              the value 0 (FALSE)
  6586.                     @IF(condition,x,y)  if condition is TRUE, then x; else y
  6587.                     @ISERR(x)           1 (TRUE) if x is ERROR
  6588.                     @ISNUM(x)           1 (TRUE) if x is numeric
  6589.                     @ISTEXT(x)          1 (TRUE) if x is textual
  6590.                     @TRUE               the value 1 (TRUE)
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.                                           96
  6597.  
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.  
  6606.  
  6607.  
  6608.  
  6609.      String         The  ProQube  Lite  string functions  allow  you  to process
  6610.                     character strings  more efficiently.   They  are often  used
  6611.                     when importing data  from other  programs, printing, and  in
  6612.                     macros that process strings.
  6613.  
  6614.                     FUNCTION            RETURNS
  6615.                     @CHAR(x)            a character, based on its ASCII value.
  6616.                     @CODE(x)            the ASCII value of a character.
  6617.                     @EXACT(s1,s2)       TRUE (1) if s1 and s2 match exactly.
  6618.                     @FIND(s1,s2,x)      the position in s2 where s1 is found.
  6619.                     @LEFT(s1,n)         the left part of a string.
  6620.                     @LEN(string)        the length (in characters) of a string.
  6621.                     @LOWER(string)      a string converted to lowercase.
  6622.                     @MID(s1,x,y)        the middle part of a string.
  6623.                     @PROPER(string)     a  string, with  the first  character of
  6624.                                         words in uppercase.
  6625.                     @REPEAT(s1,x)       a string  repeated  a  given  number  of
  6626.                                         times.
  6627.                     @REPLACE(s1,x,n,s2) s1  with  n   characters  removed   from
  6628.                                         position x,  and  with  s2  inserted  at
  6629.                                         position x.
  6630.                     @RIGHT(s1,x)        the right part of a string.
  6631.                     @STRING(x,n)        a string which looks like a number.
  6632.                     @TRIM(string)       a string with extra spaces trimmed out.
  6633.                     @UPPER(string)      a string converted to uppercase.
  6634.                     @VALUE(string)      the number that string looks like.
  6635.  
  6636.  
  6637.      Data           ProQube Lite's data functions allow  your formulas to access
  6638.                     data in a variety of ways, from lookup tables, to  access to
  6639.                     cell statistics.
  6640.  
  6641.                     FUNCTION                      RETURNS
  6642.                     @CELL(att,range)              information about a cell.
  6643.                     @CHOOSE(x,y1,y2,..yn)         an item from a list of items.
  6644.                     @COLS(range)                  the  number   of  columns   in
  6645.                                                   range.
  6646.                     @ERROR                        the value ERROR.
  6647.                     @HLOOKUP(x,blk,row,page)      a  value  from   a  horizontal
  6648.                                                   lookup table.
  6649.                     @INDEX(range,col,row,page)    a value from a 3D array.
  6650.                     @PAGES(range)                 the number of pages in range.
  6651.                     @POINTER(att)                 information about the  current
  6652.                                                   cell.
  6653.                     @ROWS(range)                  the number of rows in range.
  6654.                     @VLOOKUP(x,blk,col,page)      a value from a vertical lookup
  6655.                                                   table.
  6656.                     @@(cell)                      data  from  a cell  through an
  6657.                                                   indirect address.
  6658.  
  6659.  
  6660.  
  6661.  
  6662.                                           97
  6663.  
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.  
  6672.  
  6673.  
  6674.  
  6675.      --------------------------------------------------------------------------
  6676.      @ABS                                                           Mathematical
  6677.      --------------------------------------------------------------------------
  6678.      Function  Returns the absolute (positive) value of a number.
  6679.  
  6680.      Syntax    @ABS(x)
  6681.                where x is a number, a cell address, or a calculated value.
  6682.  
  6683.      Example   =@ABS(-212) = 212
  6684.                =@ABS(25.3) = 25.3
  6685.                =@ABS(B5;1) = 13, if the value of B5;1 is 13 or -13
  6686.  
  6687.  
  6688.  
  6689.      --------------------------------------------------------------------------
  6690.      @ACOS                                                          Trigonometry
  6691.      --------------------------------------------------------------------------
  6692.      Function  Returns the arc cosine of a number.
  6693.  
  6694.      Syntax    @ACOS(x)
  6695.                where x is a number, a cell address, or a calculated value.
  6696.  
  6697.      Remarks   This function returns  the angle whose cosine is x.  The value of
  6698.                x must be between -1 and 1, or @ACOS will return the value ERROR.
  6699.                The value of the angle returned will  be in radians, and will lie
  6700.                between  0 and  pi.   If  you want  the result  to be  in degrees
  6701.                instead, then use the @DEGREES function to convert the result.
  6702.  
  6703.      Example   =@ACOS(-0.990) = 3
  6704.                =@ACOS(-1) = 3.14159
  6705.                =@DEGREES(@ACOS(-1)) = 180
  6706.                =@ACOS(2) = ERROR
  6707.  
  6708.  
  6709.  
  6710.      --------------------------------------------------------------------------
  6711.      @ASIN                                                          Trigonometry
  6712.      --------------------------------------------------------------------------
  6713.      Function  Returns the arc sine of a number.
  6714.  
  6715.      Syntax    @ASIN(x)
  6716.                where x is a number, a cell address, or a calculated value. 
  6717.  
  6718.      Remarks   This function returns the angle whose sine is x.   The value of x
  6719.                must be between  -1 to 1, or  @ASIN will return the  value ERROR.
  6720.                The value of the angle returned will  be in radians, and will lie
  6721.                between pi/2 and -pi/2.  If you want the result to  be in degrees
  6722.                instead, then use the @DEGREES function to convert the result.
  6723.  
  6724.      Example   =@ASIN(0.1411) = 0.141572
  6725.                =@ASIN(1) = 1.570796
  6726.                =@DEGREES(@ASIN(1)) = 90
  6727.  
  6728.                                           98
  6729.  
  6730.  
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.      --------------------------------------------------------------------------
  6742.      @ATAN                                                          Trigonometry
  6743.      --------------------------------------------------------------------------
  6744.      Function  Returns the arc tangent of a number.
  6745.  
  6746.      Syntax    @ATAN(x)
  6747.                where x is a number, a cell address, or a calculated value.
  6748.  
  6749.      Remarks   This function returns the angle whose tangent is x.  The value of
  6750.                the angle returned is in  radians.  If you want the  result to be
  6751.                in degrees instead, then use the @DEGREES function to convert the
  6752.                result.
  6753.  
  6754.                Since the @ATAN function finds an angle based on a single  value,
  6755.                the result is limited to quadrants I  and IV (-pi/2 to pi/2).  If
  6756.                you want to  find a  4 quadrant  angle, you must  use the  @ATAN2
  6757.                function.
  6758.  
  6759.      Example   =@ATAN(1) = 0.7854
  6760.                =@DEGREES(@ATAN(1)) = 45
  6761.  
  6762.  
  6763.  
  6764.      --------------------------------------------------------------------------
  6765.      @ATAN2                                                         Trigonometry
  6766.      --------------------------------------------------------------------------
  6767.      Function  Returns the four quadrant arc tangent of y/x.
  6768.  
  6769.      Syntax    @ATAN2(x,y)
  6770.                where x and y are numbers, cell addresses, or calculated values.
  6771.  
  6772.      Remarks   This function returns the angle whose tangent is y/x.
  6773.  
  6774.                The  @ATAN2  function calculates  the  value of  the  arc tangent
  6775.                differently than  the @ATAN function.   Where the  @ATAN function
  6776.                takes  as  its argument  the  value  of the  tangent,  the @ATAN2
  6777.                function calculates  the value of the arc tangent using the x and
  6778.                y coordinates.  The result will  be a full 4 quadrant angle,  and
  6779.                will be between -pi and pi.
  6780.  
  6781.      Example   =@ATAN2(1,1) = 0.7854
  6782.                =@DEGREE(@ATAN2(1,1)) = 45
  6783.                =@DEGREE(@ATAN2(-1,-1)) = -135
  6784.  
  6785.  
  6786.  
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.  
  6794.                                           99
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.      --------------------------------------------------------------------------
  6808.      @AVG                                                            Statistical
  6809.      --------------------------------------------------------------------------
  6810.      Function  Returns the average of a list of values.
  6811.  
  6812.      Syntax    @AVG(list)
  6813.                where list is  a list of values  separated by commas, or  a range
  6814.                containing values, or some combination of the two.
  6815.  
  6816.      Remarks   This function calculates the  average, or mean, of the  values in
  6817.                list.
  6818.  
  6819.                The @AVG function  will completely ignore  all items in the  list
  6820.                which are text or blank.  This means  that if a text string is in
  6821.                a range  in list, you  do not have to  worry about it  being used
  6822.                incorrectly in the calculation.
  6823.  
  6824.      Example   =@AVG(0,1,2,3,4,5,6,7,8,9) = 4.5
  6825.  
  6826.                If the cells A1;1 through A10;1  contain the values listed above,
  6827.                then
  6828.  
  6829.                =@AVG(A1;1..A10;1) = 4.5
  6830.  
  6831.                =@AVG(1234,6435,2567) = 3412
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.  
  6839.  
  6840.  
  6841.  
  6842.  
  6843.  
  6844.  
  6845.  
  6846.  
  6847.  
  6848.  
  6849.  
  6850.  
  6851.  
  6852.  
  6853.  
  6854.  
  6855.  
  6856.  
  6857.  
  6858.  
  6859.  
  6860.                                          100
  6861.  
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.  
  6870.  
  6871.  
  6872.  
  6873.      --------------------------------------------------------------------------
  6874.      @CELL                                                                  Data
  6875.      --------------------------------------------------------------------------
  6876.      Function  Returns information about a cell.
  6877.  
  6878.      Syntax    @CELL(attribute,range)
  6879.                where attribute is  a string in  quotations or a cell  reference;
  6880.                and range is a cell range, named or otherwise.
  6881.  
  6882.      Remarks   This function returns  information about the  upper left cell  in
  6883.                range.  Although the information is only for a single cell, range
  6884.                must be  entered as a range instead of  a single cell.  Attribute
  6885.                must  be  one   of  the  following  strings:   "address",  "col",
  6886.                "contents", "format",  "page",  "prefix",  "protect",  "row",  or
  6887.                "type".  @CELL is primarily for  use in applications to determine
  6888.                certain characteristics about a cell.
  6889.  
  6890.                attribute      @CELL returns
  6891.                "address"      the name of the cell (for example B5;1)
  6892.  
  6893.                "col"          the column number of the cell (1 through 512)
  6894.  
  6895.                "contents"     the contents of the cell
  6896.  
  6897.                "format"       the formatting of the cell
  6898.                                    0 Default
  6899.                                    1 Fixed
  6900.                                    2 Currency
  6901.                                    3 Percent
  6902.                                    4 Scientific
  6903.                                    5 Hidden
  6904.                                    6 Text
  6905.                                    7 Fixed with commas
  6906.                                    8 Currency with commas
  6907.                                    9 Percent with commas
  6908.                                    10 dd-mmm-yy
  6909.                                    11 dd-mmm
  6910.                                    12 mmm-yy
  6911.                                    13 mm/dd/yy
  6912.                                    14 Month DD, YYYY
  6913.                                    15 HH:MM AM/PM
  6914.                                    16 HH:MM Military
  6915.                                    17 General
  6916.  
  6917.                "page"         the page number of the cell (1 through 512)
  6918.  
  6919.                "prefix"       the justification character of the cell
  6920.                               ' if left justified
  6921.                               " if right justified
  6922.                               ^ if centered
  6923.                               blank if the cell doesn't contain text
  6924.  
  6925.  
  6926.                                          101
  6927.  
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.                "protect"      the protection status of the cell
  6940.                                    0 = Not protected, 1 = Protected
  6941.  
  6942.                "row"          the row number of the cell (1 through 512)
  6943.  
  6944.                "type"         the type of data in the cell
  6945.                                    BLANK
  6946.                                    FORMAT
  6947.                                    NUMBER
  6948.                                    TEXT
  6949.                                    FORMULA
  6950.                                    TXTFORM
  6951.                                    ERROR
  6952.  
  6953.  
  6954.      Example   If cell A1;1 contains centered text:
  6955.  
  6956.                =@CELL("type",A1;1..A1;1) = "TEXT"
  6957.  
  6958.                =@CELL("prefix",A1;1..A1;1) = ^
  6959.  
  6960.                =@CELL("type",A1;1) = ERROR  because the second argument  must be
  6961.                entered as a range instead of a single cell reference.
  6962.  
  6963.  
  6964.                If cell B5;1 contains a value formatted as currency, then:
  6965.  
  6966.                =@CELL("type",B5;1..B5;1) = "NUMBER"
  6967.  
  6968.                =@CELL("format",B5;1..B5;1) = 2
  6969.  
  6970.                =@CELL("row",B5;1..B5;1) = 5
  6971.  
  6972.  
  6973.  
  6974.  
  6975.  
  6976.  
  6977.  
  6978.  
  6979.  
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.  
  6992.                                          102
  6993.  
  6994.  
  6995.  
  6996.  
  6997.  
  6998.  
  6999.  
  7000.  
  7001.  
  7002.  
  7003.  
  7004.  
  7005.      --------------------------------------------------------------------------
  7006.      @CHAR                                                                String
  7007.      --------------------------------------------------------------------------
  7008.      Function  Returns a character, based on its ASCII value.
  7009.  
  7010.      Syntax    @CHAR(x)
  7011.                where x is a number, a cell address, or a calculated value.
  7012.  
  7013.      Remarks   This function returns the  ASCII character for the value  x.  The
  7014.                value of x must lie in the range 1 to 255.
  7015.  
  7016.      Example   =@CHAR(42) = *
  7017.                =@CHAR(55) = 7
  7018.                =@CHAR(80) = P
  7019.                =@CHAR(113) = q
  7020.  
  7021.  
  7022.  
  7023.      --------------------------------------------------------------------------
  7024.      @CHOOSE                                                                Data
  7025.      --------------------------------------------------------------------------
  7026.      Function  Choose an item from a list.
  7027.  
  7028.      Syntax    @CHOOSE(x,y1,y2,y3...yn)
  7029.                where x  is an offset value, and y1...yn  is the list of items to
  7030.                choose from.
  7031.  
  7032.      Remarks   This function performs  a simple lookup based on the  value of x.
  7033.                If x has a  value of 1, then @CHOOSE  will return y1; if x  has a
  7034.                value of 2, then @CHOOSE will return y2, and so on.  The items in
  7035.                the list can be numeric, text, or both.
  7036.  
  7037.                If x is less than  1 or greater than the  number of items in  the
  7038.                list, then @CHOOSE will return the value ERROR.
  7039.  
  7040.      See Also  @HLOOKUP, @VLOOKUP, @PLOOKUP, @ELOOKUP
  7041.  
  7042.      Example   If A1;1 contains the value 3, then
  7043.  
  7044.                @CHOOSE(A1;1,"Sun","Mon","Tue","Wed","Thu","Fri","Sat")=Tue
  7045.  
  7046.                and
  7047.  
  7048.                =@CHOOSE(A1;1,23,"Item 2",17) = 17
  7049.  
  7050.                =@CHOOSE(4,"Item 1","Item 2","Item 3") = ERROR
  7051.  
  7052.  
  7053.  
  7054.  
  7055.  
  7056.  
  7057.  
  7058.                                          103
  7059.  
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.  
  7067.  
  7068.  
  7069.  
  7070.  
  7071.      --------------------------------------------------------------------------
  7072.      @CODE                                                                String
  7073.      --------------------------------------------------------------------------
  7074.      Function  Returns the ASCII value of a character.
  7075.  
  7076.      Syntax    @CODE(string)
  7077.                where string is a string in quotations, or a cell address.
  7078.  
  7079.      Remarks   This function returns the  ASCII value of the first  character in
  7080.                string.  If  the length of  string is zero, or  is not a  string,
  7081.                then @CODE will return the value ERROR.
  7082.  
  7083.      Example   =@CODE("Test") = 84
  7084.                =@CODE("test") = 116
  7085.                =@CODE("@") = 64
  7086.                =@CODE(" ") = 32
  7087.  
  7088.      --------------------------------------------------------------------------
  7089.      @COLS                                                                  Data
  7090.      --------------------------------------------------------------------------
  7091.      Function  Returns the number of columns in a block.
  7092.  
  7093.      Syntax    @COLS(block)
  7094.                where block is a cell range, either named or otherwise.
  7095.  
  7096.      Remarks   This function returns the number of columns in block.
  7097.  
  7098.      Example   If the block A1;1..G20;30 is named BUILDINGS then
  7099.  
  7100.                =@COLS(BUILDINGS) = 7
  7101.  
  7102.  
  7103.      --------------------------------------------------------------------------
  7104.      @COS                                                           Trigonometry
  7105.      --------------------------------------------------------------------------
  7106.      Function  Returns the cosine of an angle.
  7107.  
  7108.      Syntax    @COS(x)
  7109.                where x is a number, a cell address, or a calculated value.
  7110.  
  7111.      Remarks   This function returns  the cosine of the  angle x.  x  must be in
  7112.                radians.   If x  is in degrees,  then you  must use  the @RADIANS
  7113.                function to convert x to radians first.   The result of @COS will
  7114.                be between -1 and 1.
  7115.  
  7116.                Since the secant of an angle is simply the reciprocal of the @COS
  7117.                function, you can calculate the secant of an angle by dividing  1
  7118.                by the cosine of the angle.
  7119.  
  7120.      Example   =@COS(3)  = -0.9900
  7121.                =@COS(@PI)  = -1
  7122.                =@COS(@RADIANS(180)) = -1
  7123.  
  7124.                                          104
  7125.  
  7126.  
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.  
  7134.  
  7135.  
  7136.  
  7137.      --------------------------------------------------------------------------
  7138.      @COUNT                                                          Statistical
  7139.      --------------------------------------------------------------------------
  7140.      Function  Returns the number of values in a list.
  7141.  
  7142.      Syntax    @COUNT(list)
  7143.                where list is  a list of  items separated by  commas, or a  range
  7144.                containing values, or some combination of the two.
  7145.  
  7146.      Remarks   This function counts all of the cells in list which contain data.
  7147.                Blank  cells  in a  range are  not  counted, but  individual cell
  7148.                references are always counted, even if they are blank.
  7149.  
  7150.      Example   =@COUNT(0,1,2,3,4,5,6,7,8,9) = 10
  7151.  
  7152.                If range A1;1 to A10;1 contained a list of names, then
  7153.  
  7154.                =@COUNT(A1;1..A10;1) = 10
  7155.  
  7156.                If 5 of those cells were deleted, then
  7157.  
  7158.                =@COUNT(A1;1..A10;1) = 5
  7159.  
  7160.                and
  7161.  
  7162.                =@COUNT(A1;1..A10;1,C5;1) = 6, even if cell C5;1 is blank.
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.  
  7171.  
  7172.  
  7173.  
  7174.  
  7175.  
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  
  7189.  
  7190.                                          105
  7191.  
  7192.  
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.  
  7201.  
  7202.  
  7203.      --------------------------------------------------------------------------
  7204.      @CTERM                                                            Financial
  7205.      --------------------------------------------------------------------------
  7206.      Function  Returns the number of periods for an investment to reach a future
  7207.                value.
  7208.  
  7209.      Syntax    @CTERM(rate,fv,pv)
  7210.                where rate, fv and pv are  numbers, cell addresses, or calculated
  7211.                values.
  7212.  
  7213.      Remarks   This function returns  the number  of periods needed  to reach  a
  7214.                given  future value, using  a specified initial  investment and a
  7215.                periodic interest rate.
  7216.  
  7217.                rate is the periodic interest rate, fv is the future value  to be
  7218.                reached, and pv is the initial investment.
  7219.  
  7220.                @CTERM is often used in retirement planning, where a fixed amount
  7221.                of  money  (usually large)  is  necessary to  sustain retirement.
  7222.                @CTERM can  determine whether a  certain investment is  likely to
  7223.                reach the monetary goal in the necessary time period.
  7224.  
  7225.      Example   An investment is  likely to produce a  13% return.  The  investor
  7226.                needs $300,000,  and has $70,000  available to invest  right now.
  7227.                How long will it take to reach the goal?
  7228.  
  7229.                =@CTERM(0.13,300000,70000) = 11.90734 years
  7230.  
  7231.                The answer is returned  in the periods indicated by  the interest
  7232.                rate.   Thus, if you need to  know the number of months needed to
  7233.                reach the goal, divide the yearly interest rate by 12:
  7234.  
  7235.                =@CTERM(0.13/12,300000,70000) = 135.0605 months
  7236.  
  7237.  
  7238.  
  7239.  
  7240.  
  7241.  
  7242.  
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.  
  7249.  
  7250.  
  7251.  
  7252.  
  7253.  
  7254.  
  7255.  
  7256.                                          106
  7257.  
  7258.  
  7259.  
  7260.  
  7261.  
  7262.  
  7263.  
  7264.  
  7265.  
  7266.  
  7267.  
  7268.  
  7269.      --------------------------------------------------------------------------
  7270.      @DATE                                                             Date/Time
  7271.      --------------------------------------------------------------------------
  7272.      Function  Returns a date number for a date.
  7273.  
  7274.      Syntax    @DATE(year,month,day)
  7275.                where  year,  month,  and day  are  numbers,  cell addresses,  or
  7276.                calculated values.
  7277.  
  7278.      Remarks   This function returns the  date number for year, month,  and day.
  7279.                The date number is  the number of days from  Dec 31, 1899 to  the
  7280.                given date.  Formatting a cell containing a date number using the
  7281.                /Block Format Date commands will turn  the number into a readable
  7282.                date.  The  key use for all date commands is in date arithmetic--
  7283.                the determination of time between two periods.
  7284.  
  7285.                ProQube Lite also provides intelligent date entry, which  you may
  7286.                often  want to use  instead of @date.   When  entering dates into
  7287.                cells which have been formatted as date, you may type in the date
  7288.                directly  and  ProQube  Lite will  automatically  enter  the date
  7289.                number into the  cell.  For example,  if you type 4/15/89  into a
  7290.                cell which  has a date format,  ProQube Lite will enter  the date
  7291.                value 32703 into the cell.
  7292.  
  7293.      Example   How many days are between Jan. 16, 1959 and June 10, 1960?
  7294.  
  7295.                =@DATE(60,6,10)-@DATE(59,1,16) = 511.
  7296.  
  7297.  
  7298.                What date is 90 days after April 15, 1989?
  7299.  
  7300.                =@DATE(89,4,15)+90 = 32703
  7301.  
  7302.                Formatting this value as a date gives July 14, 1989.
  7303.  
  7304.  
  7305.  
  7306.  
  7307.  
  7308.  
  7309.  
  7310.  
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.  
  7317.  
  7318.  
  7319.  
  7320.  
  7321.  
  7322.                                          107
  7323.  
  7324.  
  7325.  
  7326.  
  7327.  
  7328.  
  7329.  
  7330.  
  7331.  
  7332.  
  7333.  
  7334.  
  7335.      --------------------------------------------------------------------------
  7336.      @DAY                                                              Date/Time
  7337.      --------------------------------------------------------------------------
  7338.      Function  The Day Function
  7339.  
  7340.      Syntax    @DAY(date number)
  7341.                where date number is a number, cell address, or calculated value.
  7342.  
  7343.      Remarks   This function returns the day of the month of date number.
  7344.  
  7345.                The @DAY function  is most often used to avoid  the often tedious
  7346.                process of looking  up dates; clearly,  it is possible to  simply
  7347.                look at  a cell  that is  formatted as  a date  to discover  what
  7348.                number is  the  day that  is  contained there.    Using the  @DAY
  7349.                function allows you  to bypass the lookup;  the function extracts
  7350.                the day automatically.
  7351.  
  7352.      Example   =@DAY(@DATE(89,1,16)) = 16
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.  
  7360.  
  7361.  
  7362.  
  7363.  
  7364.  
  7365.  
  7366.  
  7367.  
  7368.  
  7369.  
  7370.  
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.  
  7378.  
  7379.  
  7380.  
  7381.  
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.  
  7388.                                          108
  7389.  
  7390.  
  7391.  
  7392.  
  7393.  
  7394.  
  7395.  
  7396.  
  7397.  
  7398.  
  7399.  
  7400.  
  7401.      --------------------------------------------------------------------------
  7402.      @DDB                                                              Financial
  7403.      --------------------------------------------------------------------------
  7404.      Function  Returns the amount of depreciation of  an asset using the double-
  7405.                declining balance method.
  7406.  
  7407.      Syntax    @DDB(cost,salvage,life,period)
  7408.                where  cost,  salvage,   life,  and  period  are   numbers,  cell
  7409.                addresses, or calculated values.
  7410.  
  7411.      Remarks   This function calculates  the amount of depreciation  of an asset
  7412.                using   the  Double-Declining   Balance  method   of  accelerated
  7413.                depreciation.
  7414.  
  7415.                cost is the  cost of the asset,  salvage is the salvage  value of
  7416.                the asset after  it is  totally depreciated, life  is the  useful
  7417.                life of the asset, and period  is the period within that life  in
  7418.                which the depreciation is being calculated.
  7419.  
  7420.                The depreciation for a period is:
  7421.  
  7422.                (book value * 2) / life
  7423.  
  7424.  
  7425.                where the book value for a period is:
  7426.  
  7427.                cost - (total depreciation for all prior periods)
  7428.  
  7429.  
  7430.                The total  depreciation over  the life  of the  asset will  never
  7431.                exceed the assets cost - salvage value.
  7432.  
  7433.      Example   Your  company  purchased  a  piece of  equipment  last  year  for
  7434.                $40,000.  Its scrap value has been  determined to be $11,000, and
  7435.                its useful life is seven years.  How much  depreciation should be
  7436.                assigned to it in this, its second year of useful life?
  7437.  
  7438.                =@DDB(40000,11000,7,2) = $8,163.27
  7439.  
  7440.  
  7441.  
  7442.  
  7443.  
  7444.  
  7445.  
  7446.  
  7447.  
  7448.  
  7449.  
  7450.  
  7451.  
  7452.  
  7453.  
  7454.                                          109
  7455.  
  7456.  
  7457.  
  7458.  
  7459.  
  7460.  
  7461.  
  7462.  
  7463.  
  7464.  
  7465.  
  7466.  
  7467.      --------------------------------------------------------------------------
  7468.      @DEGREES                                                       Trigonometry
  7469.      --------------------------------------------------------------------------
  7470.      Function  Converts radians to degrees.
  7471.  
  7472.      Syntax    @DEGREES(x)
  7473.                where x is a number, a cell address, or a calculated value.  
  7474.  
  7475.      Remarks   Although all of ProQube Lite's  trigonometry functions operate on
  7476.                angular values  expressed  in  radians, it  is  often  easier  to
  7477.                analyze angular  data when  expressed in  degrees.   The @DEGREES
  7478.                function provides an easy way to convert  a value from radians to
  7479.                degrees.
  7480.  
  7481.      Example   If cell A1 were  a value in radians, and you  wanted its value in
  7482.                degrees, entering
  7483.  
  7484.                =@DEGREES(A1)
  7485.  
  7486.                would return the correct value in degrees.
  7487.  
  7488.                =@DEGREES(@PI) = 180
  7489.                =@DEGREES(@PI/2) = 90
  7490.  
  7491.  
  7492.  
  7493.      --------------------------------------------------------------------------
  7494.      @ERROR                                                                 Data
  7495.      --------------------------------------------------------------------------
  7496.      Function  Returns the value ERROR.
  7497.  
  7498.      Syntax    @ERROR
  7499.  
  7500.      Remarks   This function causes  the ERROR  flag to  appear in  the cell  in
  7501.                which it is entered.
  7502.  
  7503.                The @ERROR  function is  usually used  as an argument  in an  @IF
  7504.                function.  Often it is used to flag values that may be outside of
  7505.                a prescribed range.
  7506.  
  7507.      Example   This formula  will multiply B5 by 1.1,  unless B5 is greater than
  7508.                C5.  If this happens, it will flag you with an ERROR.
  7509.  
  7510.                =@IF(B5>C5,@ERROR,B5*1.1)
  7511.  
  7512.  
  7513.  
  7514.  
  7515.  
  7516.  
  7517.  
  7518.  
  7519.  
  7520.                                          110
  7521.  
  7522.  
  7523.  
  7524.  
  7525.  
  7526.  
  7527.  
  7528.  
  7529.  
  7530.  
  7531.  
  7532.  
  7533.      --------------------------------------------------------------------------
  7534.      @EXACT                                                               String
  7535.      --------------------------------------------------------------------------
  7536.      Function  Compares two text strings.
  7537.  
  7538.      Syntax    @EXACT(string1,string2)
  7539.                where  string1  and string2  are  strings in  quotations  or cell
  7540.                addresses.
  7541.  
  7542.      Remarks   This function returns the  value 1 (TRUE) if string1  and string2
  7543.                are identical, or the value 0 (FALSE) if they are not.
  7544.  
  7545.                Comparing two strings with the @EXACT function is different  than
  7546.                comparing them with  the = operator.   Strings compared with  the
  7547.                @EXACT function must be exactly the same for a TRUE result, while
  7548.                strings compared with the = operator may differ in case and still
  7549.                be considered equal.
  7550.  
  7551.      Example   If cell D80 contains the string ProQube Lite:
  7552.  
  7553.                =@EXACT("ProQube Lite",D80) = 1 (TRUE)
  7554.                =@EXACT("ProQube Lite",D80) = 0 (FALSE)
  7555.  
  7556.  
  7557.  
  7558.      --------------------------------------------------------------------------
  7559.      @EXP                                                           Mathematical
  7560.      --------------------------------------------------------------------------
  7561.      Function  Returns e raised to a power.
  7562.  
  7563.      Syntax    @EXP(x)
  7564.                where x is a number, a cell address, or a calculated value.
  7565.  
  7566.      Remarks   This  function  returns e  to the  x power.   e  is approximately
  7567.                2.71828.  x  must be less than 85.2 or an overflow will occur and
  7568.                the value ERROR  will be returned.  This  function is the inverse
  7569.                of  the @LN function.   To use the  value of e  in a formula, use
  7570.                @EXP(1).
  7571.  
  7572.      Example   =@EXP(3) = 20.0855
  7573.                =@EXP(90) = ERROR
  7574.                =@EXP(1) = 2.71828
  7575.                =@EXP(@LN(5)) = 5
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581.  
  7582.  
  7583.  
  7584.  
  7585.  
  7586.                                          111
  7587.  
  7588.  
  7589.  
  7590.  
  7591.  
  7592.  
  7593.  
  7594.  
  7595.  
  7596.  
  7597.  
  7598.  
  7599.      --------------------------------------------------------------------------
  7600.      @FACT                                                          Mathematical
  7601.      --------------------------------------------------------------------------
  7602.      Function  Returns the factorial of a number.
  7603.  
  7604.      Syntax    @FACT(x)
  7605.                where x is a number, a cell address, or a calculated value.
  7606.  
  7607.      Remarks   The factorial of x is x * (x-1) * (x-2)...* 1.
  7608.  
  7609.                x must  be between  0 and  30 (inclusive),  otherwise @FACT  will
  7610.                overflow and return ERROR.   x should be an integer; if it is not
  7611.                an  integer,  the program  will  use  the value  of  the argument
  7612.                rounded to the nearest integer.
  7613.  
  7614.      Example   =@FACT(5) = 5*4*3*2*1 = 120
  7615.                =@FACT(4.7) = 120
  7616.                =@FACT(45) = ERROR
  7617.  
  7618.  
  7619.  
  7620.      --------------------------------------------------------------------------
  7621.      @FALSE                                                              Logical
  7622.      --------------------------------------------------------------------------
  7623.      Function  Returns the value FALSE (0).
  7624.  
  7625.      Syntax    @FALSE
  7626.  
  7627.      Remarks   This function returns the value 0 (FALSE).
  7628.  
  7629.                The  primary  purpose of  the  @FALSE  function is  to  help make
  7630.                logical formulas easier to read.
  7631.  
  7632.      Example   @IF(B4;1>1,@TRUE,@FALSE)=0, if B4;1 is not greater than 1
  7633.  
  7634.  
  7635.  
  7636.  
  7637.  
  7638.  
  7639.  
  7640.  
  7641.  
  7642.  
  7643.  
  7644.  
  7645.  
  7646.  
  7647.  
  7648.  
  7649.  
  7650.  
  7651.  
  7652.                                          112
  7653.  
  7654.  
  7655.  
  7656.  
  7657.  
  7658.  
  7659.  
  7660.  
  7661.  
  7662.  
  7663.  
  7664.  
  7665.      --------------------------------------------------------------------------
  7666.      @FIND                                                                String
  7667.      --------------------------------------------------------------------------
  7668.      Function  Finds the occurrence of a string in a longer string.
  7669.  
  7670.      Syntax    @FIND(substring,string,n)
  7671.                where substring and  string are  strings in  quotations, or  cell
  7672.                addresses, and n is a number, cell address, or calculated value.
  7673.  
  7674.      Remarks   substring is the part  of a string to find, string  is the longer
  7675.                string in which to find the  substring, and n designates where in
  7676.                the string to begin looking.  The search is case-sensitive.
  7677.  
  7678.                @FIND returns  the position in  string where substring  is found.
  7679.                That is, if  substring begins  at the 20th  character string,  20
  7680.                will be returned.  If no match is found, @FIND returns a value of
  7681.                0.
  7682.  
  7683.      Example   To find the word  "time" in the phrase, "Now is the  time for all
  7684.                good men to come to the aid of their country,":
  7685.  
  7686.                If the longer string is entered in cell D2;1, then
  7687.  
  7688.                =@FIND("time",D2;1,1) = 12
  7689.  
  7690.                You  can also  search for the  second occurrence of  "the" in the
  7691.                above phrase with
  7692.  
  7693.                =@FIND("the",D2,15)
  7694.  
  7695.                ProQube Lite will  begin the  search at the  15th character,  and
  7696.                will return the position, 45.
  7697.  
  7698.  
  7699.  
  7700.      --------------------------------------------------------------------------
  7701.      @FRAC                                                          Mathematical
  7702.      --------------------------------------------------------------------------
  7703.      Function  Returns the fractional part of a number.
  7704.  
  7705.      Syntax    @FRAC(x)
  7706.                where x is a number, a cell address, or a calculated value.
  7707.  
  7708.      Remarks   This function  returns only the part  of x which comes  after the
  7709.                decimal point.   If x  is negative,  then the  value returned  by
  7710.                @FRAC will be negative also.
  7711.  
  7712.      Example   =@FRAC(1.23) = 0.23
  7713.                =@FRAC(-1.23) = -0.23
  7714.                =@FRAC(@PI) = 0.14159
  7715.  
  7716.  
  7717.  
  7718.                                          113
  7719.  
  7720.  
  7721.  
  7722.  
  7723.  
  7724.  
  7725.  
  7726.  
  7727.  
  7728.  
  7729.  
  7730.  
  7731.      --------------------------------------------------------------------------
  7732.      @FV                                                               Financial
  7733.      --------------------------------------------------------------------------
  7734.      Function  Returns the future value of an annuity.
  7735.  
  7736.      Syntax    @FV(pmt,int,term)
  7737.                where pmt, int, term  are numbers, cell addresses,  or calculated
  7738.                values.
  7739.  
  7740.      Remarks   This function calculates the future value of an annuity.
  7741.  
  7742.                pmt is the  amount of payment per  period in the annuity,  int is
  7743.                the discount  rate per period,  and term is  the total  number of
  7744.                payments to be made.
  7745.  
  7746.                @FV  assumes  that payments  are being  made  at the  end  of the
  7747.                period.   If payments  are due  at the  beginning of  the period,
  7748.                simply multiply the answer by (1+int).
  7749.  
  7750.                IMPORTANT:  The interest  rate must  be a per  period rate.   For
  7751.                example,  if  the  term  is  240, indicating  (probably)  monthly
  7752.                payments over  twenty years,  the interest  rate must  also be  a
  7753.                monthly rate.  Thus, a 12% yearly rate would be entered as 1%.
  7754.  
  7755.      Example   To calculate the future value of an ordinary annuity in which the
  7756.                payments are $500.00, made  monthly for 20 years, and  the yearly
  7757.                interest rate is 10%:
  7758.  
  7759.                =@FV(500,0.1/12,240) = 379,684.42
  7760.  
  7761.                =@FV(500,0.1/12,240)*(1+0.1/12) = 382,848.45
  7762.  
  7763.  
  7764.  
  7765.  
  7766.  
  7767.  
  7768.  
  7769.  
  7770.  
  7771.  
  7772.  
  7773.  
  7774.  
  7775.  
  7776.  
  7777.  
  7778.  
  7779.  
  7780.  
  7781.  
  7782.  
  7783.  
  7784.                                          114
  7785.  
  7786.  
  7787.  
  7788.  
  7789.  
  7790.  
  7791.  
  7792.  
  7793.  
  7794.  
  7795.  
  7796.  
  7797.      --------------------------------------------------------------------------
  7798.      @HLOOKUP                                                               Data
  7799.      --------------------------------------------------------------------------
  7800.      Function  Looks up an item in a horizontal lookup table.
  7801.  
  7802.      Syntax    @HLOOKUP(x,block,row offset,page offset)
  7803.                where block is a block  of cells, named or otherwise; row  offset
  7804.                and  page  offset  are  numbers,  cell addresses,  or  calculated
  7805.                values; and  x is  a number,  text, cell  address, or  calculated
  7806.                value.
  7807.  
  7808.      Remarks   This  function  looks up  and retrieves  a value  or text  from a
  7809.                horizontal lookup table.  block is the block of cells which makes
  7810.                up the lookup table.
  7811.  
  7812.                If x  is text, @HLOOKUP will compare x with  each cell in the top
  7813.                row of block, and if a match is found, will move row offset rows,
  7814.                and page offset pages from  that cell, and will return the  value
  7815.                in the resulting cell.   If x does not match any  of the cells in
  7816.                the top row of block, then @HLOOKUP will return the value ERROR.
  7817.  
  7818.                If x is  a value instead  of text, @HLOOKUP  will compare x  with
  7819.                each cell  in the top row of block until it finds a cell which is
  7820.                greater than or equal  to x.  This means  that the values in  the
  7821.                top row of block must be in  ascending order for @HLOOKUP to work
  7822.                correctly.  If the value in the cell is equal to x, @HLOOKUP will
  7823.                consider  it a match.   If the  cell is greater  than x, @HLOOKUP
  7824.                will move back to the previous cell and consider it a match.  For
  7825.                example, if the values in the top row of block are 100, 200, 300,
  7826.                and  400, and the  value of x  is 250, then  @HLOOKUP will search
  7827.                until it reaches  300, and will then  move back and use  the cell
  7828.                containing 200  as the  match.  When  a match is  found, @HLOOKUP
  7829.                will move row offset rows, and  page offset pages from that cell,
  7830.                and will return the value in the resulting cell.  If x is smaller
  7831.                than the  first cell in  the top  row, @HLOOKUP  will return  the
  7832.                value ERROR. 
  7833.  
  7834.  
  7835.  
  7836.  
  7837.  
  7838.  
  7839.  
  7840.  
  7841.  
  7842.  
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.  
  7850.                                          115
  7851.  
  7852.  
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.  
  7859.  
  7860.  
  7861.  
  7862.  
  7863.      Example   1      A         B    C   D    E    F     
  7864.                  1                       1987 Sales
  7865.                  2
  7866.                  3            Jan  Feb  Mar  Apr  May
  7867.                  4  Joe       1234 2011 1893 1500 1438
  7868.                  5  Bill      2102 1453 2415 1627 1888
  7869.                  6  David     1845 1739 2194 1999 2003
  7870.                  7  Mike      2340 2112 1693 1429 2236
  7871.                  8
  7872.                  9
  7873.  
  7874.                =@HLOOKUP("Feb",B3;1..F7;1,3,0) will compare the value "Feb" with
  7875.                each cell in the  top row of the range B3;1..F7;1  until it finds
  7876.                the match in cell C3;1.  It then  moves down 3 rows to cell C6;1.
  7877.                Since page  offset is  0, @HLOOKUP  does not move  up to  another
  7878.                page.  So  @HLOOKUP in  this case equals  1739 (David's  February
  7879.                1987 sales).
  7880.  
  7881.                =@HLOOKUP("Feb",B3;1..F7;4,3,1)  =  David's  February 1988  sales
  7882.                from page 2)
  7883.  
  7884.                =@HLOOKUP("Apr",B3;1..F7;1,1,0) = 1500
  7885.  
  7886.                =@HLOOKUP("Mar",B3;1..F7;1,0,0) = Mar
  7887.  
  7888.  
  7889.  
  7890.  
  7891.  
  7892.  
  7893.  
  7894.  
  7895.  
  7896.  
  7897.  
  7898.  
  7899.  
  7900.  
  7901.  
  7902.  
  7903.  
  7904.  
  7905.  
  7906.  
  7907.  
  7908.  
  7909.  
  7910.  
  7911.  
  7912.  
  7913.  
  7914.  
  7915.  
  7916.                                          116
  7917.  
  7918.  
  7919.  
  7920.  
  7921.  
  7922.  
  7923.  
  7924.  
  7925.  
  7926.  
  7927.  
  7928.  
  7929.      --------------------------------------------------------------------------
  7930.      @HOUR                                                             Date/Time
  7931.      --------------------------------------------------------------------------
  7932.      Function  Returns the hour of a time number.
  7933.  
  7934.      Syntax    @HOUR(time number)
  7935.                where time number is a number, cell address, or calculated value.
  7936.  
  7937.      Remarks   This  function returns the  hour of time  number.  A  result of 0
  7938.                represents midnight, 1  represents 1:00  p.m., and 23  represents
  7939.                11:00 p.m.
  7940.  
  7941.                time number should be a value between 0 and 1.  ProQube Lite will
  7942.                not ignore  a mixed  number; it  will simply  use the  fractional
  7943.                part.
  7944.  
  7945.                The @HOUR function is  most often used in conjunction  with other
  7946.                date  and time functions  to return  only the  hour portion  of a
  7947.                previously entered value.  
  7948.  
  7949.      Example   =@HOUR(@NOW) = the current hour (in military time)
  7950.                =@HOUR(@TIME(13,40,55)) = 13
  7951.  
  7952.  
  7953.  
  7954.  
  7955.  
  7956.  
  7957.  
  7958.  
  7959.  
  7960.  
  7961.  
  7962.  
  7963.  
  7964.  
  7965.  
  7966.  
  7967.  
  7968.  
  7969.  
  7970.  
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.                                          117
  7983.  
  7984.  
  7985.  
  7986.  
  7987.  
  7988.  
  7989.  
  7990.  
  7991.  
  7992.  
  7993.  
  7994.  
  7995.      --------------------------------------------------------------------------
  7996.      @IF                                                                 Logical
  7997.      --------------------------------------------------------------------------
  7998.      Function  Returns one of two values depending on a condition.
  7999.  
  8000.      Syntax    @IF(condition,x,y)
  8001.                where condition is a conditional statement,  often in the form of
  8002.                an equation, other times in the form of a "greater than" or "less
  8003.                than" statement (or  other inequality); and  x and y are  values,
  8004.                functions, or strings.
  8005.  
  8006.      Remarks   This functions evaluates condition  and returns x if it  is TRUE,
  8007.                and y if it is FALSE.
  8008.  
  8009.                @IF is  one of the most powerful ProQube  Lite functions.  It not
  8010.                only evaluates whether a  condition exists, it also  takes action
  8011.                depending on  the existence  or non-existence  of the  condition.
  8012.                More importantly, conditions can be built which are very complex,
  8013.                and  may  incorporate the  Boolean  operators  (&, |,  and  ~) in
  8014.                addition  to the  logical operators.   Nested  @IF functions  are
  8015.                allowed.
  8016.  
  8017.                x and y may be both numeric, both text, or one of each.
  8018.  
  8019.      Example   If  the  price/earnings ratio  of  Micro Solutions,  Inc.'s stock
  8020.                (located in cell  D54;1) falls below 17,  it is time to  sell (in
  8021.                your opinion).  If your spreadsheet  contains a number of stocks,
  8022.                you may not  want to look  down the P/E  column to evaluate  each
  8023.                ratio.  Instead, you enter this formula in a nearby cell on Micro
  8024.                Solutions' row:
  8025.  
  8026.                =@IF(D54;1<17," ","SELL")
  8027.  
  8028.                When the P/E ratio falls below 17, SELL will appear in that cell.
  8029.  
  8030.                =@IF(A1;1<1,A1;1*1.1,"Past due") = 1.1 or  Past due, depending on
  8031.                the value of A1;1.
  8032.  
  8033.  
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.  
  8042.  
  8043.  
  8044.  
  8045.  
  8046.  
  8047.  
  8048.                                          118
  8049.  
  8050.  
  8051.  
  8052.  
  8053.  
  8054.  
  8055.  
  8056.  
  8057.  
  8058.  
  8059.  
  8060.  
  8061.      --------------------------------------------------------------------------
  8062.      @INDEX                                                                 Data
  8063.      --------------------------------------------------------------------------
  8064.      Function  Looks up data in a 3D array.
  8065.  
  8066.      Syntax    @INDEX(block,col,row,page)
  8067.                where  block is a  block of cells,  named or  otherwise; and col,
  8068.                row, and page are numbers, cell addresses, or calculated values.
  8069.  
  8070.      Remarks   This function looks up  and returns data from a 3D  array.  block
  8071.                is the 3D array, and col, row, and page are the offsets into  the
  8072.                array.  The  top row of  block has a  row offset of  0, the  left
  8073.                column of block has a column offset  of 0, and the first page  of
  8074.                block has a page offset of 0.
  8075.  
  8076.                col, row, and  page refer  to the column,  row, and page  offsets
  8077.                relative to the  front face.  If  you are viewing your  data from
  8078.                one  of  the other  faces,  the  offset arguments  will  still be
  8079.                relative  to  the front  face.    This insures  that  @INDEX will
  8080.                provide the same result regardless of which face you happen to be
  8081.                viewing.
  8082.  
  8083.      See Also  @HLOOKUP
  8084.  
  8085.      Example   1      A         B   C    D    E    F     
  8086.                  1                       1987 Sales
  8087.                  2
  8088.                  3            Jan  Feb  Mar  Apr  May
  8089.                  4  Joe       1234 2011 1893 1500 1438
  8090.                  5  Bill      2102 1453 2415 1627 1888
  8091.                  6  David     1845 1739 2194 1999 2003
  8092.                  7  Mike      2340 2112 1693 1429 2236
  8093.                  8
  8094.                  9
  8095.  
  8096.                @INDEX(A3;1..F7;1,2,3,0)  will  start at  the  first cell  in the
  8097.                block (A3;1),  and will move across 2 columns (to column C), down
  8098.                3 rows  (to row 6), and  in 0 pages.   It then returns  the value
  8099.                from  that cell  (C6;1).   So  @INDEX in  this  case equals  1739
  8100.                (David's February 1987 sales).
  8101.  
  8102.                @INDEX(A3;1..F7;4,2,3,1) = David's Feb 1988 sales from page 2
  8103.  
  8104.                @INDEX(A3;1..F7;1,4,0,0) = Apr
  8105.  
  8106.  
  8107.  
  8108.  
  8109.  
  8110.  
  8111.  
  8112.  
  8113.  
  8114.                                          119
  8115.  
  8116.  
  8117.  
  8118.  
  8119.  
  8120.  
  8121.  
  8122.  
  8123.  
  8124.  
  8125.  
  8126.  
  8127.      --------------------------------------------------------------------------
  8128.      @INT                                                           Mathematical
  8129.      --------------------------------------------------------------------------
  8130.      Function  Returns the integer part of a number.
  8131.  
  8132.      Syntax    @INT(x)
  8133.                where x is a number, a cell address, or a calculated value.
  8134.  
  8135.      Remarks   This function returns the  integer part of a value,  which is the
  8136.                part of  the argument  which is  to the  left (in  front of)  the
  8137.                decimal point.   The sign  of the value  returned is the  same as
  8138.                that of the argument.
  8139.  
  8140.                The @INT  function does not round values for further calculation.
  8141.                (To round numbers, use @ROUND.)  It merely truncates the numbers;
  8142.                only  the  integer  part   of  the  value  is  used   in  further
  8143.                calculations.   The sign of the  value can be either  positive or
  8144.                negative.  
  8145.  
  8146.      Example   =@INT(-2.34) = -2
  8147.                =@INT(1.2) = 1
  8148.                =@INT(1.99) = 1
  8149.                =@INT(@PI) = 3
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.  
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.  
  8173.  
  8174.  
  8175.  
  8176.  
  8177.  
  8178.  
  8179.  
  8180.                                          120
  8181.  
  8182.  
  8183.  
  8184.  
  8185.  
  8186.  
  8187.  
  8188.  
  8189.  
  8190.  
  8191.  
  8192.  
  8193.      --------------------------------------------------------------------------
  8194.      @IRR                                                              Financial
  8195.      --------------------------------------------------------------------------
  8196.      Function  Returns the internal rate of return of a series of cash flows.
  8197.  
  8198.      Syntax    @IRR(estimate,range)
  8199.                where estimate is  a number, cell  address, or calculated  value;
  8200.                and range is a block of cells, named or otherwise.
  8201.  
  8202.      Remarks   This  function calculates the discount  rate at which the present
  8203.                value of an outlay (investment) equals  the present value of cash
  8204.                inflows stemming (presumably) from that  investment.  Another way
  8205.                of saying this is that it is  the discount rate at which the  net
  8206.                present value of outlays and inflows is zero.
  8207.  
  8208.                estimate should  be a  value between  0 and  1 that represents  a
  8209.                reasonable guess at  the rate of  return for the investment,  and
  8210.                range is  a  range of  cells  that  contain the  net  cash  flows
  8211.                resulting from the investment.  The first value in the range must
  8212.                be negative, indicating an investment  was made which constituted
  8213.                an outflow of moneys.
  8214.  
  8215.                It is assumed  that the cash flows  that appear in the  range are
  8216.                received  at regular intervals.  They  need not be even, but they
  8217.                should at least approximate regular flows.  
  8218.  
  8219.                The  @IRR  function further  assumes  that  the  income from  the
  8220.                investment is reinvested at the rate of  return.  If this not the
  8221.                case (as with a capital investment in plant equipment), @IRR will
  8222.                be  overstated.    The  amount of  overstatement  depends  on the
  8223.                disparity between the assumed reinvestment and the actual rate of
  8224.                reinvestment.
  8225.  
  8226.                Finally, since @IRR  is calculated  by iteration,  a really  poor
  8227.                estimate may cause the function to misstate the discount rate.
  8228.  
  8229.  
  8230.  
  8231.  
  8232.  
  8233.  
  8234.  
  8235.  
  8236.  
  8237.  
  8238.  
  8239.  
  8240.  
  8241.  
  8242.  
  8243.  
  8244.  
  8245.  
  8246.                                          121
  8247.  
  8248.  
  8249.  
  8250.  
  8251.  
  8252.  
  8253.  
  8254.  
  8255.  
  8256.  
  8257.  
  8258.  
  8259.      Example   1      A         B       C       D       E       F     
  8260.                  1    -2000
  8261.                  2      700
  8262.                  3      700
  8263.                  4      700
  8264.                  5      700
  8265.                  6
  8266.  
  8267.  
  8268.                Cell A1 contains  the value -2,000  (indicating an investment  of
  8269.                $2000), and  cells A2  to A5  contain the  value 700  (indicating
  8270.                periodic receipts of $700),  then, using a 20% rate of  return as
  8271.                our guess, we enter:
  8272.  
  8273.                =@IRR(0.2,A1;1..A5;1) = 14.96%
  8274.  
  8275.  
  8276.  
  8277.  
  8278.  
  8279.  
  8280.  
  8281.  
  8282.  
  8283.  
  8284.  
  8285.  
  8286.  
  8287.  
  8288.  
  8289.  
  8290.  
  8291.  
  8292.  
  8293.  
  8294.  
  8295.  
  8296.  
  8297.  
  8298.  
  8299.  
  8300.  
  8301.  
  8302.  
  8303.  
  8304.  
  8305.  
  8306.  
  8307.  
  8308.  
  8309.  
  8310.  
  8311.  
  8312.                                          122
  8313.  
  8314.  
  8315.  
  8316.  
  8317.  
  8318.  
  8319.  
  8320.  
  8321.  
  8322.  
  8323.  
  8324.  
  8325.      --------------------------------------------------------------------------
  8326.      @ISERR                                                              Logical
  8327.      --------------------------------------------------------------------------
  8328.      Function  Tests whether an item is an error.
  8329.  
  8330.      Syntax    @ISERR(x)
  8331.                where x is a cell reference or a formula.
  8332.  
  8333.      Remarks   This  function is used to determine whether x is the value ERROR.
  8334.                @ISERR is  used to  stop ERROR  values from  carrying through  to
  8335.                other parts of the worksheet.
  8336.  
  8337.      Example   @ISERR(1/0) = 1 (TRUE)
  8338.  
  8339.                @ISERR(A1;1) = 1 if cell A1;1 contains the value ERROR; otherwise
  8340.                it equals 0.
  8341.  
  8342.  
  8343.      --------------------------------------------------------------------------
  8344.      @ISNUM                                                              Logical
  8345.      --------------------------------------------------------------------------
  8346.      Function  Tests whether an item is a number.
  8347.  
  8348.      Syntax    @ISNUM(x)
  8349.                where x is a cell address or a formula.
  8350.  
  8351.      Remarks   This function  returns the  value 1  (TRUE) if  x is a  numerical
  8352.                value; otherwise it returns the value 0 (FALSE).
  8353.  
  8354.      Example   @ISNUM(1) = 1 (TRUE)
  8355.  
  8356.                @ISNUM("text") = 0 (FALSE)
  8357.  
  8358.                @ISNUM(A1;1) = 1 if cell A1;1 contains a numeric value; otherwise
  8359.                it equals 0.
  8360.  
  8361.  
  8362.      --------------------------------------------------------------------------
  8363.      @ISTEXT                                                             Logical
  8364.      --------------------------------------------------------------------------
  8365.      Function  Tests whether an item is text.
  8366.  
  8367.      Syntax    @ISTEXT(x)
  8368.                where x is a cell address or a formula.
  8369.  
  8370.      Remarks   This function returns the value 1 (TRUE) if x is a textual value;
  8371.                otherwise it returns the value 0 (FALSE).
  8372.  
  8373.      Example   @ISTEXT(1) = 0 (FALSE)
  8374.  
  8375.                @ISTEXT("text") = 1 (TRUE)
  8376.  
  8377.  
  8378.                                          123
  8379.  
  8380.  
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386.  
  8387.  
  8388.  
  8389.  
  8390.  
  8391.      --------------------------------------------------------------------------
  8392.      @LEFT                                                                String
  8393.      --------------------------------------------------------------------------
  8394.      Function  Returns the left part of a text string.
  8395.  
  8396.      Syntax    @LEFT(string,n)
  8397.                where string is a string in quotations,  or a cell address; and n
  8398.                is a number, cell address, or calculated value.
  8399.  
  8400.      Remarks   This function returns the leftmost n characters from string.
  8401.  
  8402.                @LEFT  is often used  when extracting  portions of  a string--for
  8403.                example, an area code or the first digits of a billing code.
  8404.  
  8405.      Example   If cell B225;1 contains the telephone number of a client, and you
  8406.                want to retrieve only the area code, then use:
  8407.  
  8408.                =@LEFT(B225;1,5)
  8409.  
  8410.                If your client's phone number is (208)555-1212, @LEFT will return
  8411.                (208)
  8412.  
  8413.  
  8414.  
  8415.      --------------------------------------------------------------------------
  8416.      @LEN                                                                 String
  8417.      --------------------------------------------------------------------------
  8418.      Function  Returns the length of a text string.
  8419.  
  8420.      Syntax    @LEN(string)
  8421.                where string is a string in quotations, or a cell address.
  8422.  
  8423.      Remarks   This function returns the number of characters in string.
  8424.  
  8425.      Example   If cell A5;1  contains 'Goodbye and  B9;1 contains ' cruel  world
  8426.                then
  8427.  
  8428.                =@LEN(A5;1) = 7
  8429.  
  8430.                =@LEN(B9;1) = 12
  8431.  
  8432.                =@LEN(A5;1+B9:1) = 19
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.  
  8439.  
  8440.  
  8441.  
  8442.  
  8443.  
  8444.                                          124
  8445.  
  8446.  
  8447.  
  8448.  
  8449.  
  8450.  
  8451.  
  8452.  
  8453.  
  8454.  
  8455.  
  8456.  
  8457.      --------------------------------------------------------------------------
  8458.      @LN                                                            Mathematical
  8459.      --------------------------------------------------------------------------
  8460.      Function  Returns the natural logarithm of a number.
  8461.  
  8462.      Syntax    @LN(x)
  8463.                where x is a number, a cell address, or a calculated value.
  8464.  
  8465.      Remarks   This function calculates the natural logarithm (base e) of x.  It
  8466.                is  the  inverse of  the  @EXP  function.   The  value cannot  be
  8467.                negative or equal to zero, or an ERROR value will be returned.
  8468.  
  8469.      Example   =@LN(1000) = 6.9078
  8470.  
  8471.                =@LN(@EXP(3)) = 3   since  @LN  is  the   inverse  of  the   @EXP
  8472.                                    function.
  8473.  
  8474.  
  8475.      --------------------------------------------------------------------------
  8476.      @LOG                                                           Mathematical
  8477.      --------------------------------------------------------------------------
  8478.      Function  Returns the common logarithm of a number.
  8479.  
  8480.      Syntax    @LOG(x)
  8481.                where x is a number, a cell address, or a calculated value.
  8482.  
  8483.  
  8484.      Remarks   The @LOG function returns  the logarithm of x.  It  uses the base
  8485.                10, and is the reciprocal  of exponentiation.  The value must  be
  8486.                greater than  zero; a  negative or  zero value  returns an  ERROR
  8487.                value.
  8488.  
  8489.      Example   =@LOG(1000) = 3
  8490.                =@LOG(10^5) = 5
  8491.                =@LOG(-12) = ERROR
  8492.  
  8493.  
  8494.      --------------------------------------------------------------------------
  8495.      @LOWER                                                               String
  8496.      --------------------------------------------------------------------------
  8497.      Function  Converts all the characters of a text string to lowercase.
  8498.  
  8499.      Syntax    @LOWER(string)
  8500.                where string is a string in quotations, or a cell address.
  8501.  
  8502.      Remarks   The @LOWER function converts  all of the characters in  string to
  8503.                lowercase letters.
  8504.  
  8505.      Example   If A1;1 contains the text "Instruction Manual", then
  8506.  
  8507.                =@LOWER(A1;1) = instruction manual
  8508.  
  8509.  
  8510.                                          125
  8511.  
  8512.  
  8513.  
  8514.  
  8515.  
  8516.  
  8517.  
  8518.  
  8519.  
  8520.  
  8521.  
  8522.  
  8523.      --------------------------------------------------------------------------
  8524.      @MAX                                                            Statistical
  8525.      --------------------------------------------------------------------------
  8526.      Function  Returns the maximum value from a list of values.
  8527.  
  8528.      Syntax    @MAX(list)
  8529.                where list is  a list of values  separated by commas, or  a range
  8530.                containing values, or some combination of the two.
  8531.  
  8532.      Remarks   This function returns the largest value in list.
  8533.  
  8534.                When lists become  very large,  it becomes useful  to easily  and
  8535.                quickly  determine  the largest  value  in  the list.    The @MAX
  8536.                function  accommodates  this  need.   Blank  and  text  cells are
  8537.                ignored by @MAX.  If  the list consists entirely of  blank cells,
  8538.                the value ERROR will  be returned, because you can't  determine a
  8539.                maximum of no values.
  8540.  
  8541.      Example   =@MAX(0,1,2,3,4,5,6,7,8,9)  = 9
  8542.  
  8543.                If cells  A1 to  A10 contained those  values, but in  a different
  8544.                order, the formula 
  8545.  
  8546.                =@MAX(A1..A10)  would still return the value 9.
  8547.  
  8548.  
  8549.      --------------------------------------------------------------------------
  8550.      @MID                                                                 String
  8551.      --------------------------------------------------------------------------
  8552.      Function  Returns the midsection of a text string.
  8553.  
  8554.      Syntax    @MID(string,start,n)
  8555.                where string  is a string in  quotations, or a cell  address; and
  8556.                start and n are numbers, cell addresses, or calculated values. 
  8557.  
  8558.  
  8559.      Remarks   This function searches string, starting with the start character,
  8560.                and extracts and  returns n  characters.  @MID  can be useful  in
  8561.                extracting strings from known positions in a larger string.  More
  8562.                useful  still,  @MID  can  be  combined  with  @FIND  to  extract
  8563.                characters from the middle of strings.
  8564.  
  8565.      Example   Column A contains  a list of customer  phone numbers.   For local
  8566.                numbers, no area code is listed.  For other numbers, an area code
  8567.                is included.   You want to create  customer numbers by using  the
  8568.                last digit of the telephone prefix, and the first three digits of
  8569.                the telephone number.  You can find it using the formula:
  8570.  
  8571.                =@MID(A1;1,@FIND("-",A1;1,1)-1,5)
  8572.  
  8573.                If the telephone  number were  (208)882-8656, ProQube Lite  would
  8574.                return the string 2-865.
  8575.  
  8576.                                          126
  8577.  
  8578.  
  8579.  
  8580.  
  8581.  
  8582.  
  8583.  
  8584.  
  8585.  
  8586.  
  8587.  
  8588.  
  8589.      --------------------------------------------------------------------------
  8590.      @MIN                                                            Statistical
  8591.      --------------------------------------------------------------------------
  8592.      Function  Returns the minimum value from a list of values.
  8593.  
  8594.      Syntax    @MIN(list)
  8595.                where list is  a list of values  separated by commas, or  a range
  8596.                containing values, or some combination of the two.
  8597.  
  8598.      Remarks   This function returns the smallest value in list.
  8599.  
  8600.                When lists become  very large,  it becomes useful  to easily  and
  8601.                quickly  determine  the smallest  value in  the  list.   The @MIN
  8602.                function accommodates this need.
  8603.  
  8604.                Blank and text cells  are ignored.  If the list consists entirely
  8605.                of blank  cells, the  value ERROR  will be  returned because  you
  8606.                can't determine the minimum of no values.
  8607.  
  8608.      Example   =@MIN(0,1,2,3,4,5,6,7,8,9)  = 0
  8609.  
  8610.                If cells  A1 to A10  contained those  values, but in  a different
  8611.                order, the formula 
  8612.  
  8613.                =@MIN(A1..A10)  would still return the value 0.
  8614.  
  8615.  
  8616.  
  8617.      --------------------------------------------------------------------------
  8618.      @MINUTE                                                           Date/Time
  8619.      --------------------------------------------------------------------------
  8620.      Function  Returns the minute of a time number.
  8621.  
  8622.      Syntax    @MINUTE(time number)
  8623.                where time number is a number, cell address, or calculated value.
  8624.  
  8625.      Remarks   This function returns the number of the minute (between 0 and 59)
  8626.                represented by time number.
  8627.  
  8628.                time  number should be  a value between 0  and 1 (not inclusive).
  8629.                ProQube  Lite will  not  ignore mixed  numbers;  rather, it  will
  8630.                extract only the fractional part.
  8631.  
  8632.                @MINUTE is most often  useful in conjunction with other  date and
  8633.                time functions.  @MINUTE will extract  only the minute portion of
  8634.                a time value.
  8635.  
  8636.      Example   To find the current minute, and enter it into a cell, enter:
  8637.  
  8638.                =@MINUTE(@NOW)
  8639.  
  8640.                =@MINUTE(@TIME(10,20,30)) = 20
  8641.  
  8642.                                          127
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.  
  8654.  
  8655.      --------------------------------------------------------------------------
  8656.      @MOD                                                           Mathematical
  8657.      --------------------------------------------------------------------------
  8658.      Function  Returns the remainder after dividing two numbers.
  8659.  
  8660.      Syntax    @MOD(x,y)
  8661.                where x and y are numbers, cell addresses, or calculated values.
  8662.  
  8663.      Remarks   This function returns the remainder after dividing x by y.
  8664.  
  8665.                @MOD  function  will  typically  be  used  any time  that  it  is
  8666.                necessary to use the remainder in calculations.
  8667.  
  8668.                @MOD can be used to determine if x is odd or even by setting y to
  8669.                2.   If the result is 0, then x is even; if the result is 1, then
  8670.                x is odd.
  8671.  
  8672.                If y has a value of 0, ERROR will  be returned, since dividing by
  8673.                0 is illegal.
  8674.  
  8675.      Example   =@MOD(5,2) = 1
  8676.  
  8677.                =@MOD(6,2) = 0
  8678.  
  8679.                =@MOD(12,7) = 5
  8680.  
  8681.  
  8682.      --------------------------------------------------------------------------
  8683.      @MONTH                                                            Date/Time
  8684.      --------------------------------------------------------------------------
  8685.      Function  Returns the month of a date number.
  8686.  
  8687.      Syntax    @MONTH(date number)
  8688.                where date number is a number, cell address, or calculated value.
  8689.  
  8690.      Remarks   This  function returns  only the  month  portion (1..12)  of date
  8691.                number.
  8692.  
  8693.                Most often, the @MONTH function is used in conjunction with other
  8694.                date function.   @MONTH extracts  the month portion  of the  date
  8695.                given in its argument.
  8696.  
  8697.      Example   If the current month is April, then
  8698.  
  8699.                =@MONTH(@NOW) = 4
  8700.  
  8701.                =@MONTH(@DATE(89,11,3)) = 11
  8702.  
  8703.  
  8704.  
  8705.  
  8706.  
  8707.  
  8708.                                          128
  8709.  
  8710.  
  8711.  
  8712.  
  8713.  
  8714.  
  8715.  
  8716.  
  8717.  
  8718.  
  8719.  
  8720.  
  8721.      --------------------------------------------------------------------------
  8722.      @NOW                                                              Date/Time
  8723.      --------------------------------------------------------------------------
  8724.      Function  Returns the current date and time numbers.
  8725.  
  8726.      Syntax    @NOW
  8727.  
  8728.      Remarks   This function reads the system clock  and returns a combined date
  8729.                and time number for the current date and time.  The  integer part
  8730.                of the result will  be the date number for the  current date, and
  8731.                the fractional part of the result will be the time number for the
  8732.                current time.
  8733.  
  8734.                If your system does not have a clock, you must respond  correctly
  8735.                to  the DOS DATE  and TIME requests  to have the  proper date and
  8736.                time returned by the @NOW function.
  8737.  
  8738.                @NOW is often used in a reference by the other ProQube  Lite date
  8739.                and time functions to supply the current date, month, year, hour,
  8740.                etc.   Any recalculation which affects the cell in which the @NOW
  8741.                function is located  will cause the current  date and time  to be
  8742.                re-entered into the cell.
  8743.  
  8744.      Example   If it is currently 2:13 p.m. on May 10, 1989, then
  8745.  
  8746.                =@MONTH(@NOW) = 5
  8747.  
  8748.                =@DAY(@NOW) = 10
  8749.  
  8750.                =@YEAR(@NOW) = 89
  8751.  
  8752.                =@HOUR(@NOW) = 14 (military time for 2 p.m.)
  8753.  
  8754.                =@MINUTE(@NOW) = 13
  8755.  
  8756.  
  8757.  
  8758.  
  8759.  
  8760.  
  8761.  
  8762.  
  8763.  
  8764.  
  8765.  
  8766.  
  8767.  
  8768.  
  8769.  
  8770.  
  8771.  
  8772.  
  8773.  
  8774.                                          129
  8775.  
  8776.  
  8777.  
  8778.  
  8779.  
  8780.  
  8781.  
  8782.  
  8783.  
  8784.  
  8785.  
  8786.  
  8787.      --------------------------------------------------------------------------
  8788.      @NPV                                                              Financial
  8789.      --------------------------------------------------------------------------
  8790.      Function  Returns the net present value of a series of future cash flows.
  8791.  
  8792.      Syntax    @NPV(int,block)
  8793.                where int is a number, a cell address, or a calculated value, and
  8794.                block is a block of cells, named or otherwise.
  8795.  
  8796.      Remarks   This function calculates  the net  present value of  a series  of
  8797.                future cash flows in range, given the discount rate int.  Each of
  8798.                the future cash flows  are brought back to the present;  that is,
  8799.                each flow receives its equivalent present value.
  8800.  
  8801.                The period of the discount must agree with the period of the cash
  8802.                flows.  That  is, if the  cash flows are  yearly flows, then  the
  8803.                discount  rate must  be  a yearly  rate; if  the  cash flows  are
  8804.                monthly, then the discount rate must be monthly.
  8805.  
  8806.                Generally, yearly cash  flows will be  accurate enough.  Even  if
  8807.                the flows  actually come  on a  monthly basis,  summing up  those
  8808.                flows into a single yearly flow will  only change the answer by a
  8809.                small percentage.
  8810.  
  8811.                @NPV assumes that the period between cash flows is constant.
  8812.  
  8813.                @NPV  assumes  end-of-period-payments.   For beginning-of-period-
  8814.                payments, multiply the answer by (1+int).
  8815.  
  8816.  
  8817.      Example   1      A         B       C       D       E       F     
  8818.                  1    -2000
  8819.                  2      900
  8820.                  3      900
  8821.                  4      900
  8822.                  5      900
  8823.                  6
  8824.  
  8825.                Cell A1;1 contains the value -2,000 (indicating  an investment of
  8826.                $2000), and  cells A2  to A5  contain the  value 900  (indicating
  8827.                periodic receipts of $900), then, using a 12% discount rate:
  8828.  
  8829.                =@NPV(0.12,A1;1..A5;1) = 655.01 (end of period)
  8830.                =@NPV(0.12,A1;1..A5;1)*(1.12) = 733.61 (start of period)
  8831.  
  8832.  
  8833.  
  8834.  
  8835.  
  8836.  
  8837.  
  8838.  
  8839.  
  8840.                                          130
  8841.  
  8842.  
  8843.  
  8844.  
  8845.  
  8846.  
  8847.  
  8848.  
  8849.  
  8850.  
  8851.  
  8852.  
  8853.      --------------------------------------------------------------------------
  8854.      @PAGES                                                                 Data
  8855.      --------------------------------------------------------------------------
  8856.      Function  Returns the number of pages in a block.
  8857.  
  8858.      Syntax    @PAGES(block)
  8859.  
  8860.      Remarks   This function returns the number of pages in a specified block of
  8861.                cells. 
  8862.  
  8863.      Example   If the block A1;1..B5;10 is named COST, then
  8864.  
  8865.                =@PAGES(COST) = 10
  8866.  
  8867.                =@PAGES(B12;11..F20;14) = 4
  8868.  
  8869.  
  8870.      --------------------------------------------------------------------------
  8871.      @PI                                                            Trigonometry
  8872.      --------------------------------------------------------------------------
  8873.      Function  Returns the value of pi (3.14159...).
  8874.  
  8875.      Syntax    @PI
  8876.  
  8877.      Remarks   The @PI function simply returns the value of pi, 3.141592635...
  8878.  
  8879.      Example   Entering the  formula 2*@PI*5.3  returns the  circumference of  a
  8880.                circle with a radius of 5.3, or 33.30088.
  8881.  
  8882.  
  8883.  
  8884.  
  8885.  
  8886.  
  8887.  
  8888.  
  8889.  
  8890.  
  8891.  
  8892.  
  8893.  
  8894.  
  8895.  
  8896.  
  8897.  
  8898.  
  8899.  
  8900.  
  8901.  
  8902.  
  8903.  
  8904.  
  8905.  
  8906.                                          131
  8907.  
  8908.  
  8909.  
  8910.  
  8911.  
  8912.  
  8913.  
  8914.  
  8915.  
  8916.  
  8917.  
  8918.  
  8919.      --------------------------------------------------------------------------
  8920.      @PMT                                                              Financial
  8921.      --------------------------------------------------------------------------
  8922.      Function  Returns the payment required to amortize a loan amount.
  8923.  
  8924.      Syntax    @PMT(prin,int,term)
  8925.                where  prin,  int,  and  term  are numbers,  cell  addresses,  or
  8926.                calculated values.
  8927.  
  8928.      Remarks   This  function  calculates  the   periodic  payment  required  to
  8929.                amortize  a  loan amount,  given  the  amount of  principal,  the
  8930.                periodic interest rate, and the number of payments.
  8931.  
  8932.                prin  is  the total  amount  of  principal, int  is  the periodic
  8933.                interest rate, and term is the number of payments in the loan.
  8934.  
  8935.                The @PMT  function assumes  a fixed  rate of  interest.   It also
  8936.                requires  (like all of the financial functions) that the interest
  8937.                and term in  the argument are  expressed in like intervals;  that
  8938.                is, a monthly term requires a monthly interest rate.
  8939.  
  8940.  
  8941.      Example   If you were  looking at a home that would require a $75,000 loan,
  8942.                at 10% yearly interest  for 30 years (360 monthly  payments), how
  8943.                much would your monthly payment be?
  8944.  
  8945.                =@PMT(75000,0.1/12,360) = $658.18.
  8946.  
  8947.  
  8948.  
  8949.  
  8950.  
  8951.  
  8952.  
  8953.  
  8954.  
  8955.  
  8956.  
  8957.  
  8958.  
  8959.  
  8960.  
  8961.  
  8962.  
  8963.  
  8964.  
  8965.  
  8966.  
  8967.  
  8968.  
  8969.  
  8970.  
  8971.  
  8972.                                          132
  8973.  
  8974.  
  8975.  
  8976.  
  8977.  
  8978.  
  8979.  
  8980.  
  8981.  
  8982.  
  8983.  
  8984.  
  8985.      --------------------------------------------------------------------------
  8986.      @POINTER                                                               Data
  8987.      --------------------------------------------------------------------------
  8988.      Function  Returns information about the current cell.
  8989.  
  8990.      Syntax    @POINTER(attribute)
  8991.                where attribute is a string in quotations or a cell reference.
  8992.  
  8993.      Remarks   This function returns various types of information about the cell
  8994.                which  the  cell  pointer is  currently  in.    This function  is
  8995.                intended for use  in application programs which  need information
  8996.                about the current cell.  attribute determines what information is
  8997.                returned, and must  be one of  the following strings;  "address",
  8998.                "col", "contents", "format", "page", "prefix", "protect",  "row",
  8999.                or "type".
  9000.  
  9001.      Example   attribute      @POINTER returns
  9002.                "address"      the name of the current cell (for example B5;1)
  9003.  
  9004.                "col"          the column number of the current cell (1 thru 512)
  9005.  
  9006.                "contents"     the contents of the current cell
  9007.  
  9008.                "format"       the formatting of the current cell
  9009.                                    0 Default
  9010.                                    1 Fixed
  9011.                                    2 Currency
  9012.                                    3 Percent
  9013.                                    4 Scientific
  9014.                                    5 Hidden
  9015.                                    6 Text
  9016.                                    7 Fixed with commas
  9017.                                    8 Currency with commas
  9018.                                    9 Percent with commas
  9019.                                    10 dd-mmm-yy
  9020.                                    11 dd-mmm
  9021.                                    12 mmm-yy
  9022.                                    13 mm/dd/yy
  9023.                                    14 Month DD, YYYY
  9024.                                    15 HH:MM AM/PM
  9025.                                    16 HH:MM Military
  9026.                                    17 General
  9027.  
  9028.                "page"         the page  number of  the current  cell (1  through
  9029.                               512)
  9030.  
  9031.                "prefix"       the justification character of the current cell
  9032.                               ' if left justified
  9033.                               " if right justified
  9034.                               ^ if centered
  9035.                               blank if the cell doesn't contain text
  9036.  
  9037.  
  9038.                                          133
  9039.  
  9040.  
  9041.  
  9042.  
  9043.  
  9044.  
  9045.  
  9046.  
  9047.  
  9048.  
  9049.  
  9050.  
  9051.                "protect"      the protection status of the current cell
  9052.                                    0 = Not protected, 1 = Protected
  9053.  
  9054.                "row"          the row number of the current cell (1 through 512)
  9055.  
  9056.                "type"         the type of data in the current cell
  9057.                                    BLANK
  9058.                                    FORMAT
  9059.                                    NUMBER
  9060.                                    TEXT
  9061.                                    FORMULA
  9062.                                    TXTFORM
  9063.                                    ERROR
  9064.  
  9065.  
  9066.      Example   If the current cell contains centered text:
  9067.  
  9068.                @POINTER("type") = "TEXT"
  9069.  
  9070.                @POINTER("prefix") = ^
  9071.  
  9072.  
  9073.                If  the  cell pointer  is in  cell B5;1,  which contains  a value
  9074.                formatted as currency, then:
  9075.  
  9076.                @POINTER("type") = "NUMBER"
  9077.  
  9078.                @POINTER("format") = 2
  9079.  
  9080.                @POINTER("row") = 5
  9081.  
  9082.  
  9083.  
  9084.  
  9085.  
  9086.  
  9087.  
  9088.  
  9089.  
  9090.  
  9091.  
  9092.  
  9093.  
  9094.  
  9095.  
  9096.  
  9097.  
  9098.  
  9099.  
  9100.  
  9101.  
  9102.  
  9103.  
  9104.                                          134
  9105.  
  9106.  
  9107.  
  9108.  
  9109.  
  9110.  
  9111.  
  9112.  
  9113.  
  9114.  
  9115.  
  9116.  
  9117.      --------------------------------------------------------------------------
  9118.      @PROPER                                                              String
  9119.      --------------------------------------------------------------------------
  9120.      Function  Capitalizes the first letter of each word in a text string.
  9121.  
  9122.      Syntax    @PROPER(string)
  9123.                where string is a string in quotations, or a cell address.
  9124.  
  9125.      Remarks   This function converts  the first  letter of words  in string  to
  9126.                uppercase.
  9127.  
  9128.                @PROPER will only recognize words  that are separated by  spaces,
  9129.                or other non alpha characters.
  9130.  
  9131.      Example   =@PROPER("this is a test") = This Is A Test
  9132.  
  9133.                =@PROPER("mid-size") = Mid-Size
  9134.  
  9135.                since the dash is a non alpha character.
  9136.  
  9137.  
  9138.  
  9139.      --------------------------------------------------------------------------
  9140.      @PV                                                               Financial
  9141.      --------------------------------------------------------------------------
  9142.      Function  Returns the present value of an annuity.
  9143.  
  9144.      Syntax    @PV(pmt,int,term)
  9145.                where  pmt,  int,  and  term  are  numbers,  cell  addresses,  or
  9146.                calculated values.
  9147.  
  9148.      Remarks   This function calculates the  present value of an annuity,  given
  9149.                the periodic payment, the periodic  interest rate, and the number
  9150.                of periods.
  9151.  
  9152.                pmt  is the  payment per  period,  int is  the interest  rate per
  9153.                period, and term is the total number of payments.
  9154.  
  9155.                The  @PV  function does  precisely  the  same thing  as  the @NPV
  9156.                function, except that all payments  are equal.  Thus, it is  only
  9157.                necessary to enter  the amount once,  rather than as a  series of
  9158.                values.  The interest rate and  term must agree; monthly payments
  9159.                must  be  accompanied by  a monthly  term.   @PV  assumes end-of-
  9160.                period-payments.  For beginning-of-period-payments,  multiply the
  9161.                answer by (1+int).
  9162.  
  9163.      Example   To  calculate  the  present value  of  an  annuity  in which  the
  9164.                payments are made monthly for 36 months, the interest rate is 10%
  9165.                per year, and the payments are $400, enter the formula:
  9166.  
  9167.                =@PV(400,0.1/12,36)
  9168.                ProQube Lite returns the value $12,396.42.
  9169.  
  9170.                                          135
  9171.  
  9172.  
  9173.  
  9174.  
  9175.  
  9176.  
  9177.  
  9178.  
  9179.  
  9180.  
  9181.  
  9182.  
  9183.      --------------------------------------------------------------------------
  9184.      @RADIANS                                                       Trigonometry
  9185.      --------------------------------------------------------------------------
  9186.      Function  Converts degrees to radians.
  9187.  
  9188.      Syntax    @RADIANS(x)
  9189.                where x is a number, a cell address, or a calculated value.  
  9190.  
  9191.      Remarks   This function converts the angle x from degrees to radians.
  9192.  
  9193.                Since ProQube Lite's trigonometry functions  require angles to be
  9194.                expressed in radians, the @RADIANS function is  useful for making
  9195.                this conversion.
  9196.  
  9197.      Example   =@RADIANS(180) = 3.14159
  9198.                =@RADIANS(45) = 0.7854
  9199.  
  9200.  
  9201.  
  9202.      --------------------------------------------------------------------------
  9203.      @RAND                                                          Mathematical
  9204.      --------------------------------------------------------------------------
  9205.      Function  Returns a uniformly distributed random number.
  9206.  
  9207.      Syntax    @RAND
  9208.  
  9209.      Remarks   This function generates a random number  which is greater than or
  9210.                equal to  zero and  is less than  one.  The  value of  @RAND will
  9211.                change  to  a  new  random value  each  time  the  cell  (not the
  9212.                WorkQube) is recalculated.  
  9213.  
  9214.                If  you  want  the numbers  to  fall  within  a specified  range,
  9215.                multiply the @RAND result by the  difference between the high and
  9216.                low values in a range; then add this result to the lower value in
  9217.                the range.
  9218.  
  9219.      Example   If you  want to generate a  random number which  falls between 20
  9220.                and 25, then use
  9221.  
  9222.                20+(5*@RAND)
  9223.  
  9224.  
  9225.  
  9226.  
  9227.  
  9228.  
  9229.  
  9230.  
  9231.  
  9232.  
  9233.  
  9234.  
  9235.  
  9236.                                          136
  9237.  
  9238.  
  9239.  
  9240.  
  9241.  
  9242.  
  9243.  
  9244.  
  9245.  
  9246.  
  9247.  
  9248.  
  9249.      --------------------------------------------------------------------------
  9250.      @RATE                                                             Financial
  9251.      --------------------------------------------------------------------------
  9252.      Function  Returns the interest rate at which a present value will grow to a
  9253.                future value.
  9254.  
  9255.      Syntax    @RATE(pv,fv,term)
  9256.                where pv, fv, and term are numbers, cell addresses, or calculated
  9257.                values.
  9258.  
  9259.      Remarks   This function returns the interest rate  at which a present value
  9260.                will grow into a future value during a number of periods.
  9261.  
  9262.                pv is the present value amount of an investment, fv is the future
  9263.                value  amount  of  the investment,  and  term  is  the number  of
  9264.                periods.
  9265.  
  9266.                The periods are assumed to be  regular intervals.  Converting the
  9267.                compound growth rate  on a yearly  basis, given that the  term is
  9268.                expressed  in  months,   simply  requires  that  the   answer  be
  9269.                multiplied by 12.
  9270.  
  9271.      Example   If you want to calculate the periodic  interest rate that will be
  9272.                required to make an investment of $1,000 grow into $1,750 in five
  9273.                years,
  9274.  
  9275.                =@RATE(1000,1750,5) = 0.1184 (or 11.84%)
  9276.  
  9277.  
  9278.  
  9279.      --------------------------------------------------------------------------
  9280.      @REPEAT                                                              String
  9281.      --------------------------------------------------------------------------
  9282.      Function  Repeats text a given number of times.
  9283.  
  9284.      Syntax    @REPEAT(string,n)
  9285.                where string is a  string in quotations or a cell  address; and n
  9286.                is a number, cell address, or calculated value.
  9287.  
  9288.      Remarks   This function returns string repeated n times.
  9289.  
  9290.      Example   =@REPEAT("abc",3) = abcabcabc
  9291.  
  9292.                =@REPEAT("-",15) = ---------------
  9293.  
  9294.  
  9295.  
  9296.  
  9297.  
  9298.  
  9299.  
  9300.  
  9301.  
  9302.                                          137
  9303.  
  9304.  
  9305.  
  9306.  
  9307.  
  9308.  
  9309.  
  9310.  
  9311.  
  9312.  
  9313.  
  9314.  
  9315.      --------------------------------------------------------------------------
  9316.      @REPLACE                                                             String
  9317.      --------------------------------------------------------------------------
  9318.      Function  Replaces a substring in a string with a new string.
  9319.  
  9320.      Syntax    @REPLACE(string,start,n,new string)
  9321.                where string and  new string  are strings in  quotations or  cell
  9322.                addresses; and  start  and  n  are numbers,  cell  addresses,  or
  9323.                calculated values.
  9324.  
  9325.      Remarks   This function removes n characters from string at position start,
  9326.                and inserts new  string at the  same position.   @REPLACE is  not
  9327.                only a  function that  allows replacement  of a  string; it  also
  9328.                serves as an insert or  a delete function.  If n is  set to zero,
  9329.                this is simply an insert function.  If new string is  empty, this
  9330.                serves as a delete function.
  9331.  
  9332.      Example   If A1;1 contains the string This is a test, then
  9333.  
  9334.                =@REPLACE(A1;1,11,4,"game") = This is a game
  9335.  
  9336.                =@REPLACE(A1;1,11,0," game") = This is a game test
  9337.  
  9338.                =@REPLACE(A1;1,6,5,"") = This test
  9339.  
  9340.  
  9341.  
  9342.      --------------------------------------------------------------------------
  9343.      @RIGHT                                                               String
  9344.      --------------------------------------------------------------------------
  9345.      Function  Returns the right part of a text string.
  9346.  
  9347.      Syntax    @RIGHT(string,n)
  9348.                where string is a  string in quotations or a cell  address, and n
  9349.                is a number, cell address, or calculated value. 
  9350.  
  9351.      Remarks   This function extracts and  returns n characters from the  end of
  9352.                string.  If n is greater than the number of characters in string,
  9353.                then the entire string is returned.
  9354.  
  9355.      See Also  @LEFT, @MID.
  9356.  
  9357.      Example   Column A contains a list of customer  phone numbers.  You want to
  9358.                create customer  numbers by  using the  last four  digits of  the
  9359.                telephone number.  Just use
  9360.  
  9361.                =@RIGHT(A1;1,4)
  9362.  
  9363.                for the first  number.   If the telephone  number were  (208)882-
  9364.                8656, ProQube Lite would return the string 8656.
  9365.  
  9366.                =@RIGHT("this is a test",8) = s a test
  9367.  
  9368.                                          138
  9369.  
  9370.  
  9371.  
  9372.  
  9373.  
  9374.  
  9375.  
  9376.  
  9377.  
  9378.  
  9379.  
  9380.  
  9381.      --------------------------------------------------------------------------
  9382.      @ROUND                                                         Mathematical
  9383.      --------------------------------------------------------------------------
  9384.      Function  Rounds a value to a given number of decimal places.
  9385.  
  9386.      Syntax    @ROUND(x,n)
  9387.                where x and n are numbers, cell addresses, or calculated values.
  9388.  
  9389.      Remarks   This function returns the value of x rounded to n places.
  9390.  
  9391.                n can  be either positive  or negative;  when n is  negative, the
  9392.                program rounds n digits to the left of the decimal point.  When n
  9393.                is positive,  the program rounds  n digits  to the  right of  the
  9394.                decimal.
  9395.  
  9396.      See Also  @INT
  9397.  
  9398.      Example   =@ROUND(123.456,-2) = 100
  9399.                =@ROUND(123.456,-1) = 120
  9400.                =@ROUND(123.456,2) = 123.46
  9401.                =@ROUND(123.456,0) = 123
  9402.  
  9403.  
  9404.  
  9405.      --------------------------------------------------------------------------
  9406.      @ROWS                                                                  Data
  9407.      --------------------------------------------------------------------------
  9408.      Function  Returns the number of rows in a block.
  9409.  
  9410.      Syntax    @ROWS(block)
  9411.  
  9412.      Remarks   This  function returns  the number  of rows  in block.   @ROWS is
  9413.                particularly useful when used with named blocks.
  9414.  
  9415.      Example   If the block A1;1..B10;2 is named COST then
  9416.  
  9417.                =@ROWS(COST) = 10
  9418.  
  9419.  
  9420.  
  9421.  
  9422.  
  9423.  
  9424.  
  9425.  
  9426.  
  9427.  
  9428.  
  9429.  
  9430.  
  9431.  
  9432.  
  9433.  
  9434.                                          139
  9435.  
  9436.  
  9437.  
  9438.  
  9439.  
  9440.  
  9441.  
  9442.  
  9443.  
  9444.  
  9445.  
  9446.  
  9447.      --------------------------------------------------------------------------
  9448.      @SECOND                                                           Date/Time
  9449.      --------------------------------------------------------------------------
  9450.      Function  Returns the second of a time number.
  9451.  
  9452.      Syntax    @SECOND(time number)
  9453.                where  time number is  a number, a cell  address, or a calculated
  9454.                value.
  9455.  
  9456.      Remarks   This function returns  the value in seconds (between 0 and 59) of
  9457.                time number.
  9458.  
  9459.                time number should be a value between 0 and 1.  ProQube Lite will
  9460.                not  ignore  mixed  numbers; rather,  it  will  extract  only the
  9461.                fractional part.   The  argument may  be either a  value, a  cell
  9462.                reference to  a value,  or a  cell reference  to a formula  which
  9463.                calculates a value.
  9464.  
  9465.                @SECOND is  used whenever  it is  important to  extract only  the
  9466.                second portion of a time value.  This function is most often used
  9467.                in conjunction with other time functions, such as @NOW or @TIME.
  9468.  
  9469.      Example   If the current time were 10:43.34, then
  9470.  
  9471.                =@SECOND(@NOW) = 34
  9472.  
  9473.                =@SECOND(@TIME(10,20,30)) = 30
  9474.  
  9475.  
  9476.  
  9477.      --------------------------------------------------------------------------
  9478.      @SIGN                                                          Mathematical
  9479.      --------------------------------------------------------------------------
  9480.      Function  Returns the sign of a number.
  9481.  
  9482.      Syntax    @SIGN(x)
  9483.                where x is a number, a cell address, or a calculated value.
  9484.  
  9485.      Remarks   This function returns the sign of its  x.  If x is negative,  the
  9486.                function returns -1.  If x positive,  the function returns 1.  If
  9487.                x is 0, the function returns 0.
  9488.  
  9489.      Example   =@SIGN(23.4) = 1
  9490.                =@SIGN(-13.9) = -1
  9491.                =@SIGN(0) = 0
  9492.                =@SIGN(@PI) = 1
  9493.  
  9494.  
  9495.  
  9496.  
  9497.  
  9498.  
  9499.  
  9500.                                          140
  9501.  
  9502.  
  9503.  
  9504.  
  9505.  
  9506.  
  9507.  
  9508.  
  9509.  
  9510.  
  9511.  
  9512.  
  9513.      --------------------------------------------------------------------------
  9514.      @SIN                                                           Trigonometry
  9515.      --------------------------------------------------------------------------
  9516.      Function  Returns the sine of an angle.
  9517.  
  9518.      Syntax    @SIN(x)
  9519.                where x is a number, a cell address, or a calculated value.
  9520.  
  9521.      Remarks   This function returns  the sine of  the angle  x.  x  must be  in
  9522.                radians.  If x is in degrees,  then the @RADIANS function must be
  9523.                used to  convert x to  radians.  The  value returned by  the @SIN
  9524.                function will always lie between -1 and 1.
  9525.  
  9526.      Example   =@SIN(3) = 0.1411
  9527.                =@SIN(@PI) = 0
  9528.                =@SIN(@RADIANS(90)) = 1
  9529.  
  9530.  
  9531.      --------------------------------------------------------------------------
  9532.      @SLN                                                              Financial
  9533.      --------------------------------------------------------------------------
  9534.      Function  Returns the amount of depreciation of an asset using the straight
  9535.                line method.
  9536.  
  9537.      Syntax    @SLN(cost,salvage,life)
  9538.                where cost,  salvage, and life  are numbers,  cell addresses,  or
  9539.                calculated values.
  9540.  
  9541.      Remarks   This function calculates  and returns the amount  of depreciation
  9542.                of  an  asset  using  the  Straight-Line  method  of  accelerated
  9543.                depreciation.
  9544.  
  9545.                cost is the  cost of the asset,  salvage is the salvage  value of
  9546.                the asset after it is totally depreciated, and life is the useful
  9547.                life of the asset.  
  9548.  
  9549.      Example   Your  company  purchased a  piece  of  equipment  last  year  for
  9550.                $40,000.  Its scrap  value has been determined to be $11,000, and
  9551.                its useful life is seven years.   What is the yearly depreciation
  9552.                expense?
  9553.  
  9554.                =@SLN(40000,11000,7) = $4,142.86
  9555.  
  9556.  
  9557.  
  9558.  
  9559.  
  9560.  
  9561.  
  9562.  
  9563.  
  9564.  
  9565.  
  9566.                                          141
  9567.  
  9568.  
  9569.  
  9570.  
  9571.  
  9572.  
  9573.  
  9574.  
  9575.  
  9576.  
  9577.  
  9578.  
  9579.      --------------------------------------------------------------------------
  9580.      @SQRT                                                          Mathematical
  9581.      --------------------------------------------------------------------------
  9582.      Function  Returns the square root of a value.
  9583.  
  9584.      Syntax    @SQRT(x)
  9585.                where x is a number, a cell address, or a calculated value.
  9586.  
  9587.      Remarks   This function returns the square root of x.  x must  be positive,
  9588.                since any two negative numbers multiply to a positive number.
  9589.  
  9590.                Since @SQRT will not work with negative numbers, it will often be
  9591.                necessary to convert  negative values  to positive ones.   To  do
  9592.                this, simply combine the @SQRT function with the @ABS function.
  9593.  
  9594.      Example   =@SQRT(16) = 4
  9595.                =@SQRT(-9) = ERROR
  9596.                =@SQRT(@ABS(-9)) = 3
  9597.  
  9598.  
  9599.  
  9600.      --------------------------------------------------------------------------
  9601.      @STD                                                            Statistical
  9602.      --------------------------------------------------------------------------
  9603.      Function  Returns the standard deviation of a list of values.
  9604.  
  9605.      Syntax    @STD(list)
  9606.                where list is  a list of values  separated by commas, or  a range
  9607.                containing values, or some combination of the two.
  9608.  
  9609.      Remarks   This function calculates the standard deviation of the values  in
  9610.                list.
  9611.  
  9612.                Standard  deviation  is  a measure  of  dispersion;  that is,  it
  9613.                measures  the degree to which each  value in list varies from the
  9614.                mean of the values in list.
  9615.  
  9616.                @STD  will completely ignore all items in  list which are text or
  9617.                blank.  This means that if a  text string is in a range in  list,
  9618.                you do not have  to worry about it being used  incorrectly in the
  9619.                calculation.
  9620.  
  9621.      Example   =@STD(0,1,2,3,4,5,6,7,8,9)  = 2.87
  9622.  
  9623.                Similarly, if  cells A1;1  to A10;1 contained  those values,  the
  9624.                formula
  9625.  
  9626.                =@STD(A1;1..A10;1)  would return the value 2.87
  9627.  
  9628.  
  9629.  
  9630.  
  9631.  
  9632.                                          142
  9633.  
  9634.  
  9635.  
  9636.  
  9637.  
  9638.  
  9639.  
  9640.  
  9641.  
  9642.  
  9643.  
  9644.  
  9645.      --------------------------------------------------------------------------
  9646.      @STRING                                                              String
  9647.      --------------------------------------------------------------------------
  9648.      Function  Converts a value to a string.
  9649.  
  9650.      Syntax    @STRING(x,n)
  9651.                where x and n are values, cell addresses, or calculated values.
  9652.  
  9653.      Remarks   This function converts x to a string with n decimal places.
  9654.  
  9655.                To perform string operations  on values, you must use  either the
  9656.                @STRING or @FORMAT functions to convert the value to a string.
  9657.  
  9658.      See Also  @FORMAT
  9659.  
  9660.      Example   If cell A1;1 contains the function @PI, then
  9661.  
  9662.                =@STRING(A1;1,3)
  9663.  
  9664.                will return the string 3.142
  9665.  
  9666.  
  9667.  
  9668.  
  9669.      --------------------------------------------------------------------------
  9670.      @SUM                                                            Statistical
  9671.      --------------------------------------------------------------------------
  9672.      Function  Returns the sum of a list of values.
  9673.  
  9674.      Syntax    @SUM(list)
  9675.                where list is  a list of values  separated by commas, or  a range
  9676.                containing values, or some combination of the two.
  9677.  
  9678.      Remarks   This function adds up all of the values contained in list.
  9679.  
  9680.                @SUM will completely  ignore all items in list  which are text or
  9681.                blank.  This means that if  a text string is in a range  in list,
  9682.                you do not have to worry  about it being used incorrectly in  the
  9683.                calculation.
  9684.  
  9685.      Example   =@SUM(0,1,2,3,4,5,6,7,8,9)  = 45
  9686.  
  9687.                Similarly, if cells  A1;1 to A10;1  contained those same  values,
  9688.                entering the formula
  9689.  
  9690.                =@SUM(A1;1..A10;1)  would return the value 45.
  9691.  
  9692.  
  9693.  
  9694.  
  9695.  
  9696.  
  9697.  
  9698.                                          143
  9699.  
  9700.  
  9701.  
  9702.  
  9703.  
  9704.  
  9705.  
  9706.  
  9707.  
  9708.  
  9709.  
  9710.  
  9711.      --------------------------------------------------------------------------
  9712.      @SYD                                                              Financial
  9713.      --------------------------------------------------------------------------
  9714.      Function  Returns the amount of depreciation  of an asset using the  Sum of
  9715.                the Years' Digits method.
  9716.  
  9717.      Syntax    @SYD(cost,salvage,life,period)
  9718.                where  cost,  salvage,   life,  and  period  are   numbers,  cell
  9719.                addresses, or calculated values.
  9720.  
  9721.      Remarks   This function calculates  the amount of depreciation  of an asset
  9722.                using   the   Sum-of-the-Years'-Digits   method  of   accelerated
  9723.                depreciation.
  9724.  
  9725.                cost is the  cost of the asset,  salvage is the salvage  value of
  9726.                the asset after  it is  totally depreciated, life  is the  useful
  9727.                life of the asset, and period  is the period within that life  in
  9728.                which the depreciation is being calculated.
  9729.  
  9730.      Example   Your  company  purchased  a  piece of  equipment  last  year  for
  9731.                $40,000.  Its  scrap value has been determined to be $11,000, and
  9732.                its useful life is seven years.   How much depreciation should be
  9733.                assigned to it in this, its second year of useful life?
  9734.  
  9735.                =@SYD(40000,11000,7,2) = $6,214.29
  9736.  
  9737.  
  9738.      --------------------------------------------------------------------------
  9739.      @TAN                                                           Trigonometry
  9740.      --------------------------------------------------------------------------
  9741.      Function  Returns the tangent of an angle.
  9742.  
  9743.      Syntax    @TAN(x)
  9744.                where x is a number, a cell address, or a calculated value.
  9745.  
  9746.      Remarks   This function  returns the  tangent of the  angle x.   x  must be
  9747.                expressed in  radians.   If x  is in degrees,  then the  @RADIANS
  9748.                function must be used to convert x to radians.
  9749.  
  9750.      Example   =@TAN(3)  = -0.1425.
  9751.                =@TAN(7) = 0.8714.
  9752.  
  9753.  
  9754.  
  9755.  
  9756.  
  9757.  
  9758.  
  9759.  
  9760.  
  9761.  
  9762.  
  9763.  
  9764.                                          144
  9765.  
  9766.  
  9767.  
  9768.  
  9769.  
  9770.  
  9771.  
  9772.  
  9773.  
  9774.  
  9775.  
  9776.  
  9777.      --------------------------------------------------------------------------
  9778.      @TERM                                                             Financial
  9779.      --------------------------------------------------------------------------
  9780.      Function  Returns the number of periods for an investment to reach a future
  9781.                value.
  9782.  
  9783.      Syntax    @TERM(pmt,int,fv)
  9784.                where pmt, int, and fv are numbers, cell addresses, or calculated
  9785.                values.
  9786.  
  9787.      Remarks   This  function  returns the  number of  terms  needed to  reach a
  9788.                specified future value, given an  interest rate (rate of  return)
  9789.                and the value of equal payment to be made each period.
  9790.  
  9791.                pmt is  the amount  of the  equal periodic payments,  int is  the
  9792.                interest rate or expected  rate of return, and  fv is the  future
  9793.                value to be reached.
  9794.  
  9795.                Many investments (including many  people's savings accounts) take
  9796.                a series of equal payments.   To determine how long it will  take
  9797.                to accumulate a specific future value, use the @TERM function.
  9798.  
  9799.      Example   You deposit $500 per  month in your savings account,  which earns
  9800.                7% annually.   You need $9,000 to  make the down payment  on your
  9801.                first home.   How  many months will  it take  to accumulate  that
  9802.                much?
  9803.  
  9804.                First, convert the yearly interest to  months.  Divide .07 by 12;
  9805.                monthly interest is .00583.  Enter the formula:
  9806.  
  9807.                =@TERM(500,0.00583,9000)
  9808.  
  9809.                The formula returns the number of months to achieve the goal, 17.
  9810.  
  9811.  
  9812.  
  9813.  
  9814.  
  9815.  
  9816.  
  9817.  
  9818.  
  9819.  
  9820.  
  9821.  
  9822.  
  9823.  
  9824.  
  9825.  
  9826.  
  9827.  
  9828.  
  9829.  
  9830.                                          145
  9831.  
  9832.  
  9833.  
  9834.  
  9835.  
  9836.  
  9837.  
  9838.  
  9839.  
  9840.  
  9841.  
  9842.  
  9843.      --------------------------------------------------------------------------
  9844.      @TIME                                                             Date/Time
  9845.      --------------------------------------------------------------------------
  9846.      Function  Returns a time number for a time.
  9847.  
  9848.      Syntax    @TIME(hour,min,sec)
  9849.                where  hour,  min,  and  sec  are  numbers,  cell  addresses,  or
  9850.                calculated values.
  9851.  
  9852.      Remarks   This function returns a time number  between 0 and 1, from  hour,
  9853.                min, and sec.
  9854.  
  9855.                hour is the hour of the day (between 0 and 23), min is the minute
  9856.                of the hour (between  0 and 59),  and sec is  the seconds of  the
  9857.                minute (between 0 and 59).
  9858.  
  9859.                It is usually necessary to format the cell containing @TIME using
  9860.                the /Cell Format Date command.
  9861.  
  9862.      Example   If cell A4;1 contains the following formula and is formatted in a
  9863.                time format, then
  9864.  
  9865.                =@TIME(15,12,25)
  9866.  
  9867.                in cell A4;1 would return the time: 3:12:25
  9868.  
  9869.  
  9870.  
  9871.      --------------------------------------------------------------------------
  9872.      @TODAY                                                            Date/Time
  9873.      --------------------------------------------------------------------------
  9874.      Function  Returns the date number of the current date.
  9875.  
  9876.      Syntax    @TODAY
  9877.  
  9878.      Remarks   This function reads the system clock  and returns the date number
  9879.                for the current date.  
  9880.  
  9881.                As  with virtually  all of  the date  and time  functions, it  is
  9882.                necessary to convert the  value supplied by this function  into a
  9883.                readable date format using the /Cell Format Date commands.
  9884.  
  9885.                The date will not  be recalculated unless you want it to be, as a
  9886.                result of ProQube Lite's dependency-based recalculation.
  9887.  
  9888.      Example   To enter the current date into cell A1, format the cell using the
  9889.                /Cell Format Date commands, then type
  9890.  
  9891.                =@TODAY
  9892.  
  9893.                into the cell.
  9894.  
  9895.  
  9896.                                          146
  9897.  
  9898.  
  9899.  
  9900.  
  9901.  
  9902.  
  9903.  
  9904.  
  9905.  
  9906.  
  9907.  
  9908.  
  9909.      --------------------------------------------------------------------------
  9910.      @TRIM                                                                String
  9911.      --------------------------------------------------------------------------
  9912.      Function  Trims all extra spaces out of a text string.
  9913.  
  9914.      Syntax    @TRIM(string)
  9915.                where string is a string in quotations, or a cell address.
  9916.  
  9917.      Remarks   This function strips  all extra spaces  from string.  The  result
  9918.                contains only single spaces between words.
  9919.  
  9920.                Often, importing ASCII files will produce strings with extraneous
  9921.                spaces.  The problem is overcome with @TRIM.
  9922.  
  9923.      Example   The imported string in A1 reads:
  9924.  
  9925.                   This    is a           test.
  9926.  
  9927.                Entering the formula
  9928.  
  9929.                =@TRIM(A1)
  9930.  
  9931.                produces the new string:
  9932.  
  9933.                This is a test.
  9934.  
  9935.  
  9936.  
  9937.      --------------------------------------------------------------------------
  9938.      @TRUE                                                               Logical
  9939.      --------------------------------------------------------------------------
  9940.      Function  Returns the value TRUE (1).
  9941.  
  9942.      Syntax    @TRUE
  9943.  
  9944.      Remarks   This function returns the value 1 (TRUE).
  9945.  
  9946.                The primary purpose of the @TRUE function is to help make logical
  9947.                formulas easier to read.
  9948.  
  9949.      Example   =@IF(B4;1>100,@TRUE,@FALSE)=1, if B4;1 is greater than 1.
  9950.  
  9951.  
  9952.  
  9953.  
  9954.  
  9955.  
  9956.  
  9957.  
  9958.  
  9959.  
  9960.  
  9961.  
  9962.                                          147
  9963.  
  9964.  
  9965.  
  9966.  
  9967.  
  9968.  
  9969.  
  9970.  
  9971.  
  9972.  
  9973.  
  9974.  
  9975.      --------------------------------------------------------------------------
  9976.      @UPPER                                                               String
  9977.      --------------------------------------------------------------------------
  9978.      Function  Converts all the characters of a text string to uppercase.
  9979.  
  9980.      Syntax    @UPPER(string)
  9981.                where string is a string in quotations, or a cell address.
  9982.  
  9983.                The @UPPER function converts  all of the characters in  string to
  9984.                uppercase.
  9985.  
  9986.      Example   If cell A1;1 contains the text "Instruction Manual"
  9987.  
  9988.                =@UPPER(A1;1) = INSTRUCTION MANUAL
  9989.  
  9990.  
  9991.  
  9992.  
  9993.      --------------------------------------------------------------------------
  9994.      @VALUE                                                               String
  9995.      --------------------------------------------------------------------------
  9996.      Function  Returns the value that a text string looks like.
  9997.  
  9998.      Syntax    @VALUE(string)
  9999.                where string is a string in quotations or a cell address.
  10000.  
  10001.      Remarks   This function converts string  into a value that  can be used  in
  10002.                formulas,  equations,  and   other  calculations.     @VALUE   is
  10003.                especially useful for  converting mixed fractions (such  as stock
  10004.                values) into numerical values.
  10005.  
  10006.      Example   If A1 contains the label, "4.34"
  10007.  
  10008.                =@VALUE(A1) = 4.34
  10009.  
  10010.                =@VALUE("3 1/4") = 3.25
  10011.  
  10012.  
  10013.  
  10014.  
  10015.  
  10016.  
  10017.  
  10018.  
  10019.  
  10020.  
  10021.  
  10022.  
  10023.  
  10024.  
  10025.  
  10026.  
  10027.  
  10028.                                          148
  10029.  
  10030.  
  10031.  
  10032.  
  10033.  
  10034.  
  10035.  
  10036.  
  10037.  
  10038.  
  10039.  
  10040.  
  10041.      --------------------------------------------------------------------------
  10042.      @VAR                                                            Statistical
  10043.      --------------------------------------------------------------------------
  10044.      Function  Returns the variance of a list of values.
  10045.  
  10046.      Syntax    @VAR(list)
  10047.                where list is  a list of values  separated by commas, or  a range
  10048.                containing values, or some combination of the two.
  10049.  
  10050.      Remarks   This function  returns the  variance of  the values contained  in
  10051.                list.
  10052.  
  10053.                The  @VAR  function  measures  dispersion,  much  like  the  @STD
  10054.                function.  In  fact, the variance of list is simply the square of
  10055.                its standard deviation.
  10056.  
  10057.                The @VAR function  will completely ignore  all items in the  list
  10058.                which are text or blank.  This means that if  a text string is in
  10059.                a range in  list, you do  not have to  worry about it  being used
  10060.                incorrectly in the calculation.
  10061.  
  10062.      Example   =@VAR(0,1,2,3,4,5,6,7,8,9) = 8.25
  10063.  
  10064.                Similarly, if cells A1;1 to A10;1 contain those values
  10065.  
  10066.                =@VAR(A1;1..A10;1) = 8.25
  10067.  
  10068.  
  10069.  
  10070.  
  10071.  
  10072.  
  10073.  
  10074.  
  10075.  
  10076.  
  10077.  
  10078.  
  10079.  
  10080.  
  10081.  
  10082.  
  10083.  
  10084.  
  10085.  
  10086.  
  10087.  
  10088.  
  10089.  
  10090.  
  10091.  
  10092.  
  10093.  
  10094.                                          149
  10095.  
  10096.  
  10097.  
  10098.  
  10099.  
  10100.  
  10101.  
  10102.  
  10103.  
  10104.  
  10105.  
  10106.  
  10107.      --------------------------------------------------------------------------
  10108.      @VLOOKUP                                                               Data
  10109.      --------------------------------------------------------------------------
  10110.      Function  Looks up an item in a vertical lookup table.
  10111.  
  10112.      Syntax    @VLOOKUP(x,block,col offset,page offset)
  10113.                where  block is a  block of  cells, named  or otherwise;  and col
  10114.                offset and page offset are numbers, cell addresses, or calculated
  10115.                values; and  x is  a number,  text, cell  address, or  calculated
  10116.                value.
  10117.  
  10118.      Remarks   This  function  looks up  and retrieves  a value  or text  from a
  10119.                vertical  lookup table.  block is  the block of cells which makes
  10120.                up the lookup table.
  10121.  
  10122.                If x is text, @VLOOKUP will compare x with each cell in  the left
  10123.                column of block,  and if a match  is found, will move  col offset
  10124.                columns, and page  offset pages from  that cell, and will  return
  10125.                the value in the resulting cell.  If x does not match any of  the
  10126.                cells  in the left column of block, then @VLOOKUP will return the
  10127.                value ERROR.
  10128.  
  10129.                If x  is a value  instead of text,  @VLOOKUP will compare  x with
  10130.                each cell in the left column of block until it finds a cell which
  10131.                is greater than or equal to x.  This means that the values in the
  10132.                left column of block must  be in ascending order for  @VLOOKUP to
  10133.                work correctly.  If the value in the cell is equal to x, @VLOOKUP
  10134.                will  consider  it a  match.   If  the  cell is  greater  than x,
  10135.                @VLOOKUP  will move up  to the  previous cell  and consider  it a
  10136.                match.  For  example, if the values  in the left column  of block
  10137.                are  100, 200, 300,  and 400,  and the  value of  x is  250, then
  10138.                @VLOOKUP will search  until it  reaches 300, and  will then  move
  10139.                back and use the cell containing 200  as the match.  When a match
  10140.                is found, @VLOOKUP will move col  offset columns, and page offset
  10141.                pages from that cell, and will return the value  in the resulting
  10142.                cell.  If x  is smaller than the  first cell in the  left column,
  10143.                @VLOOKUP will return the value ERROR. 
  10144.  
  10145.  
  10146.  
  10147.  
  10148.  
  10149.  
  10150.  
  10151.  
  10152.  
  10153.  
  10154.  
  10155.  
  10156.  
  10157.  
  10158.  
  10159.  
  10160.                                          150
  10161.  
  10162.  
  10163.  
  10164.  
  10165.  
  10166.  
  10167.  
  10168.  
  10169.  
  10170.  
  10171.  
  10172.  
  10173.      Example   1      A         B   C    D    E    F     
  10174.                  1                       1987 Sales
  10175.                  2
  10176.                  3            Jan  Feb  Mar  Apr  May
  10177.                  4  Joe       1234 2011 1893 1500 1438
  10178.                  5  Bill      2102 1453 2415 1627 1888
  10179.                  6  David     1845 1739 2194 1999 2003
  10180.                  7  Mike      2340 2112 1693 1429 2236
  10181.                  8
  10182.                  9
  10183.  
  10184.                @VLOOKUP("Bill",A4;1..F7;1,2,0)  will  compare  the value  "Bill"
  10185.                with  each cell in the left  column of the range A4;1..F7;1 until
  10186.                it finds  the match in cell A5;1.  It then moves across 2 columns
  10187.                to cell C5;1.  Since page offset  is 0, @VLOOKUP does not move up
  10188.                to another page.   So @VLOOKUP in this  case equals 1453  (Bill's
  10189.                February 1987 sales).
  10190.  
  10191.                =@VLOOKUP("Bill",A4;1..F7;4,2,1)  =  Bill's  February 1988  sales
  10192.                from page 2)
  10193.  
  10194.                =@VLOOKUP("Joe",A4;1..F7;1,4,0) = 1500
  10195.  
  10196.                =@VLOOKUP("Mike",A4;1..F7;1,0,0) = Mike
  10197.  
  10198.  
  10199.  
  10200.  
  10201.  
  10202.  
  10203.  
  10204.  
  10205.  
  10206.  
  10207.  
  10208.  
  10209.  
  10210.  
  10211.  
  10212.  
  10213.  
  10214.  
  10215.  
  10216.  
  10217.  
  10218.  
  10219.  
  10220.  
  10221.  
  10222.  
  10223.  
  10224.  
  10225.  
  10226.                                          151
  10227.  
  10228.  
  10229.  
  10230.  
  10231.  
  10232.  
  10233.  
  10234.  
  10235.  
  10236.  
  10237.  
  10238.  
  10239.      --------------------------------------------------------------------------
  10240.      @YEAR                                                             Date/Time
  10241.      --------------------------------------------------------------------------
  10242.      Function  Returns the year of a date number.
  10243.  
  10244.      Syntax    @YEAR(date number)
  10245.                where  date number is  a number, a cell  address, or a calculated
  10246.                value.
  10247.  
  10248.      Remarks   This function returns the year of date  number.  For years in the
  10249.                1900's, the final 2 digits are returned.  For the year 2000 @YEAR
  10250.                will return the value 100.
  10251.  
  10252.                Again, the date number  is usually supplied  by one of the  other
  10253.                date functions; this  function is used  to extract the year  from
  10254.                one of those functions.
  10255.  
  10256.      Example   CURRENT YEAR   @YEAR(@NOW) returns
  10257.                1980           80
  10258.                1989           89
  10259.                1999           99
  10260.                2000           100
  10261.                2001           101
  10262.                2010           110
  10263.  
  10264.  
  10265.      --------------------------------------------------------------------------
  10266.      @@                                                                     Data
  10267.      --------------------------------------------------------------------------
  10268.      Function  Returns data from a cell through an indirect reference.
  10269.  
  10270.      Syntax    @@(cellname)
  10271.                where cellname is a string in quotations or a cell address
  10272.  
  10273.      Remarks   This  function  will  return  the  contents  of  the  cell  named
  10274.                cellname.
  10275.  
  10276.                If cellname is  a string which looks like a cell address, then @@
  10277.                will read and return the contents of the cell named cellname.
  10278.  
  10279.                If cellname is a cell reference, then @@ will use the contents of
  10280.                cellname as the name of the cell to retrieve data from.
  10281.  
  10282.                @@ is  typically used in macros,  where you may need  to retrieve
  10283.                the contents of certain cells automatically.
  10284.  
  10285.      Example   If cell B5;1 contains the text Overdue and cell A1;1 contains the
  10286.                text 'B5;1, then
  10287.  
  10288.                @@(A1;1)  and  @@("B5;1")
  10289.  
  10290.                will both return the label Overdue
  10291.  
  10292.                                          152
  10293.  
  10294.  
  10295.  
  10296.  
  10297.  
  10298.  
  10299.  
  10300.  
  10301.  
  10302.  
  10303.  
  10304.  
  10305.      PROQUBE LITE APPLICATIONS
  10306.  
  10307.      ProQube Lite provides a built in programming language which you can  use to
  10308.      create  any  application,  from a  simple  time-saving  keystroke repeating
  10309.      routine to a fully customized business application.
  10310.  
  10311.      A  ProQube  Lite  application  program  simply  consists  of  a  text  file
  10312.      containing the commands  which you would like ProQube Lite to execute.  You
  10313.      may give your program files any  valid DOS name, but the extension must  be
  10314.      .PQM (for example  MYPROG.PQM).   Your application program  can consist  of
  10315.      keystroke macros, ProQube Command Language (PCL) commands, or both.
  10316.  
  10317.      Macros    A keystroke macro  is simply a  sequence of keystrokes  following
  10318.                the apostrophe character '.  When  ProQube Lite encounters one of
  10319.                these keystroke sequences  in your program, it  simply treats the
  10320.                keystrokes as if you typed them in yourself.  For example, if you
  10321.                place the line:
  10322.  
  10323.                '/sci2<Enter>
  10324.  
  10325.                into   your   application  program,   then   ProQube   Lite  will
  10326.                automatically insert two columns when it  executes this line.  It
  10327.                does this by  first typing the /  character (which will bring  up
  10328.                the menu),  then S (for slice), then C  (for column), then I (for
  10329.                insert), then the number 2 (to insert 2 columns), and finally the
  10330.                <Enter> key (to complete the command).
  10331.  
  10332.      Commands  The ProQube Command Language (PCL) is a set of instructions which
  10333.                provides flexible I/O capabilities, numerous control  structures,
  10334.                file, printer,  and DOS access, and more.   In fact, you may find
  10335.                that  the  PCL  commands  are  so  versatile that  many  of  your
  10336.                application programs will need few if any keystroke macros.
  10337.  
  10338.  
  10339.  
  10340.  
  10341.  
  10342.  
  10343.  
  10344.  
  10345.  
  10346.  
  10347.  
  10348.  
  10349.  
  10350.  
  10351.  
  10352.  
  10353.  
  10354.  
  10355.  
  10356.  
  10357.  
  10358.                                          153
  10359.  
  10360.  
  10361.  
  10362.  
  10363.  
  10364.  
  10365.  
  10366.  
  10367.  
  10368.  
  10369.  
  10370.  
  10371.      CREATING AN APPLICATION
  10372.  
  10373.      The easiest way  to create a keystroke  macro is with ProQube  Lite's Macro
  10374.      Recorder.  To  begin recording a  macro, you simply  press the <^F10>  key.
  10375.      You then press the key  you want to assign the  macro to, and begin  typing
  10376.      the  keys to record.  When you are  ready to stop recording, just press the
  10377.      <^F10>  key  again.   Your  macro  will be  stored  in  a file  whose  name
  10378.      corresponds to the  key you assigned  the macro to.   For example, a  macro
  10379.      assigned to <Ctrl>T would be named CTRLT.PQM.
  10380.  
  10381.      Later, when you  press <Ctrl>T, ProQube Lite will look  for the application
  10382.      file CTRLT.PQM, and  run it if  it exists.   If it doesn't  exist, then  an
  10383.      error  message will  pop  up.   Applications  or  keystroke macros  can  be
  10384.      assigned  to just  about any key  which isn't  already defined and  used by
  10385.      ProQube Lite.    For example,  you  can't redefine  the  arrow keys  to  do
  10386.      something else, but you can assign  other keys to do the same thing  as the
  10387.      arrow keys.  
  10388.  
  10389.      Applications may also  be created  with a  text editor, just  as you  would
  10390.      write a program in any programming language.  ProQube Lite applications are
  10391.      not limited  to simple  keystroke macros.   ProQube  Lite  supplies a  rich
  10392.      programming  language which  provides flexible  I/O  capabilities, numerous
  10393.      control structures (IF/THEN/ELSE,  FOR/NEXT, REPEAT/UNTIL,  WHILE/ENDWHILE,
  10394.      etc), access to DOS  commands and external programs, file  access commands,
  10395.      and more. 
  10396.  
  10397.      These applications  can be  written using  either the  simple editor  which
  10398.      ProQube Lite provides  (/Macro Edit), or outside of ProQube  Lite with your
  10399.      own  text editor.   You may give  your application any  valid DOS name (the
  10400.      extension  must be  .PQM), including one  of the  keystroke names  (such as
  10401.      ALTX.PQM).  This allows  you to run extremely powerful  applications at the
  10402.      press of a key.  
  10403.  
  10404.      There are a  number of advantages to  having applications reside in  a file
  10405.      rather than in the worksheet itself.
  10406.  
  10407.      - The application can  load and save data files without  being written over
  10408.      by the incoming worksheet.
  10409.  
  10410.      - You can  create large libraries of  applications and macros which  can be
  10411.      used in any worksheet without having to load the entire library into memory
  10412.      each time.
  10413.  
  10414.      - Large applications  can be broken into  smaller parts, and only  the part
  10415.      which is running needs  to be in memory.  This means you can create and run
  10416.      applications which would normally require more memory than is available.
  10417.  
  10418.  
  10419.  
  10420.  
  10421.  
  10422.  
  10423.  
  10424.                                          154
  10425.  
  10426.  
  10427.  
  10428.  
  10429.  
  10430.  
  10431.  
  10432.  
  10433.  
  10434.  
  10435.  
  10436.  
  10437.      RUNNING AN APPLICATION
  10438.  
  10439.      Once you have  created your application program, you  will probably want to
  10440.      run  it.  There are several ways  to run a ProQube Lite application program
  10441.      which you have created.
  10442.  
  10443.      /Macro Run     You can run an application program  from the menus using the
  10444.                     /Macro Run command.  You will  be asked for the name of  the
  10445.                     application  program to run.   If you  press <Enter> without
  10446.                     entering a name, the  ProQube Lite file manager will  pop up
  10447.                     from which you may select the application from.
  10448.  
  10449.      Keystroke      If you have named your application with one of the keystroke
  10450.                     names, you can run the application by pressing the key.  For
  10451.                     example, if  the application  file is  named CTRLX.PQM  then
  10452.                     pressing <Ctrl>X will run the application.
  10453.  
  10454.      Worksheet      You can also give your  application the same name as one  of
  10455.                     your  worksheets  (except that  the  extension will  be .PQM
  10456.                     instead of .PQS).  When a new data file (.PQS) is retrieved,
  10457.                     ProQube Lite will  check for a corresponding  application to
  10458.                     run.    For  example, when  you  retrieve  INVOICE.PQS, then
  10459.                     ProQube  Lite  will   look  for  and  run   the  application
  10460.                     INVOICE.PQM (if it exists).
  10461.  
  10462.      If  an error  is encountered  when running  an  application, then  an error
  10463.      message will first be displayed.   Then, when you press a key  to continue,
  10464.      ProQube Lite will  load the application into  the editor, and place  you on
  10465.      the line where the error occurred to allow you to fix the problem.  
  10466.  
  10467.  
  10468.  
  10469.  
  10470.  
  10471.  
  10472.  
  10473.  
  10474.  
  10475.  
  10476.  
  10477.  
  10478.  
  10479.  
  10480.  
  10481.  
  10482.  
  10483.  
  10484.  
  10485.  
  10486.  
  10487.  
  10488.  
  10489.  
  10490.                                          155
  10491.  
  10492.  
  10493.  
  10494.  
  10495.  
  10496.  
  10497.  
  10498.  
  10499.  
  10500.  
  10501.  
  10502.  
  10503.      LANGUAGE DESCRIPTION
  10504.  
  10505.      A ProQube Lite application program is one or more lines of text residing in
  10506.      an ASCII file.  There are four  different types of lines which you can  put
  10507.      in your application;  comments, labels,  macros, and commands.   The  first
  10508.      character of each  line of text determines  what type of command  that line
  10509.      is.   Each line  of your application  program will begin  with one  of four
  10510.      different characters, a  pound sign (#), an apostrophe ('), a colon (:), or
  10511.      an exclamation mark (!).
  10512.  
  10513.      Comments  A line  which begins  with an  exclamation mark  (!) is  simply a
  10514.                comment.   All of  the characters  on the  line after  the !  are
  10515.                ignored when ProQube Lite runs the application program.  The sole
  10516.                purpose of comments is to make your programs easier to understand
  10517.                when you read them.
  10518.  
  10519.                Example:
  10520.  
  10521.                ! This is a comment
  10522.  
  10523.                This  line  is ignored  when  ProQube  Lite encounters  it  in an
  10524.                application program.
  10525.  
  10526.  
  10527.      Labels    A line  which begins with  a colon (:)  is a  label.  A  label is
  10528.                simply   a  string  which  marks  a   specific  position  in  the
  10529.                application program.
  10530.  
  10531.                Example:
  10532.  
  10533.                :MyLabel
  10534.  
  10535.                This line does  nothing when it is encountered in  a ProQube Lite
  10536.                application program.   Some ProQube  Lite PCL  commands (such  as
  10537.                #GOTO) use labels as a place to jump to for further processing.
  10538.  
  10539.  
  10540.      Macros    A  line which  begins with  an apostrophe  (') is  a  sequence of
  10541.                direct keystrokes (keystroke  macro) which you want  ProQube Lite
  10542.                to  execute.   Keystrokes  which  are printable  ASCII characters
  10543.                (letters,  numbers,  symbols,   etc.)  are  displayed   in  their
  10544.                printable  form.    Keystrokes  which  are  NOT  printable  ASCII
  10545.                characters (such as  function keys, Ctrl  and Alt key  sequences,
  10546.                cursor movement keys, etc.) are displayed  as the name of the key
  10547.                enclosed in angle brackets  <>.  For example, the <Enter>  key is
  10548.                displayed as <Enter>.
  10549.  
  10550.                Example:
  10551.  
  10552.                '/cfcn2<Enter>
  10553.  
  10554.                This line causes  the current  cell to be  formatted as  currency
  10555.  
  10556.                                          156
  10557.  
  10558.  
  10559.  
  10560.  
  10561.  
  10562.  
  10563.  
  10564.  
  10565.  
  10566.  
  10567.  
  10568.  
  10569.                with  2  decimal places  and  no commas.   This  is  done because
  10570.                ProQube Lite processes each keystroke in the line just  as if you
  10571.                typed it in yourself.
  10572.                  The / key is processed, which summons the main menu
  10573.                  The C key is processed, which selects the "Cell" option
  10574.                  The F key is processed, which selects the "Format" option
  10575.                  The C key is processed, which selects the "Currency" option
  10576.                  The N key is processed, which selects the "NoComma" option
  10577.                  The number  "2" is processed, which types 2 in as the number of
  10578.                decimal places
  10579.                  The <Enter> causes the <Enter> key to be processed (this is one
  10580.                of the special keys), which enters the number 2 as the  number of
  10581.                decimal places.
  10582.  
  10583.                Keystroke macros  can even be read from cells.  Simply follow the
  10584.                apostrophe with the cell  name enclosed in square brackets.   For
  10585.                example, if  you want the keystrokes  to be read from  cell B5;3,
  10586.                simply use the line:
  10587.  
  10588.                '[B5;3]
  10589.  
  10590.      Commands  A line which  begins with a pound  sign (#) is a  ProQube Command
  10591.                Language (PCL) command.   It is these commands which  provide the
  10592.                muscle for sophisticated application development.  These commands
  10593.                are described in the next section.
  10594.  
  10595.      ProQube Lite  makes the assumption that you want to create easy to read and
  10596.      well  commented  programs.   Since  ProQube  Lite ignores  blank  lines and
  10597.      leading  spaces, you may  use indentation  to show  various levels  in your
  10598.      programs.  You can also feel free to comment your program as heavily as you
  10599.      like, because  ProQube Lite does  not load your  comments into memory  when
  10600.      running an application.
  10601.  
  10602.  
  10603.  
  10604.  
  10605.  
  10606.  
  10607.  
  10608.  
  10609.  
  10610.  
  10611.  
  10612.  
  10613.  
  10614.  
  10615.  
  10616.  
  10617.  
  10618.  
  10619.  
  10620.  
  10621.  
  10622.                                          157
  10623.  
  10624.  
  10625.  
  10626.  
  10627.  
  10628.  
  10629.  
  10630.  
  10631.  
  10632.  
  10633.  
  10634.  
  10635.      SPECIAL KEY NAMES
  10636.  
  10637.      Although the letter, number, and symbol keys can be directly referenced  by
  10638.      their  character,  several  keys  cannot  be  referred to  using  a  single
  10639.      character.  ProQube Lite  gives each of these keys its own  name.  When one
  10640.      of these keystrokes  is encountered in a  keystroke macro, the name  of the
  10641.      key is  surrounded by angle  brackets <> so that  ProQube Lite can  tell it
  10642.      apart  from regular characters.  When the keystroke  is used as the name of
  10643.      an application file, then the angle  brackets (and certain other characters
  10644.      are not used because DOS  will not allow them.  Below is a  list of special
  10645.      keystrokes, and the name of the keystrokes when used both in a macro and as
  10646.      a file name.
  10647.  
  10648.      KEY SEQUENCE                  KEYSTROKE NAME           FILE NAME
  10649.      <BkSp>                        <BkSp>                   N/A
  10650.      <^BkSp>                       <^BkSp>                  N/A
  10651.      <Esc>                         <Esc>                    N/A
  10652.      <Enter>                       <Enter>                  N/A
  10653.      <Tab>                         <Tab>                    N/A
  10654.      <^Alt> - <Ctrl>Z *            <CtrlA> - <CtrlZ>        CTRLA.PQM-CTRLZ.PQM
  10655.      <Alt>A - <Alt>Z               <AltA> - <AltZ>          ALTA.PQM-ALTZ.PQM
  10656.      <Home>                        <Home>                   N/A
  10657.      <End>                         <End>                    N/A
  10658.      <Left>                        <Left>                   N/A
  10659.      <Right>                       <Right>                  N/A
  10660.      <Up>                          <Up>                     N/A
  10661.      <Down>                        <Down>                   N/A
  10662.      <PgUp>                        <PgUp>                   N/A
  10663.      <PgDn>                        <PgDn>                   N/A
  10664.      <Ins>                         <Ins>                    N/A
  10665.      <Del>                         <Del>                    N/A
  10666.      <F1> - <F10>                  <F1> - <F10>             N/A
  10667.      <Shift><F1> - <Shift><F10>    <ShF1> - <ShF10>         SHF1.PQM-SHF10.PQM
  10668.      <^F1> - <^F10>                <^F1> - <^F10>           N/A
  10669.      <Alt><F1> - <Alt><F10>        <AltF1> - <AltF10>       ALTF1.PQM-ALTF10.PQM
  10670.      <^Left>                       <^Left>                  N/A
  10671.      <^Right>                      <^Right>                 N/A
  10672.      <^Home>                       <^Home>                  N/A
  10673.      <^End>                        <^End>                   N/A
  10674.      <^PgUp>                       <^PgUp>                  N/A
  10675.      <^PgDn>                       <^PgDn>                  N/A
  10676.  
  10677.      * <^H>, <^I>, and <^M> are not available as file names.
  10678.  
  10679.  
  10680.  
  10681.  
  10682.  
  10683.  
  10684.  
  10685.  
  10686.  
  10687.  
  10688.                                          158
  10689.  
  10690.  
  10691.  
  10692.  
  10693.  
  10694.  
  10695.  
  10696.  
  10697.  
  10698.  
  10699.  
  10700.  
  10701.      THE PROQUBE COMMAND LANGUAGE
  10702.  
  10703.      The ProQube Command Language (PCL) is a set of powerful commands  which you
  10704.      can  use in  your application  programs to  create  menus, pop  up windows,
  10705.      access files, and even run other programs.
  10706.  
  10707.      Each  PCL  command is  a single  word  prefixed with  the #  character (for
  10708.      example   #OUTPUT).    Most  of  these   PCL  commands  require  additional
  10709.      information on the same  line.  These additional pieces  of information are
  10710.      known as arguments.  If you have more than one argument on a line, you must
  10711.      separate them from each other with either a space or a comma.  Also, if any
  10712.      of your arguments are text strings which have a space or comma in it,  then
  10713.      you must surround the text string with quotes so that ProQube Lite knows to
  10714.      keep the text together.
  10715.  
  10716.      Example   The command #OUTPUT (which writes text  onto the screen) requires
  10717.                3 arguments;  the column and  row on the  screen to write  to, as
  10718.                well as the text to write, like this:
  10719.  
  10720.                #OUTPUT 5,10 "This is some text"
  10721.  
  10722.                The PCL  command is #OUTPUT, and  the three arguments are  5, 10,
  10723.                and "This is some text".
  10724.  
  10725.      The arguments  for each of the PCL commands  is considered by default to be
  10726.      either a constant  numeric or text value.   There are many  times, however,
  10727.      when it is desirable (or necessary) to use the result of a formula instead.
  10728.      ProQube  Lite allows  you  provide  a formula  for  an  argument by  simply
  10729.      enclosing the  argument in square  brackets [] (you  don't need to  add the
  10730.      leading equal sign).
  10731.  
  10732.      Example   The format for the #OUTPUT command is:
  10733.  
  10734.                #OUTPUT x,y line
  10735.  
  10736.                By default, ProQube Lite expects something like:
  10737.  
  10738.                #OUTPUT 5,10 "This is some text"
  10739.  
  10740.                This  line  in an  application tells  ProQube  Lite to  write the
  10741.                string This is  some text starting in the 5th column and 10th row
  10742.                of the screen.
  10743.  
  10744.                Suppose, however, that  you wanted  to output the  value of  cell
  10745.                A1;1 instead of the constant "This is some text".  Then you would
  10746.                simply use the line:
  10747.  
  10748.                #OUTPUT 5,10 [A1;1]
  10749.  
  10750.                Or if you wanted to output the contents of cell A1;1 in all upper
  10751.                case you would use:
  10752.  
  10753.  
  10754.                                          159
  10755.  
  10756.  
  10757.  
  10758.  
  10759.  
  10760.  
  10761.  
  10762.  
  10763.  
  10764.  
  10765.  
  10766.  
  10767.                #OUTPUT 5,10 [@upper(A1;1)]
  10768.  
  10769.                This method works just as well for numeric arguments as for  text
  10770.                arguments.  Suppose you wanted to output the string "This is some
  10771.                text" starting in  the 5th column, but  you wanted the row  to be
  10772.                the value in cell A1;1.  You would use:
  10773.  
  10774.                #OUTPUT 5,[A1;1] "This is some text"
  10775.  
  10776.  
  10777.  
  10778.  
  10779.  
  10780.  
  10781.  
  10782.  
  10783.  
  10784.  
  10785.  
  10786.  
  10787.  
  10788.  
  10789.  
  10790.  
  10791.  
  10792.  
  10793.  
  10794.  
  10795.  
  10796.  
  10797.  
  10798.  
  10799.  
  10800.  
  10801.  
  10802.  
  10803.  
  10804.  
  10805.  
  10806.  
  10807.  
  10808.  
  10809.  
  10810.  
  10811.  
  10812.  
  10813.  
  10814.  
  10815.  
  10816.  
  10817.  
  10818.  
  10819.  
  10820.                                          160
  10821.  
  10822.  
  10823.  
  10824.  
  10825.  
  10826.  
  10827.  
  10828.  
  10829.  
  10830.  
  10831.  
  10832.  
  10833.      INPUT/OUTPUT
  10834.      The I/O commands provide a variety of  ways to read data from the keyboard,
  10835.      output  to the  screen and  printer.   There  are also  commands  to create
  10836.      customized help  and error  systems.   You  may  also generate  delays  and
  10837.      audible tones.
  10838.  
  10839.      #BOX                Displays a box on the screen.
  10840.      #CLEARBOX           Clears the most recent box placed on the screen.
  10841.      #EDIT               Displays  a  prompt  and  allows  editing of  a  cell's
  10842.                          contents.
  10843.      #INPUT              Prompts for and accepts input from the keyboard.
  10844.      #KEY                Prompts for and reads a keystroke.
  10845.      #MENU               Creates and displays a menu on the screen.
  10846.      #MENUITEM           Defines an item and its help line for a menu.
  10847.      #OUTPUT             Displays text on the screen.
  10848.      #PRINT/#PRINTLN     Sends data to your printer.
  10849.      #RESTORE            Restores the ProQube Lite screen.
  10850.      #UPDATE             Enables or disables screen updating.
  10851.      #WAIT               Prompt and wait for a key press.
  10852.      #WINDOW             Displays a window on the screen.
  10853.      #WINTEXT            Displays text in a window.
  10854.  
  10855.  
  10856.  
  10857.      DATA
  10858.      The data commands allow your application  to move to or manipulate data  in
  10859.      cells of the worksheet.
  10860.  
  10861.      #ASSIGN             Assigns a value to a cell.
  10862.      #DEC                Decrements a cell's value.
  10863.      #INC                Increments a cell's value.
  10864.      #LOCATE             Moves the cell pointer relatively.
  10865.  
  10866.  
  10867.      CONTROL
  10868.      The control commands  provide the ability  to loop, perform conditional  or
  10869.      unconditional branching, and call subroutines.
  10870.  
  10871.      #BREAK              Enables/disables breaking out of a program.
  10872.      #CALL               Calls a subroutine.
  10873.      #EXIT               Ends the application program.
  10874.      #FOR/#NEXT          Repeats commands a fixed number of times.
  10875.      #GOTO               Branches to another part of the program.
  10876.      #IF/#ELSE/#ENDIF    Executes a set of commands if a condition is true.
  10877.      #REPEAT/#UNTIL      Repeats some commands until a condition is true.
  10878.      #WHILE/#ENDWHILE    Repeats some commands while a condition is true.
  10879.  
  10880.  
  10881.  
  10882.  
  10883.  
  10884.  
  10885.  
  10886.                                          161
  10887.  
  10888.  
  10889.  
  10890.  
  10891.  
  10892.  
  10893.  
  10894.  
  10895.  
  10896.  
  10897.  
  10898.  
  10899.      DEBUGGING
  10900.      The  debugging  commands  allow you  to  single  step,  set conditional  or
  10901.      unconditional  breakpoints,  and   evaluate  and  change  cells   while  an
  10902.      application is running.
  10903.  
  10904.      #EDITERR            Enables or disables automatic editing of errors.
  10905.      #STEP               Enables or disables single stepping.
  10906.  
  10907.  
  10908.  
  10909.      --------------------------------------------------------------------------
  10910.      #ASSIGN                                                                Data
  10911.      --------------------------------------------------------------------------
  10912.      Function  Assigns a value to a cell.
  10913.  
  10914.      Syntax    #ASSIGN cellname value
  10915.  
  10916.      Remarks   This command  allows  you to  assign a  value to  a cell  without
  10917.                having  to  move to  it first.    cellname can  be either  a cell
  10918.                address or a named block.  value can be either a number or text.
  10919.  
  10920.      Example   #ASSIGN B5;3 123.45
  10921.                #ASSIGN C6;7 "January"
  10922.                #ASSIGN interest .1
  10923.                #ASSIGN A1;1 [@SIN(A1;1)]
  10924.  
  10925.  
  10926.  
  10927.  
  10928.  
  10929.  
  10930.  
  10931.  
  10932.  
  10933.  
  10934.  
  10935.  
  10936.  
  10937.  
  10938.  
  10939.  
  10940.  
  10941.  
  10942.  
  10943.  
  10944.  
  10945.  
  10946.  
  10947.  
  10948.  
  10949.  
  10950.  
  10951.  
  10952.                                          162
  10953.  
  10954.  
  10955.  
  10956.  
  10957.  
  10958.  
  10959.  
  10960.  
  10961.  
  10962.  
  10963.  
  10964.  
  10965.      --------------------------------------------------------------------------
  10966.      #BOX                                                           Input/Output
  10967.      --------------------------------------------------------------------------
  10968.      Function  Displays a box on the screen.
  10969.  
  10970.      Syntax    #BOX x1,y1,x2,y2 save title
  10971.  
  10972.      Remarks   This command displays a box on the screen.  The upper left corner
  10973.                of the box  is located at screen  position x1, y1, and  the lower
  10974.                right corner of  the box  is located  at position x2,  y2.   save
  10975.                determines whether ProQube Lite saves  the contents of the screen
  10976.                under the box before  displaying it.  If save=0, then  the screen
  10977.                contents are not saved.  If save=1, then the  screen contents are
  10978.                saved, and can be  restored using the #CLEARBOX command.   Saving
  10979.                the  screen  contents  requires  extra memory,  so  if  it  isn't
  10980.                necessary to restore the  contents, it is best to set  save to 0.
  10981.                The #RESTORE command will restore the ProQube Lite screen even if
  10982.                it  wasn't saved, so  you can use  #BOX with save=0  to clear the
  10983.                screen to begin your application.
  10984.  
  10985.      See Also  #WINDOW, #CLEARBOX, #RESTORE
  10986.  
  10987.      Example   #BOX 1,1,80,25 0 "Main Screen"
  10988.  
  10989.                this command clears the screen with the title Main Screen.
  10990.  
  10991.  
  10992.                #BOX 10,10,40,15 1 "Dialog Box"
  10993.  
  10994.  
  10995.  
  10996.      --------------------------------------------------------------------------
  10997.      #BREAK                                                              Control
  10998.      --------------------------------------------------------------------------
  10999.      Function  Enables/disables breaking out of programs.
  11000.  
  11001.      Syntax    #BREAK 0/1
  11002.  
  11003.      Remarks   This command allows you to enable or disable the ability to break
  11004.                out of an  application program  while it is  running by  pressing
  11005.                <^F3>.    By default,  an  application  will exit  when  <^F3> is
  11006.                pressed.  This command provides the  capability to prevent a user
  11007.                from breaking  out of  your application.   It  is  best to  leave
  11008.                breaking enabled when creating your application.
  11009.  
  11010.      Example   #BREAK 0
  11011.                causes your program to ignore <^F3> when it is pressed.
  11012.  
  11013.                #BREAK 1
  11014.                causes your program to exit when <^F3> is pressed.
  11015.  
  11016.  
  11017.  
  11018.                                          163
  11019.  
  11020.  
  11021.  
  11022.  
  11023.  
  11024.  
  11025.  
  11026.  
  11027.  
  11028.  
  11029.  
  11030.  
  11031.      --------------------------------------------------------------------------
  11032.      #CALL                                                               Control
  11033.      --------------------------------------------------------------------------
  11034.      Function  Calls a subroutine.
  11035.  
  11036.      Syntax    #CALL label / #RETURN
  11037.  
  11038.      Remarks   This  command causes  execution  of the  program  to continue  at
  11039.                label.   When the  #RETURN statement is  encountered, the program
  11040.                branches  back  to the  line  immediately following  the original
  11041.                #CALL command.
  11042.  
  11043.                This command allows you  to create program segments which  can be
  11044.                called from several places.
  11045.  
  11046.      See Also  #GOTO
  11047.  
  11048.      Example   #CALL MyLabel
  11049.                #OUTPUT 10,11 "Print this second"
  11050.                #EXIT
  11051.  
  11052.                :MyLabel
  11053.                #OUTPUT 10,10 "Print this first"
  11054.                #RETURN
  11055.  
  11056.  
  11057.                The  #CALL statement branches to MyLabel and executes lines until
  11058.                the #RETURN command, then returns back  to the line following the
  11059.                #CALL statement.
  11060.  
  11061.  
  11062.  
  11063.  
  11064.  
  11065.  
  11066.  
  11067.  
  11068.  
  11069.  
  11070.  
  11071.  
  11072.  
  11073.  
  11074.  
  11075.  
  11076.  
  11077.  
  11078.  
  11079.  
  11080.  
  11081.  
  11082.  
  11083.  
  11084.                                          164
  11085.  
  11086.  
  11087.  
  11088.  
  11089.  
  11090.  
  11091.  
  11092.  
  11093.  
  11094.  
  11095.  
  11096.  
  11097.      --------------------------------------------------------------------------
  11098.      #CLEARBOX                                                      Input/Output
  11099.      --------------------------------------------------------------------------
  11100.      Function  Clears the most recent box placed on the screen.
  11101.  
  11102.      Syntax    #CLEARBOX
  11103.  
  11104.      Remarks   This command clears the last box placed on the screen (by #BOX or
  11105.                #WINDOW)  and replaces the data which was under it.  This command
  11106.                only has an effect  if #BOX or #WINDOW  set the save option  to 1
  11107.                (meaning to save the screen contents).
  11108.  
  11109.      See Also  #BOX, #WINDOW, #RESTORE
  11110.  
  11111.      Example   !This line draws a box on the screen
  11112.                #BOX 10,10,40,15 1 "My Box"
  11113.  
  11114.                !This line clears the box off the screen
  11115.                #CLEARBOX
  11116.  
  11117.  
  11118.  
  11119.      --------------------------------------------------------------------------
  11120.      #DEC                                                                   Data
  11121.      --------------------------------------------------------------------------
  11122.      Function  Decrements a cell's value.
  11123.  
  11124.      Syntax    #DEC cellname x
  11125.  
  11126.      Remarks   This command decrements (reduces) the value in cellname by x.  If
  11127.                you don't supply x, then a value of 1 is assumed.
  11128.  
  11129.      See Also  #INC, #ASSIGN
  11130.  
  11131.      Example   #DEC B5;3 6.05
  11132.                decrements the value in B5;3 by 6.05
  11133.  
  11134.                #DEC B5;3
  11135.                decrements the value in B5;3 by 1
  11136.  
  11137.  
  11138.  
  11139.  
  11140.  
  11141.  
  11142.  
  11143.  
  11144.  
  11145.  
  11146.  
  11147.  
  11148.  
  11149.  
  11150.                                          165
  11151.  
  11152.  
  11153.  
  11154.  
  11155.  
  11156.  
  11157.  
  11158.  
  11159.  
  11160.  
  11161.  
  11162.  
  11163.      --------------------------------------------------------------------------
  11164.      #EDIT                                                          Input/Output
  11165.      --------------------------------------------------------------------------
  11166.      Function  Prompts and allows editing of a cell's contents.
  11167.  
  11168.      Syntax    #EDIT x,y cellname len prompt
  11169.  
  11170.      Remarks   This  command displays  prompt  at position  x,y  on the  screen,
  11171.                followed  by the contents of  cellname.  You  are then allowed to
  11172.                edit  the contents  of cellname.   len  is the maximum  number of
  11173.                characters which is displayed and which  you are allowed to enter
  11174.                or edit.
  11175.  
  11176.      See Also  #INPUT
  11177.  
  11178.      Example   #EDIT 40,4 a1;1 6 "Invoice #"
  11179.  
  11180.                displays Invoice #  at position 40,4  on the screen, followed  by
  11181.                the contents of cell  A1;1.  You will only be allowed  to enter 6
  11182.                characters (or less).
  11183.  
  11184.  
  11185.  
  11186.      --------------------------------------------------------------------------
  11187.      #EDITERR                                                          Debugging
  11188.      --------------------------------------------------------------------------
  11189.      Function  Enables or disables automatic editing of errors.
  11190.  
  11191.      Syntax    #EDITERR 0/1
  11192.  
  11193.      Remarks   When  ProQube  Lite encounters  an  error in  an  application, it
  11194.                displays an error message, then calls  up the macro in the  macro
  11195.                editor.   The  cursor  is  placed on  the  line  where the  error
  11196.                occurred so that you can fix the problem.
  11197.  
  11198.                There may be times when  you do not want ProQube Lite  to call up
  11199.                the application for editing.  #EDITERR allows you to disable this
  11200.                feature.
  11201.  
  11202.      Example   #EDITERR 0
  11203.                disables automatic error editing
  11204.  
  11205.                #EDITERR 1
  11206.                enables automatic error editing
  11207.  
  11208.  
  11209.  
  11210.  
  11211.  
  11212.  
  11213.  
  11214.  
  11215.  
  11216.                                          166
  11217.  
  11218.  
  11219.  
  11220.  
  11221.  
  11222.  
  11223.  
  11224.  
  11225.  
  11226.  
  11227.  
  11228.  
  11229.      --------------------------------------------------------------------------
  11230.      #EXIT                                                               Control
  11231.      --------------------------------------------------------------------------
  11232.      Function  Ends the application program.
  11233.  
  11234.      Syntax    #EXIT
  11235.  
  11236.      Remarks   This command terminates the current application program.   If the
  11237.                current  program was  called by  another  program using  the #RUN
  11238.                command, then control is returned to the calling program.
  11239.  
  11240.      Example   #IF A1;1>0
  11241.                  #EXIT
  11242.                #ENDIF
  11243.  
  11244.                These lines cause  an application  to exit if  the value of  cell
  11245.                A1;1 is greater than zero.
  11246.  
  11247.  
  11248.  
  11249.      --------------------------------------------------------------------------
  11250.      #FOR / #NEXT                                                        Control
  11251.      --------------------------------------------------------------------------
  11252.      Function  Repeat commands a fixed number of times.
  11253.  
  11254.      Syntax    #FOR cellname start end step
  11255.                  {some commands}
  11256.                #NEXT 
  11257.  
  11258.      Remarks   This command creates a loop which can perform a set of commands a
  11259.                certain number  of  times.   The  value  of start  is  placed  in
  11260.                cellname.  and as long as  the value of cellname does not  exceed
  11261.                the value of end, the set of commands between the #FOR  and #NEXT
  11262.                command will be executed.   Each time the #NEXT  command branches
  11263.                back  to  the  #FOR  command,  the  value  in  cellname  will  be
  11264.                incremented by step and compared with end.
  11265.  
  11266.                It is  also legal for step to be  a negative value, in which case
  11267.                the #FOR loop will continue until start is less than end.
  11268.  
  11269.                The value in cellname may be used anywhere within the loop.
  11270.  
  11271.      See Also  #REPEAT, #WHILE
  11272.  
  11273.      Example   #FOR a1;1 1 10 2
  11274.                  #OUTPUT 1,[a1;1] "Hello World"
  11275.                #NEXT
  11276.  
  11277.                Writes the string "Hello  World" on the screen on lines  1, 3, 5,
  11278.                7, and 9.
  11279.  
  11280.  
  11281.  
  11282.                                          167
  11283.  
  11284.  
  11285.  
  11286.  
  11287.  
  11288.  
  11289.  
  11290.  
  11291.  
  11292.  
  11293.  
  11294.  
  11295.      --------------------------------------------------------------------------
  11296.      #GOTO                                                               Control
  11297.      --------------------------------------------------------------------------
  11298.      Function  Branches to another part of the program.
  11299.  
  11300.      Syntax    #GOTO label
  11301.  
  11302.      Remarks   This  command causes  the  program to  continue execution  at the
  11303.                given label.  The label may be either before or after  the #GOTO,
  11304.                but it must be in the same program file.
  11305.  
  11306.      See Also  #CALL
  11307.  
  11308.      Example   #GOTO MyLabel
  11309.                #OUTPUT 10,10 "Don't print this"
  11310.  
  11311.                :MyLabel
  11312.                #OUTPUT 10,10 "Print this instead"
  11313.  
  11314.  
  11315.  
  11316.      --------------------------------------------------------------------------
  11317.      #IF / #ELSE / #ENDIF                                                Control
  11318.      --------------------------------------------------------------------------
  11319.      Function  Executes a set of commands if a condition is true.
  11320.  
  11321.      Syntax    #IF boolean formula
  11322.                  {some commands}
  11323.                #ELSE
  11324.                  {some commands}
  11325.                #ENDIF
  11326.  
  11327.      Remarks   This  command  evaluates boolean  formula,  and  if it  is  true,
  11328.                continues executing commands  until #ELSE  or #ENDIF is  reached.
  11329.                All commands between the #ELSE and #ENDIF will be ignored.
  11330.  
  11331.                If boolean formula is  false, then the program branches  from the
  11332.                #IF  to the  #ELSE command  (if there  is one)  and  executes the
  11333.                commands between #ELSE and #ENDIF.
  11334.  
  11335.      Example   #IF a1;1=1 
  11336.                  #OUTPUT 10,10 "It's equal to one" 
  11337.                #ELSE 
  11338.                  #OUTPUT 10,10 "It's not equal to one"
  11339.                #ENDIF 
  11340.  
  11341.                If the value of cell A1;1 equals one, then the line It's equal to
  11342.                one will be output, otherwise the line It's not equal to one will
  11343.                be output.
  11344.  
  11345.  
  11346.  
  11347.  
  11348.                                          168
  11349.  
  11350.  
  11351.  
  11352.  
  11353.  
  11354.  
  11355.  
  11356.  
  11357.  
  11358.  
  11359.  
  11360.  
  11361.      --------------------------------------------------------------------------
  11362.      #INC                                                                   Data
  11363.      --------------------------------------------------------------------------
  11364.      Function  Increments a cell's value.
  11365.  
  11366.      Syntax    #INC cellname x
  11367.  
  11368.      Remarks   This  command increments (increases) the value  of cellname by x.
  11369.                If you do not specify x, then a value of 1 is assumed.
  11370.  
  11371.      See Also  #DEC, #ASSIGN
  11372.  
  11373.      Example   #INC B5;3 6.05
  11374.                increments the value in B5;3 by 6.05
  11375.  
  11376.                #INC B5;3
  11377.                increments the value in B5;3 by 1
  11378.  
  11379.  
  11380.  
  11381.      --------------------------------------------------------------------------
  11382.      #INPUT                                                         Input/Output
  11383.      --------------------------------------------------------------------------
  11384.      Function  Prompts for and accepts input from the keyboard.
  11385.  
  11386.      Syntax    #INPUT x,y cellname len prompt
  11387.  
  11388.      Remarks   This command displays prompt at position  x,y on the screen.  You
  11389.                are  then allowed to  enter some text which  will be entered into
  11390.                cellname.  len is the maximum number of characters which  you are
  11391.                allowed to enter.
  11392.  
  11393.      See Also  #EDIT
  11394.  
  11395.      Example   #INPUT 40,4 a1;1 6 "Enter the sales for May "
  11396.  
  11397.                displays Enter  the sales for May at position 40,4 on the screen.
  11398.                You  will  only  be allowed  to  enter  6  characters (or  less).
  11399.                Whatever you type will be entered into cell A1;1.
  11400.  
  11401.  
  11402.  
  11403.  
  11404.  
  11405.  
  11406.  
  11407.  
  11408.  
  11409.  
  11410.  
  11411.  
  11412.  
  11413.  
  11414.                                          169
  11415.  
  11416.  
  11417.  
  11418.  
  11419.  
  11420.  
  11421.  
  11422.  
  11423.  
  11424.  
  11425.  
  11426.  
  11427.      --------------------------------------------------------------------------
  11428.      #KEY                                                           Input/Output
  11429.      --------------------------------------------------------------------------
  11430.      Function  Prompts for and reads a keystroke.
  11431.  
  11432.      Syntax    #KEY x,y cellname prompt maskchars
  11433.  
  11434.      Remarks   This command displays prompt  at position x,y, and waits  for you
  11435.                to  press a key.   The #KEY command  will automatically place the
  11436.                keystroke pressed into  cellname.  The returned keystroke will be
  11437.                a letter, number, or symbol if it  is regular ASCII.  If it is  a
  11438.                special key like a control or  alternate sequence, cursor key, or
  11439.                function  key, it will be in  angle brackets like this:  <Enter>,
  11440.                <PgUp>, <F1> or <^S>.
  11441.  
  11442.                maskchars is an optional argument which  allows you to force #KEY
  11443.                to accept only certain characters.  If you leave maskchars blank,
  11444.                then #KEY  will  accept any  key  pressed.   If  maskchars  is  a
  11445.                character (or  list of  characters), then  #KEY will only  accept
  11446.                those characters (upper and lower case letters are treated as the
  11447.                same character).
  11448.  
  11449.  
  11450.      See Also  #WAIT
  11451.  
  11452.      Example   #KEY 10,10 a1;1 "Continue?:" y n
  11453.  
  11454.                displays Continue?: at screen position 10,10, waits for y or n to
  11455.                be pressed, and then places the  name of the key pressed in  cell
  11456.                A1;1.
  11457.  
  11458.  
  11459.  
  11460.  
  11461.  
  11462.  
  11463.  
  11464.  
  11465.  
  11466.  
  11467.  
  11468.  
  11469.  
  11470.  
  11471.  
  11472.  
  11473.  
  11474.  
  11475.  
  11476.  
  11477.  
  11478.  
  11479.  
  11480.                                          170
  11481.  
  11482.  
  11483.  
  11484.  
  11485.  
  11486.  
  11487.  
  11488.  
  11489.  
  11490.  
  11491.  
  11492.  
  11493.      --------------------------------------------------------------------------
  11494.      #LOCATE                                                                Data
  11495.      --------------------------------------------------------------------------
  11496.      Function  Moves the cell pointer relatively.
  11497.  
  11498.      Syntax    #LOCATE column row page
  11499.  
  11500.      Remarks   This command allows you to move the cell pointer by several rows,
  11501.                columns, and pages at a time.  This saves having to  use multiple
  11502.                <Up>'s, etc.  column is the number of columns you want to move to
  11503.                the right, row  is the number of rows you want  to move down, and
  11504.                page is  the number of pages  you want to  move in.  You  may set
  11505.                row, column, or page to a negative  value to move in the opposite
  11506.                direction, or to 0 if you don't want to move either direction.
  11507.  
  11508.      Example   #LOCATE 1 -2 3
  11509.                moves the cell pointer right 1 column, up 2 rows, and in 3 pages.
  11510.  
  11511.                #LOCATE 0 20 0
  11512.                moves the cell pointer down 20 rows.
  11513.  
  11514.  
  11515.  
  11516.  
  11517.  
  11518.  
  11519.  
  11520.  
  11521.  
  11522.  
  11523.  
  11524.  
  11525.  
  11526.  
  11527.  
  11528.  
  11529.  
  11530.  
  11531.  
  11532.  
  11533.  
  11534.  
  11535.  
  11536.  
  11537.  
  11538.  
  11539.  
  11540.  
  11541.  
  11542.  
  11543.  
  11544.  
  11545.  
  11546.                                          171
  11547.  
  11548.  
  11549.  
  11550.  
  11551.  
  11552.  
  11553.  
  11554.  
  11555.  
  11556.  
  11557.  
  11558.  
  11559.      --------------------------------------------------------------------------
  11560.      #MENU                                                          Input/Output
  11561.      --------------------------------------------------------------------------
  11562.      Function  Creates and displays a menu on the screen.
  11563.  
  11564.      Syntax    #MENU x,y cellname helpline title
  11565.  
  11566.      Remarks   This command  (along with the  #MENUITEM command)  allows you  to
  11567.                create  and  display  customized  menus  from   your  application
  11568.                programs.  The menu will be placed on the screen at position x,y,
  11569.                and title will be placed at the top of the menu.
  11570.  
  11571.                Each item  to be displayed  in the menu are  defined by #MENUITEM
  11572.                commands following the  #MENU command.   The help  line for  each
  11573.                item will be placed on the screen on line number helpline.
  11574.  
  11575.                When the  user selects an item  from the menu, ProQube  Lite will
  11576.                enter  the item number  into cellname.  For  example, if the user
  11577.                selects the  3rd item from the menu,  ProQube Lite will enter the
  11578.                value  3 into  cellname.  If  the user  escapes from the  menu by
  11579.                pressing the <Esc>  key, ProQube Lite will enter the value 0 into
  11580.                cellname.
  11581.  
  11582.      See Also  #HMENU, #MENUITEM
  11583.  
  11584.      Example   #MENU 20,10 A1;1 1 "My Menu"
  11585.                  #MENUITEM "Add" "Add a record"
  11586.                  #MENUITEM "Delete" "Delete a record"
  11587.                  #MENUITEM "Quit" "Exit from menu"
  11588.  
  11589.                These  lines create and display a menu with 3 items; Add, Delete,
  11590.                and Quit.   If Delete  is selected, then  the value 2  is entered
  11591.                into cell A1;1.
  11592.  
  11593.  
  11594.  
  11595.  
  11596.  
  11597.  
  11598.  
  11599.  
  11600.  
  11601.  
  11602.  
  11603.  
  11604.  
  11605.  
  11606.  
  11607.  
  11608.  
  11609.  
  11610.  
  11611.  
  11612.                                          172
  11613.  
  11614.  
  11615.  
  11616.  
  11617.  
  11618.  
  11619.  
  11620.  
  11621.  
  11622.  
  11623.  
  11624.  
  11625.      --------------------------------------------------------------------------
  11626.      #MENUITEM                                                      Input/Output
  11627.      --------------------------------------------------------------------------
  11628.      Function  Defines an item and its help line in a menu.
  11629.  
  11630.      Syntax    #MENUITEM item help
  11631.  
  11632.      Remarks   This  command defines one of the items in  a menu.  item and help
  11633.                are both text strings enclosed in quotes.  item and help can also
  11634.                be  cell references or text  formulas enclosed in square brackets
  11635.                to allow you to build menu selection items on the fly.
  11636.  
  11637.      See Also  #HMENU, #MENU
  11638.  
  11639.      Example   #MENU 40,4 A1;1  1 "Title"
  11640.                  #MENUITEM "Add" "Add a record" 
  11641.                  #MENUITEM "Delete" [A2;1] 
  11642.                  #MENUITEM [A3;1] "Modify a record" 
  11643.                  #MENUITEM [A4;1] [A5;1]
  11644.  
  11645.  
  11646.      --------------------------------------------------------------------------
  11647.      #OUTPUT                                                        Input/Output
  11648.      --------------------------------------------------------------------------
  11649.      Function  Displays text on the screen.
  11650.  
  11651.      Syntax    #OUTPUT x,y line
  11652.  
  11653.      Remarks   This command allows your application program to write text to the
  11654.                screen.   #OUTPUT will display line at  column x and row y on the
  11655.                screen.  x  must be in the  range 1 to 80,  and y must be  in the
  11656.                range 1 to 25.
  11657.  
  11658.      Example   #OUTPUT 40,4 "Hi there" 
  11659.                #OUTPUT 40,4 [A1;1]
  11660.                #OUTPUT [A2;3],10 "Another line"
  11661.  
  11662.  
  11663.  
  11664.  
  11665.  
  11666.  
  11667.  
  11668.  
  11669.  
  11670.  
  11671.  
  11672.  
  11673.  
  11674.  
  11675.  
  11676.  
  11677.  
  11678.                                          173
  11679.  
  11680.  
  11681.  
  11682.  
  11683.  
  11684.  
  11685.  
  11686.  
  11687.  
  11688.  
  11689.  
  11690.  
  11691.      --------------------------------------------------------------------------
  11692.      #PRINT / #PRINTLN                                              Input/Output
  11693.      --------------------------------------------------------------------------
  11694.      Function  Sends data to your printer.
  11695.  
  11696.      Syntax    #PRINT line
  11697.                #PRINTLN line
  11698.  
  11699.      Remarks   These  two  commands allow  your  program  to send  line  to your
  11700.                printer.   The only  difference between  the #PRINT and  #PRINTLN
  11701.                commands is that  the #PRINTLN command  sends a CR/LF command  to
  11702.                the printer after it has  sent line.  This means that you can use
  11703.                #PRINT several times in a row to print data on the same line.  If
  11704.                you want to just send a blank line to the printer, you can simply
  11705.                use the command #PRINTLN without any argument.
  11706.  
  11707.                If you want  to print numbers, they must be converted to a string
  11708.                first.   The best  way to do  this is with  the @FORMAT function,
  11709.                which allows you  to format the  number in any of  ProQube Lite's
  11710.                formats.
  11711.  
  11712.      Example   #PRINT "Hi there" 
  11713.                #PRINT [A1;1]
  11714.  
  11715.                #PRINTLN "Hi there" 
  11716.                #PRINTLN [A1;1] 
  11717.  
  11718.                #PRINT [@FORMAT(A1;1,2,3)]
  11719.  
  11720.  
  11721.  
  11722.  
  11723.  
  11724.  
  11725.  
  11726.  
  11727.  
  11728.  
  11729.  
  11730.  
  11731.  
  11732.  
  11733.  
  11734.  
  11735.  
  11736.  
  11737.  
  11738.  
  11739.  
  11740.  
  11741.  
  11742.  
  11743.  
  11744.                                          174
  11745.  
  11746.  
  11747.  
  11748.  
  11749.  
  11750.  
  11751.  
  11752.  
  11753.  
  11754.  
  11755.  
  11756.  
  11757.      --------------------------------------------------------------------------
  11758.      #REPEAT / #UNTIL                                                    Control
  11759.      --------------------------------------------------------------------------
  11760.      Function  Repeat some commands until a condition exists.
  11761.  
  11762.      Syntax    #REPEAT
  11763.                  {some commands}
  11764.                #UNTIL boolean formula
  11765.  
  11766.      Remarks   This  command  repeats  a command  or  set  of  commands until  a
  11767.                condition becomes true.  ProQube Lite executes the commands after
  11768.                the #REPEAT until  the #UNTIL command  is reached.  ProQube  Lite
  11769.                then evaluates boolean formula, and branches back to the  #REPEAT
  11770.                command if it is false.  boolean formula may be any legal ProQube
  11771.                Lite formula which returns a TRUE or FALSE value.
  11772.  
  11773.      See Also  #FOR, #WHILE
  11774.  
  11775.      Example   #REPEAT 
  11776.                  #INC a1;1
  11777.                #UNTIL a1;1>30
  11778.  
  11779.                The contents of  cell A1;1 is  incremented until the contents  of
  11780.                A1;1 is greater than 30.
  11781.  
  11782.  
  11783.  
  11784.      --------------------------------------------------------------------------
  11785.      #RESTORE                                                       Input/Output
  11786.      --------------------------------------------------------------------------
  11787.      Function  Restores the ProQube Lite screen.
  11788.  
  11789.      Syntax    #RESTORE
  11790.  
  11791.      Remarks   This  command erases  all  boxes and  restores  the ProQube  Lite
  11792.                screen.  This command should be  used by all application programs
  11793.                before exiting.
  11794.  
  11795.      See Also  #WINDOW, #BOX
  11796.  
  11797.      Example   #BOX 1,1,80,25 0 "Main Title"
  11798.                #WAIT 10,10 "Press any key to continue"
  11799.                #RESTORE
  11800.  
  11801.                These  lines draw a full screen box, wait for you to press a key,
  11802.                then restores the ProQube Lite screen.
  11803.  
  11804.  
  11805.  
  11806.  
  11807.  
  11808.  
  11809.  
  11810.                                          175
  11811.  
  11812.  
  11813.  
  11814.  
  11815.  
  11816.  
  11817.  
  11818.  
  11819.  
  11820.  
  11821.  
  11822.  
  11823.      --------------------------------------------------------------------------
  11824.      #STEP                                                             Debugging
  11825.      --------------------------------------------------------------------------
  11826.      Function  Enables or disables single stepping.
  11827.  
  11828.      Syntax    #STEP 0/1
  11829.  
  11830.      Remarks   This  single  command  allows  you  to  single  step  through  an
  11831.                application,  set conditional breakpoints,  and inspect  and edit
  11832.                cells while your application is running.
  11833.  
  11834.                When the  command #STEP  1 is  encountered in  a program,  single
  11835.                stepping  is enabled.    When you  are in  single step  mode, the
  11836.                bottom line of  the screen will  display the prompt "SS:",  along
  11837.                with the  next line of the application to  be executed.  You must
  11838.                press a key (the space bar is good for this) to execute each line
  11839.                of the program.   This allows you  to view the operation  of your
  11840.                program one line  at a time rather  than have it whiz  through at
  11841.                breakneck speed.
  11842.  
  11843.                At  any  point  while  you  are  single   stepping  through  your
  11844.                application you may press  <^F2>.  This key will bring  up a menu
  11845.                of options which  allow you  to view  or change  values of  cells
  11846.                which your application might be using.
  11847.  
  11848.                When the  command #STEP  0 is  encountered in  a program,  single
  11849.                stepping is disabled  and execution of the program  will continue
  11850.                normally.
  11851.  
  11852.                Since  single stepping can  be turned on  or off at  any point in
  11853.                your  program,  #STEP can  be  used  to set  breakpoints  in your
  11854.                application.  Simply put a #STEP  1 command at any point of  your
  11855.                program where you want to break from your program.
  11856.  
  11857.                If  you want to set a  conditional break point (where the program
  11858.                will  stop  only when  a certain  condition  exists), then  use a
  11859.                formula argument for #STEP instead of just 1.
  11860.  
  11861.      Example   #STEP 1
  11862.                turns on single stepping at any point in the program.
  11863.  
  11864.                #STEP [A5;1>3]
  11865.                turns on  single stepping  only if the  value in A5;1  is greater
  11866.                than 3.
  11867.  
  11868.  
  11869.  
  11870.  
  11871.  
  11872.  
  11873.  
  11874.  
  11875.  
  11876.                                          176
  11877.  
  11878.  
  11879.  
  11880.  
  11881.  
  11882.  
  11883.  
  11884.  
  11885.  
  11886.  
  11887.  
  11888.  
  11889.      --------------------------------------------------------------------------
  11890.      #UPDATE                                                        Input/Output
  11891.      --------------------------------------------------------------------------
  11892.      Function  Enables or disables screen updating.
  11893.  
  11894.      Syntax    #UPDATE 0/1
  11895.  
  11896.      Remarks   This command  toggles ProQube Lite  screen updating  on and  off.
  11897.                This command is  useful to keep screen updating  from overwriting
  11898.                boxes and windows  which your application  has placed on  screen.
  11899.                #UPDATE 0 disables screen updating,  and #UPDATE 1 enables screen
  11900.                updating.  #UPDATE can be used at any point in the application to
  11901.                turn updating on or off.
  11902.  
  11903.      Example   #UPDATE 0
  11904.                disables screen updating.
  11905.  
  11906.                #UPDATE [A1;1>1]
  11907.                enables screen updating if A1;1 is greater than one.
  11908.  
  11909.  
  11910.  
  11911.  
  11912.      --------------------------------------------------------------------------
  11913.      #WAIT                                                          Input/Output
  11914.      --------------------------------------------------------------------------
  11915.      Function  Prompt and wait for a key press.
  11916.  
  11917.      Syntax    #WAIT x,y prompt
  11918.  
  11919.      Remarks   This  command displays  prompt at screen  position x,y,  and then
  11920.                waits for you  to press a  key.  This  command is similar  to the
  11921.                #KEY  command,  except  that  the  keystroke  is  not  saved  for
  11922.                processing.
  11923.  
  11924.      See Also  #KEY
  11925.  
  11926.      Example   #WAIT 10,10 "Press a key to continue"
  11927.                displays  Press a key  to continue and  waits for you  to press a
  11928.                key.
  11929.  
  11930.  
  11931.  
  11932.  
  11933.  
  11934.  
  11935.  
  11936.  
  11937.  
  11938.  
  11939.  
  11940.  
  11941.  
  11942.                                          177
  11943.  
  11944.  
  11945.  
  11946.  
  11947.  
  11948.  
  11949.  
  11950.  
  11951.  
  11952.  
  11953.  
  11954.  
  11955.      --------------------------------------------------------------------------
  11956.      #WHILE / #ENDWHILE                                                  Control
  11957.      --------------------------------------------------------------------------
  11958.      Function  Repeat some commands while a condition exists.
  11959.  
  11960.      Syntax    #WHILE boolean formula
  11961.                  {some commands}
  11962.                #ENDWHILE 
  11963.  
  11964.      Remarks   This command  repeat a  command or  set of  commands  as long  as
  11965.                boolean formula  is TRUE.  If  boolean formula is FALSE  when the
  11966.                #WHILE is first  reached, the  commands will not  be executed  at
  11967.                all.
  11968.  
  11969.                The  #ENDWHILE command  will cause  execution to  branch back  to
  11970.                #WHILE so that boolean formula may be tested again.
  11971.  
  11972.      See Also  #FOR, #REPEAT
  11973.  
  11974.      Example   #WHILE a1;1<10 
  11975.                  #INC a1;1 1.3 
  11976.                #ENDWHILE
  11977.  
  11978.                While the  value in cell a1;1 is less  than 10, ProQube Lite will
  11979.                increment the value of cell a1;1 by 1.3.
  11980.  
  11981.  
  11982.  
  11983.  
  11984.  
  11985.  
  11986.  
  11987.  
  11988.  
  11989.  
  11990.  
  11991.  
  11992.  
  11993.  
  11994.  
  11995.  
  11996.  
  11997.  
  11998.  
  11999.  
  12000.  
  12001.  
  12002.  
  12003.  
  12004.  
  12005.  
  12006.  
  12007.  
  12008.                                          178
  12009.  
  12010.  
  12011.  
  12012.  
  12013.  
  12014.  
  12015.  
  12016.  
  12017.  
  12018.  
  12019.  
  12020.  
  12021.      --------------------------------------------------------------------------
  12022.      #WINDOW                                                        Input/Output
  12023.      --------------------------------------------------------------------------
  12024.      Function  Displays a window on the screen.
  12025.  
  12026.      Syntax    #WINDOW x1,y1 save title
  12027.  
  12028.      Remarks   This  command is  a special version  of the  #BOX command.   This
  12029.                command,  along with the  #WINTEXT command, allows  you to easily
  12030.                create text windows without having to calculate how wide and tall
  12031.                the box should  be, or what screen coordinates to  use to display
  12032.                text in the box.
  12033.  
  12034.                This command displays a box on the screen.  The upper left corner
  12035.                of the  box is located at screen position x1,y1, and the position
  12036.                of the lower  right corner  of the box  is calculated by  ProQube
  12037.                Lite based on  the number  and length of  the following  #WINTEXT
  12038.                commands.
  12039.  
  12040.                save determines  whether ProQube Lite  saves the contents  of the
  12041.                screen under  the box  before displaying it.   If save  equals 0,
  12042.                then the screen contents  are not saved.  If save  equals 1, then
  12043.                the screen  contents are  saved, and  can be  restored using  the
  12044.                #CLEARBOX command.
  12045.  
  12046.      See Also  #WINTEXT, #BOX, #CLEARBOX, #RESTORE
  12047.  
  12048.      Example   #WINDOW 10,5 1 "My Window"
  12049.                  #WINTEXT "Here is some text"
  12050.                  #WINTEXT ["Name: "+a1;1]
  12051.                  #WINTEXT "Some more text"
  12052.  
  12053.                These  lines will  create  a  box with  the  title  My Window  at
  12054.                position 10,5 on  the screen.   The box will  be large enough  to
  12055.                hold 3 lines of text, and wide enough to hold the widest of the 3
  12056.                lines.
  12057.  
  12058.  
  12059.  
  12060.  
  12061.  
  12062.  
  12063.  
  12064.  
  12065.  
  12066.  
  12067.  
  12068.  
  12069.  
  12070.  
  12071.  
  12072.  
  12073.  
  12074.                                          179
  12075.  
  12076.  
  12077.  
  12078.  
  12079.  
  12080.  
  12081.  
  12082.  
  12083.  
  12084.  
  12085.  
  12086.  
  12087.      --------------------------------------------------------------------------
  12088.      #WINTEXT                                                       Input/Output
  12089.      --------------------------------------------------------------------------
  12090.      Function  Displays text in a window.
  12091.  
  12092.      Syntax    #WINTEXT line
  12093.  
  12094.      Remarks   This  command  displays  line in  the  currently  defined window.
  12095.                #WINDOW will automatically adjust the size  of the window to hold
  12096.                the width of line.
  12097.  
  12098.      See Also  #WINDOW
  12099.  
  12100.      Example   #WINDOW 10,5 1 "My Window"
  12101.                  #WINTEXT "Here is some text"
  12102.                  #WINTEXT ["Name: "+a1;1]
  12103.                  #WINTEXT "Some more text"
  12104.  
  12105.                These  lines  will create  a  box with  the  title  My Window  at
  12106.                position 10,5  on the screen.   The box  will be large  enough to
  12107.                hold 3 lines of text, and wide enough to hold the widest of the 3
  12108.                lines.
  12109.  
  12110.  
  12111.  
  12112.  
  12113.  
  12114.  
  12115.  
  12116.  
  12117.  
  12118.  
  12119.  
  12120.  
  12121.  
  12122.  
  12123.  
  12124.  
  12125.  
  12126.  
  12127.  
  12128.  
  12129.  
  12130.  
  12131.  
  12132.  
  12133.  
  12134.  
  12135.  
  12136.  
  12137.  
  12138.  
  12139.  
  12140.                                          180
  12141.  
  12142.  
  12143.  
  12144.  
  12145.  
  12146.  
  12147.  
  12148.  
  12149.  
  12150.  
  12151.  
  12152.  
  12153.      APPENDIX A  SUPPLEMENT PROGRAMS
  12154.  
  12155.      ProQube Lite provides  a QubeCalc conversion  program, and a setup  program
  12156.      which allows you to customize ProQube Lite's appearance and functionality.
  12157.  
  12158.  
  12159.      QUBECALC CONVERSION PROGRAM
  12160.      ProQube Lite provides a conversion program  to translate your QubeCalc data
  12161.      files into the ProQube Lite format.  To run the conversion program, type:
  12162.  
  12163.      CONVERT filename<Enter>
  12164.  
  12165.      at the DOS prompt, where filename is the name of the QubeCalc file you want
  12166.      converted.
  12167.  
  12168.      The convert program  will read the QubeCalc  file into memory, and  write a
  12169.      ProQube  Lite file  back out to  disk (your  original QubeCalc file  is not
  12170.      modified in any way).  The convert program will  create the ProQube file in
  12171.      the same directory that the  QubeCalc file is in, so  you may want to  copy
  12172.      the QubeCalc  files into  your ProQube  Lite directory  before running  the
  12173.      convert program.
  12174.  
  12175.      Since QubeCalc and ProQube Lite are not just different versions of the same
  12176.      program, there are several limitations to the conversion which this program
  12177.      can do:
  12178.  
  12179.      1) The @cell,  @index, and @cgr functions  in QubeCalc do not  work exactly
  12180.      the same way in ProQube Lite.   When one of these @functions is encountered
  12181.      during the  conversion, a  message is  displayed that  the convert  program
  12182.      could not translate  that formula.   You need to  reenter these  particular
  12183.      formulas in by hand in ProQube Lite.
  12184.  
  12185.      2)  Linking  to other  spreadsheets  on  disk is  performed  differently in
  12186.      ProQube Lite than it was in QubeCalc.  If your QubeCalc  worksheets use the
  12187.      /Block  Link command, then you need  to re-establish those links in ProQube
  12188.      Lite using the /File Link command.
  12189.  
  12190.      3) Column widths are not transfered in the conversion.
  12191.  
  12192.  
  12193.  
  12194.  
  12195.  
  12196.  
  12197.  
  12198.  
  12199.  
  12200.  
  12201.  
  12202.  
  12203.  
  12204.  
  12205.  
  12206.                                          181
  12207.  
  12208.  
  12209.  
  12210.  
  12211.  
  12212.  
  12213.  
  12214.  
  12215.  
  12216.  
  12217.  
  12218.  
  12219.      THE SETUP PROGRAM
  12220.      ProQube Lite  includes a setup  program which allows  you to  customize the
  12221.      functionality and appearance  of ProQube Lite on  your system.  To  run the
  12222.      setup program, simply type:
  12223.  
  12224.      SETUP<Enter>
  12225.  
  12226.      at the DOS prompt.
  12227.  
  12228.      The setup program will display the following menu at the top of the screen:
  12229.  
  12230.  
  12231.      Colors  Defaults  Update  Quit
  12232.  
  12233.  
  12234.      Colors    This option allows you to select which colors ProQube Lite should
  12235.                use for the different parts of the display.  When you select this
  12236.                option you  will  see a  menu listing  the various  parts of  the
  12237.                screen which may be changed, as well as a sample  display showing
  12238.                the current colors.
  12239.  
  12240.                You may then  select an item you want to change the color of (for
  12241.                example, the axes  and cell pointer).  A window will pop up which
  12242.                displays  all of the colors available.   You select the color you
  12243.                want by moving the  cursor to that color with the  arrow keys and
  12244.                pressing <Enter>.  The sample display will be updated to show the
  12245.                new color you just selected.
  12246.  
  12247.                When you are satisfied with the screen colors, simply press <Esc>
  12248.                to return to the main menu.  Make sure you use the Update command
  12249.                from the main menu to make your changes permanent.
  12250.      Defaults  This option allows  you to set  various options which affect  how
  12251.                ProQube Lite operates.   All full  screen menu will appear  which
  12252.                shows  the  options as  well as  their current  values.   You can
  12253.                select an  item to modify  by pressing  the first  letter of  the
  12254.                item, or by  highlighting the item using the  <Up> and <Down> key
  12255.                and pressing <Enter>.
  12256.  
  12257.                43 Row Mode         This option  allows ProQube Lite  to start up
  12258.                                    in 43 line  mode if  you have an  EGA or  VGA
  12259.                                    card.
  12260.  
  12261.                Insert Mode         This option allows you to set ProQube Lite to
  12262.                                    default to  either insert  mode or  overwrite
  12263.                                    mode.
  12264.  
  12265.                Black & White       Setting  this option  to  YES causes  ProQube
  12266.                                    Lite to use  black and white whether  a color
  12267.                                    card is detected or not.  This is useful when
  12268.                                    your system has a color card but a monochrome
  12269.                                    monitor.    This  particular  combination  of
  12270.                                    hardware  often  causes problems  with colors
  12271.  
  12272.                                          182
  12273.  
  12274.  
  12275.  
  12276.  
  12277.  
  12278.  
  12279.  
  12280.  
  12281.  
  12282.  
  12283.  
  12284.  
  12285.                                    which are not visible on screen.
  12286.  
  12287.                Menu Style          This  option  allows  you to  select  whether
  12288.                                    ProQube Lite  uses BackTrack  menus or  Lotus
  12289.                                    style  menus.    With  BackTrack  menus,  the
  12290.                                    previous menu levels remain on screen so that
  12291.                                    you can see how  you got to the  current menu
  12292.                                    level.  Lotus style menus write over previous
  12293.                                    menu levels.
  12294.  
  12295.                Currency/Number     This option  allows you to  select the format
  12296.                                    to use  for numbers  and currency.   Normally
  12297.                                    ProQube  Lite uses  a period for  the decimal
  12298.                                    point, and a  comma as the separator  between
  12299.                                    thousands, millions, etc.  Many countries use
  12300.                                    these characters in the opposite manner.   If
  12301.                                    you choose to  use the comma for  the decimal
  12302.                                    point,  then  you  must  use  the  colon   to
  12303.                                    separate arguments in @functions.
  12304.  
  12305.                                    This option also  allows you to select  which
  12306.                                    character  (or  characters) to  use  for your
  12307.                                    currency  symbol.    You  may  replace the  $
  12308.                                    symbol with any other  available symbol.  You
  12309.                                    may also  set the currency  symbol to  follow
  12310.                                    (suffix)  the value  rather  than prefix  the
  12311.                                    value.
  12312.  
  12313.                Page changing       This option allows to  to swap the  functions
  12314.                                    of  the <PgUp>/<PgDn> keys  with those of the
  12315.                                    <^PgUp> /  <^PgDn> keys.  By  default ProQube
  12316.                                    Lite uses <PgUp> and <PgDn> to move from page
  12317.                                    to page within the  3D worksheet, and <^PgUp>
  12318.                                    and <^PgDn> to move up and down one screen of
  12319.                                    data.
  12320.  
  12321.      Update    This option updates ProQube Lite's configuration  file PQLITE.CFG
  12322.                with  the  changes you  have made  from  the Colors  and Defaults
  12323.                menus, and then exits from the setup program.
  12324.  
  12325.      Quit      This option allows  you to  exit from the  setup program  without
  12326.                updating  ProQube  Lite's configuration  file  PQLITE.CFG.   This
  12327.                command should be used when you  want to ignore changes you  have
  12328.                just made to the defaults or colors.
  12329.  
  12330.  
  12331.  
  12332.  
  12333.  
  12334.  
  12335.  
  12336.  
  12337.  
  12338.                                          183
  12339.  
  12340.  
  12341.  
  12342.  
  12343.  
  12344.  
  12345.  
  12346.  
  12347.  
  12348.  
  12349.  
  12350.  
  12351.      APPENDIX B  DESIGN HINTS
  12352.  
  12353.      There  are  a  number of  considerations  when  designing  a 3  dimensional
  12354.      spreadsheet, such as page layout and memory usage.
  12355.  
  12356.      Page Layout    It may take a little practice to get the hang of creating 3D
  12357.                     spreadsheets which look elegant from  any perspective.  Here
  12358.                     are  a few  hints  to  help  make things  go  a  little  bit
  12359.                     smoother.
  12360.  
  12361.                     Although ProQube Lite  will allow each page  in the WorkQube
  12362.                     to  be   completely  different,  your  template   should  be
  12363.                     consistent from  page to  page if  you want  to rotate  your
  12364.                     worksheet.  For example, if January 1985 data is in column D
  12365.                     in one  page, January data for other years should also be in
  12366.                     column  D in their respective pages.   And if Joe's sales in
  12367.                     one  time period  are in row  25 in  one page, his  sales in
  12368.                     other time periods should be  in row 25 in the other  pages.
  12369.                     This will ensure that similar data will be together when the
  12370.                     WorkQube is viewed from other perspectives.
  12371.  
  12372.                     You will also want to leave the first couple of pages in the
  12373.                     front face available  for use as  row headings in the  right
  12374.                     face.
  12375.  
  12376.      Memory Usage   ProQube Lite's memory  allocation scheme is optimized  for 3
  12377.                     dimensional data.  This means that you will be able to enter
  12378.                     less data  into a single  large page  than into a  number of
  12379.                     smaller  pages.    The  more cubic  the  structure  of  your
  12380.                     worksheet (rows = columns = pages),  the more cells you will
  12381.                     be able to fill with data.
  12382.  
  12383.                     For example, if you find yourself running out of memory with
  12384.                     a  one  page worksheet  which  is  10 columns  by  500 rows,
  12385.                     breaking your worksheet into  ten 10 column by 50  row pages
  12386.                     will solve your problem (and give you memory to spare).
  12387.  
  12388.  
  12389.  
  12390.  
  12391.  
  12392.  
  12393.  
  12394.  
  12395.  
  12396.  
  12397.  
  12398.  
  12399.  
  12400.  
  12401.  
  12402.  
  12403.  
  12404.                                          184
  12405.  
  12406.  
  12407.  
  12408.  
  12409.  
  12410.  
  12411.  
  12412.  
  12413.  
  12414.  
  12415.  
  12416.  
  12417.      INDEX
  12418.  
  12419.      @functions  93
  12420.      1-2-3  71, 73
  12421.      Absolute cell reference  15
  12422.      Addition  12
  12423.      Anchor  16
  12424.      And  12
  12425.      Application  153
  12426.           breaking from  41, 163
  12427.           debugging  40, 166, 176
  12428.           editor  34, 89
  12429.           running  91, 155
  12430.      Arguments  93, 159
  12431.      Arrow keys  8
  12432.      ASCII  71, 74
  12433.      Asterisk  22, 25
  12434.      Back  28, 61
  12435.      Block name  14, 16, 39, 51
  12436.      Blocks, defining  16
  12437.      Borders  77, 78
  12438.      Bottom  28
  12439.      Branching commands  161
  12440.      Break point  176
  12441.      CALC  63
  12442.      Cell  4, 15
  12443.      Cell pointer  8
  12444.      CIRC  14
  12445.      Circular reference  14
  12446.      Colors  182
  12447.      Column width  5, 25, 44, 48, 59
  12448.      Combining files  68
  12449.      Comma  23
  12450.      Commands  43
  12451.      Comparison  12
  12452.      Configuration  182
  12453.      Consolidation  26, 75
  12454.      Converting QubeCalc files  181
  12455.      Copying
  12456.           blocks  50
  12457.           cell  46
  12458.           columns  54
  12459.           pages  58
  12460.           rows  56
  12461.      Currency format  23
  12462.      Customize  182
  12463.      Cut  35
  12464.      Data entry  10, 42
  12465.      Data functions  97
  12466.      Date entry  24
  12467.      Date formats  24
  12468.      Date functions  96
  12469.  
  12470.                                          185
  12471.  
  12472.  
  12473.  
  12474.  
  12475.  
  12476.  
  12477.  
  12478.  
  12479.  
  12480.  
  12481.  
  12482.  
  12483.      DBase  71, 73
  12484.      Decimal places  23
  12485.      Defaults  182
  12486.      Defining blocks  16
  12487.      Deleting
  12488.           columns  53
  12489.           pages  57
  12490.           rows  55
  12491.      DIF  71, 74
  12492.      Directory  22, 65
  12493.      Division  12
  12494.      Dollar format  23
  12495.      Editing  11, 38
  12496.      Editor  34
  12497.      EGA  42
  12498.      End key  8
  12499.      Erasing
  12500.           blocks  49
  12501.           cells  45
  12502.           columns  53
  12503.           pages  57
  12504.           rows  55
  12505.           worksheet  60
  12506.      Exiting  92
  12507.      Exponentiation  12
  12508.      Exporting
  12509.           1-2-3  73
  12510.           ASCII  74
  12511.           dBase  73
  12512.           DIF  74
  12513.      Extract  70
  12514.      Faces  28, 61
  12515.      File Manager  22, 64, 66
  12516.      Financial functions  95
  12517.      Fixed format  23
  12518.      Fonts  83
  12519.      Footer  81
  12520.      Formatting cells  23, 44, 48, 59
  12521.      Formulas  12, 26
  12522.      Front  28, 61
  12523.      Function keys  38
  12524.      Functions  93
  12525.      General format  23
  12526.      GoTo  39
  12527.      Header  81
  12528.      Help  7, 38
  12529.      Hidden
  12530.           cells  25
  12531.           columns  44
  12532.      Highlighting blocks  16
  12533.      Importing
  12534.           1-2-3  71
  12535.  
  12536.                                          186
  12537.  
  12538.  
  12539.  
  12540.  
  12541.  
  12542.  
  12543.  
  12544.  
  12545.  
  12546.  
  12547.  
  12548.  
  12549.           ASCII  71
  12550.           dBase  71
  12551.           DIF  71
  12552.      Info  40
  12553.      Inserting
  12554.           columns  53
  12555.           pages  57
  12556.           rows  55
  12557.      Installing ProQube Lite  2
  12558.      Justify  10
  12559.      Left  28, 61
  12560.      Linking  26, 75
  12561.      Locking
  12562.           cells  62
  12563.           titles  61
  12564.      Logical functions  96
  12565.      Lookup tables  115, 150
  12566.      Looping commands  161
  12567.      Lotus  71, 73
  12568.      Macro  153
  12569.           breaking from  41, 163
  12570.           debugging  40, 166, 176
  12571.           editor  34, 89
  12572.           recorder  33, 42
  12573.           running  91, 155
  12574.      Margins
  12575.              80, 85
  12576.      Mark  41
  12577.      Mask  22, 41, 66
  12578.      Math functions  93
  12579.      Memory  42, 184
  12580.      Menu  43
  12581.      Mouse  7, 9, 19, 38
  12582.      Movement  8
  12583.      Moving
  12584.           blocks  50
  12585.           cell  46
  12586.           columns  54
  12587.           pages  58
  12588.           rows  56
  12589.      Multiplication  12
  12590.      Named blocks  51
  12591.      Not  12
  12592.      Numbers  10
  12593.      Operating system  92
  12594.      Operators  12
  12595.      Or  12
  12596.      Page  4, 26, 28
  12597.      Page number  81, 82
  12598.      Paste  35
  12599.      PCL  153, 159
  12600.      Percent format  24
  12601.  
  12602.                                          187
  12603.  
  12604.  
  12605.  
  12606.  
  12607.  
  12608.  
  12609.  
  12610.  
  12611.  
  12612.  
  12613.  
  12614.  
  12615.      Perspective  28
  12616.      Point mode  13
  12617.      PQLITE.CFG  183
  12618.      Precedence  13
  12619.      Printing
  12620.           text  32, 77-82, 85
  12621.      Programming  159
  12622.      ProQube Command Language  153, 159
  12623.      Protection  47, 52, 62
  12624.      QubeCalc  181
  12625.      Quitting  92
  12626.      REC  33, 42
  12627.      Recalculation  63
  12628.      Recording macros  33, 42
  12629.      References  15
  12630.      Relative cell reference  15
  12631.      Replaying macros  33
  12632.      Retrieving files  64, 68
  12633.      Right  28, 61
  12634.      Rotating  28, 61
  12635.      Saving files  64, 70
  12636.      Scientific format  24
  12637.      Search & replace  39
  12638.      Setup strings  47, 52, 62, 83
  12639.      Shell to DOS  92
  12640.      Single step  176
  12641.      Sort  86
  12642.      Statistical functions  94
  12643.      Status  42
  12644.      String functions  97
  12645.      Subroutines  161
  12646.      Subtraction  12
  12647.      Text  10
  12648.      Text editor  34
  12649.      Text functions  97
  12650.      Time formats  24
  12651.      Time functions  96
  12652.      Title locking  61
  12653.      ToMark  41
  12654.      Top  28, 61
  12655.      Transpose  31
  12656.      Trigonometry functions  94
  12657.      Under  28, 61
  12658.      VGA  42
  12659.      Views  28, 61
  12660.      Window  179
  12661.      WK1  71, 73
  12662.      WKS  71, 73
  12663.      WorkQube  4, 5
  12664.      Xtract  70
  12665.      Zero suppression  63
  12666.  
  12667.  
  12668.                                          188
  12669.  
  12670.  
  12671.  
  12672.  
  12673.  
  12674.