OS/2 Professional/OS2PRO194.ISO/os2/wps/progs/calc/katcalc/katcalc.hlp

OS/2 Help File | 1990-05-13 | 18.9 KB | 478 lines

ΓòÉΓòÉΓòÉ 1. Uses of KATCalc ΓòÉΓòÉΓòÉ

KATCalc is a programmable, graphing calculator for the OS/2 Presentation
Manager. It performs most trigonometric functions including cosine, sine, and
tangent. Also available are many programmer functions including hexadecimal
arithmetic, and decimal-hexadecimal conversions.

For information on registering your copy of KATCalc please see the topic
Ordering KATCalc

You should see the main KATCalc calculator body window and its two control
windows. To the left of KATCalc is its memory storage window. You may store one
value in each of the ten register entryfields. To put a value into memory push
the <MIn> button on the calculator. Next mouse over to the memory window and
push the button next to the entryfield you wish to fill. Since these are
entryfields you may also type directly into them. To use the values press the
<MOut> button and then push the memory register button whose value you want.
This number is then placed in the calculator's display.

To the calculator's right is its ticker-tape window. This is a "hard-copy" of
all your calculations. It has resizable borders if you wish to see more or
less. Scroll bars allow traverse through the tape.

You may erase the contents of either of these two windows. To reset all of the
memory registers to zero push the <MC> button. The <TC> button erases the
ticker-tape window.

Most of the buttons on KATCalc should would as you would expect. A few
explanations follow.

The <Prog> button will create a window with your current program list. This new
window has choices of Create, Delete, Edit, Help, Rename and Run. For more
information see the topic  Program Listing

The <Graph> button is used to graph a function. A dialog box will pop-up asking
for the function and its domain. For more help see the topic  Graphing a
Function

The <Hex> button will allow hexadecimal calculations. The <Dec> button will
return to decimal mode.

The <> button functions as a backspace.


ΓòÉΓòÉΓòÉ 2. Ordering KATCalc ΓòÉΓòÉΓòÉ

KATCalc is distributed by shareware. This means you may freely pass this
program, in its entirety, to your friends and associates. They must, however,
register their respective copies if they intend to use the calculator.

The price of registering KATCalc is $30.00 U.S. funds.

If you are a Texas resident please add $1.80 for Texas State Sales Tax.

Please make a check or money order payable to The KAT Works. Send your payment,
name, and mailing address to :

  The KAT Works
  PO Box 820748
  North Richland Hills, TX 76118-0748

Your registration fee allows you

  1. free technical support for KATCalc via mail correspondence,

  2. notification of KATCalc software updates

  3. notification of new products from The KAT Works at reduced prices

 After you register your copy of KATCalc make as many backup copies of KATCalc
 as you need. You may also copy KATCalc to all of your personal computers. If
 you have a desktop and a portable please feel free to make use of KATCalc on
 both of them.


ΓòÉΓòÉΓòÉ 3. Creating and Editing a Program ΓòÉΓòÉΓòÉ

KATCalc's language consists of the mathematical manipulation and comparing of
internal registers.  The registers you use in your program are numbered R0
through R19.  These twenty registers are internal to the program and do not
change the values in the calculator's memory window.

Why would you want to progarm? A program is good for a repeated number of
calculations that can be made easier by prompts to automatic calculations. For
example, a person could run a program that asks for an angle in degrees and
gets back that angle in radians. A rather simple example but the theory is
sound. A program should make a person's life easier by saving him time and
effort. There are several demo programs that come with KATCalc. Edit them to
get inspiration and ideas for what constitutes a program.

Following this is a the list of the function you may use in writing a program.
In the syntax of the functions the following symbols are used:

     <char>    a single character
                  ex. A, k, 1, @, ", 


     <regxx>   the value in this particular memory register

     <string>  a character, word, or sentence
                  ex. Now is the time
                      A
                      123.55 is the purchase cost!

     <float>   a floating point number
                  ex. -123.44
                      +123.45492
                      .12345

The programming functions are:

* Comment Code

A programmer's comment. The asterisk must be the first character in the line.
None of the text following the asterisk is executed.

: Define Label

Declares a label. Any characters may be used, but the first colon is not part
of the label. Also the label is case-insensitive so Begin, BEGin, and bEgIn are
the same. Spaces are not allowed in the label; for clarity try the underscore
character.

   :Initialize
   :BEGIN
   :Loop1
   :loop_for_printing_response
   :ERROR!!!

ADD Addition

You may add two memory registers together, or add a value to a register.
Examples of the two possiblites are:

   ADD   R1, R2         <reg1> = <reg1> plus <reg2>
   ADD   R1, 339.23     <reg1> = <reg1> plus <float>

CLRM Clear Memory

Set all of the memory registers to zero.

   CLRM

CLRS Clear Screen

The output window is immediately cleared.

   CLRS

DIV Division

You may divide a memory register into another, or divide a register by a value.

   DIV   R0, R19        <reg0> = <reg0> Ў <reg19>
   DIV   R0, 56         <reg0> = <reg0> Ў <float>

J Jump

Unconditionaly execute another part of this program by jumping to a label.

   J   Quit             jump to <string>

JE Jump if Equal

Compare a register with another register or a value, if they are equal then
jump to a label.

   JE   R1, R2, BEGIN   if <reg1> = <reg2> jump to <string>
   JE   R1, 23, BEGIN   if <reg1> = <float> jump to <string>

JG Jump if Greater

Compare a register with another register or a value, if the first register is
greater then jump to a label.

   JG   R0, R13, QUIT   if <reg0> > <reg13> jump to <string>
   JG   R0, 1.3, INIT   if <reg0> > <float> jump to <string>

JL Jump if Less

Compare a register with another register or a value, if the first register is
less then jump to a label.

   JL   R4, R3, Done    if <reg4> < <reg3> jump to <string>
   JL   R2, 39, loop_1  if <reg2> < <float> jump to <string>

LN Natural Logarithm

Return the logarithm base 2 of the number in a register.

   LN   R0              <reg0> = Log2<reg0>

LOG Logarithm Base 10

Return the lagarithm base 10 of the number in a register.

   LOG   R0             <reg0> = Log10<reg0>

MOV Move

Move the contents of a register or a value into a memory register.

   MOV   R1, R5         <reg1> = <reg5>
   MOV   R10, 783.2     <reg10> = <float>

MUL Multiplication

Multiply a register by the contents of another register or a value.

   MUL   R3, R12        <reg3> = <reg3> * <reg12>
   MUL   R3, 893        <reg3> = <reg3> * <float>

POW Exponential

Raise a register to the power of another register or a value.

   POW   R1, R2         <reg1> = <reg1> to the power of <reg2>
   POW   R1, 3          <reg1> = <reg1> to the power ot <float>

RD Read

Read a value and place it into a memory register. If the input was a character
or symbol the  ASCII value of that character is placed into the register.

   RD   R15             <reg15> = <float> or <char>

SUB Subtraction

Subtract a register from another register, or subtract a value from a register.

   SUB   R1, R2         <reg1> = <reg1> - <reg2>
   SUB   R1, 23421      <reg1> = <reg1> - <float>

WD Write to Device

Writes the contents of a <reg> or a <string> to the output window. Examples

   WD R0
   WD R1
   WD [A] for choice alpha
   WD Relate this to him!


ΓòÉΓòÉΓòÉ 4. Graphing a Function ΓòÉΓòÉΓòÉ

Enter  a  function  involving  X  in  the  Я ( x )  entryfield .  Your
function  may  contain  the  following  arithmetical  operations :

 +    Addition

 -    Subtraction

 *    Multiplication

 /    Division

 sqrt   The  square  root  of  X

 ^    Exponential

 ~  ( tilde )   The  opposite  of

 (  )   Parens  -  order  of  precedence

 The  following  trig  functions  may  also  be  used :

 cos   The  cosine  of  X

 sin   The  sine  of  X

 tan   The  tangent  of  X

 Keep  the  following  rules  in  mind  when  composing  a  function :

  1 . The  functions  and  operations  listed  above  may  be  freely  mixed
     in  an  equaltion .

  2 . Please  be  sure  to  explicitly  list  the  multiplication  symbol .

                  5 * X  not  5X

  3. Parens may be used at will to denote the precedence of your function. As
     you would guess please be sure to match an open paren with a close paren.

  4. The only variable you may use is X. The domain of X is described in the
     three entryfields Start, End, By  under the Domain heading of the dialog
     box.

  5. The physical dimensions of the window provide for the Y-Axis to have
     coordinates from 78 to -78 and the X-axis from -100 to 100. Using the Zoom
     factor you can effectivly increase, or decrease, these dimensions. As you
     increase the number in Zoom you decrease the dimensions of the axis,
     likewise the smaller the number the larger the dimensions of the axis.

 Some examples of graphing functions:

       X^2                X squared
       X^3                X cubed
       X^.5               the square root of X
       sin(x + 1)         the sine of the quantity X plus one
       sin(x) + 1         the sine of X, plus one
       cosx * (x + 1)     the cosine of X, times the quantity X plus one

 When you have generated a graph you like you may "rip-off" the graph by
 positioning your mouse pointer over the display window and pressing the left
 button down. You may now grab and pull the window to a clear position on the
 desktop. Releasing the left mouse button drops the window.

 You may change any of the graph's attributes by double-clicking the left mouse
 button on the graph window. The Graph Я(x) dialog will appear. Make any
 changes you want, press the graph button, and the graph will change
 accordingly.


ΓòÉΓòÉΓòÉ 5. The ASCII Chart ΓòÉΓòÉΓòÉ


   Dec   Hex  Ch      Dec   Hex  Ch     Dec   Hex  Ch      Dec   Hex  Ch
 ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ
 Γöé   0 Γöé  0 Γöé   Γöé   Γöé  32 Γöé 20 Γöé   Γöé   Γöé  64 Γöé 40 Γöé @ Γöé   Γöé  96 Γöé 60 Γöé ` Γöé
 Γöé   1 Γöé  1 Γöé 
 Γöé   Γöé  33 Γöé 21 Γöé ! Γöé   Γöé  65 Γöé 41 Γöé A Γöé   Γöé  97 Γöé 61 Γöé a Γöé
 Γöé   2 Γöé  2 Γöé  Γöé   Γöé  34 Γöé 22 Γöé " Γöé   Γöé  66 Γöé 42 Γöé B Γöé   Γöé  98 Γöé 62 Γöé b Γöé
 Γöé   3 Γöé  3 Γöé  Γöé   Γöé  35 Γöé 23 Γöé # Γöé   Γöé  67 Γöé 43 Γöé C Γöé   Γöé  99 Γöé 63 Γöé c Γöé
 Γöé   4 Γöé  4 Γöé  Γöé   Γöé  36 Γöé 24 Γöé $ Γöé   Γöé  68 Γöé 44 Γöé D Γöé   Γöé 100 Γöé 64 Γöé d Γöé
 Γöé   5 Γöé  5 Γöé  Γöé   Γöé  37 Γöé 25 Γöé % Γöé   Γöé  69 Γöé 45 Γöé E Γöé   Γöé 101 Γöé 65 Γöé e Γöé
 Γöé   6 Γöé  6 Γöé  Γöé   Γöé  38 Γöé 26 Γöé & Γöé   Γöé  70 Γöé 46 Γöé F Γöé   Γöé 102 Γöé 66 Γöé f Γöé
 Γöé   7 Γöé  7 Γöé  Γöé   Γöé  39 Γöé 27 Γöé ' Γöé   Γöé  71 Γöé 47 Γöé G Γöé   Γöé 103 Γöé 67 Γöé g Γöé
 Γöé   8 Γöé  8 Γöé  Γöé   Γöé  40 Γöé 28 Γöé ( Γöé   Γöé  72 Γöé 48 Γöé H Γöé   Γöé 104 Γöé 68 Γöé h Γöé
 Γöé   9 Γöé  9 Γöé   Γöé   Γöé  41 Γöé 29 Γöé ) Γöé   Γöé  73 Γöé 49 Γöé I Γöé   Γöé 105 Γöé 69 Γöé i Γöé
 Γöé  10 Γöé  A Γöé   Γöé   Γöé  42 Γöé 2A Γöé * Γöé   Γöé  74 Γöé 4A Γöé J Γöé   Γöé 106 Γöé 6A Γöé j Γöé
 Γöé  11 Γöé  B Γöé  Γöé   Γöé  43 Γöé 2B Γöé + Γöé   Γöé  75 Γöé 4B Γöé K Γöé   Γöé 107 Γöé 6B Γöé k Γöé
 Γöé  12 Γöé  C Γöé  Γöé   Γöé  44 Γöé 2C Γöé , Γöé   Γöé  76 Γöé 4C Γöé L Γöé   Γöé 108 Γöé 6C Γöé l Γöé
 Γöé  13 Γöé  D Γöé   Γöé   Γöé  45 Γöé 2D Γöé - Γöé   Γöé  77 Γöé 4D Γöé M Γöé   Γöé 109 Γöé 6D Γöé m Γöé
 Γöé  14 Γöé  E Γöé  Γöé   Γöé  46 Γöé 2E Γöé . Γöé   Γöé  78 Γöé 4E Γöé N Γöé   Γöé 110 Γöé 6E Γöé n Γöé
 Γöé  15 Γöé  F Γöé  Γöé   Γöé  47 Γöé 2F Γöé / Γöé   Γöé  79 Γöé 4F Γöé O Γöé   Γöé 111 Γöé 6F Γöé o Γöé
 Γöé  16 Γöé 10 Γöé  Γöé   Γöé  48 Γöé 30 Γöé 0 Γöé   Γöé  80 Γöé 50 Γöé P Γöé   Γöé 112 Γöé 70 Γöé p Γöé
 Γöé  17 Γöé 11 Γöé  Γöé   Γöé  49 Γöé 31 Γöé 1 Γöé   Γöé  81 Γöé 51 Γöé Q Γöé   Γöé 113 Γöé 71 Γöé q Γöé
 Γöé  18 Γöé 12 Γöé  Γöé   Γöé  50 Γöé 32 Γöé 2 Γöé   Γöé  82 Γöé 52 Γöé R Γöé   Γöé 114 Γöé 72 Γöé r Γöé
 Γöé  19 Γöé 13 Γöé  Γöé   Γöé  51 Γöé 33 Γöé 3 Γöé   Γöé  83 Γöé 53 Γöé S Γöé   Γöé 115 Γöé 73 Γöé s Γöé
 Γöé  20 Γöé 14 Γöé  Γöé   Γöé  52 Γöé 34 Γöé 4 Γöé   Γöé  84 Γöé 54 Γöé T Γöé   Γöé 116 Γöé 74 Γöé t Γöé
 Γöé  21 Γöé 15 Γöé  Γöé   Γöé  53 Γöé 35 Γöé 5 Γöé   Γöé  85 Γöé 55 Γöé U Γöé   Γöé 117 Γöé 75 Γöé u Γöé
 Γöé  22 Γöé 16 Γöé  Γöé   Γöé  54 Γöé 36 Γöé 6 Γöé   Γöé  86 Γöé 56 Γöé V Γöé   Γöé 118 Γöé 76 Γöé v Γöé
 Γöé  23 Γöé 17 Γöé  Γöé   Γöé  55 Γöé 37 Γöé 7 Γöé   Γöé  87 Γöé 57 Γöé W Γöé   Γöé 119 Γöé 77 Γöé w Γöé
 Γöé  24 Γöé 18 Γöé  Γöé   Γöé  56 Γöé 38 Γöé 8 Γöé   Γöé  88 Γöé 58 Γöé X Γöé   Γöé 120 Γöé 78 Γöé x Γöé
 Γöé  25 Γöé 19 Γöé  Γöé   Γöé  57 Γöé 39 Γöé 9 Γöé   Γöé  89 Γöé 59 Γöé Y Γöé   Γöé 121 Γöé 79 Γöé y Γöé
 Γöé  26 Γöé 1A Γöé   Γöé   Γöé  58 Γöé 3A Γöé : Γöé   Γöé  90 Γöé 5A Γöé Z Γöé   Γöé 122 Γöé 7A Γöé z Γöé
 Γöé  27 Γöé 1B Γöé  Γöé   Γöé  59 Γöé 3B Γöé ; Γöé   Γöé  91 Γöé 5B Γöé [ Γöé   Γöé 123 Γöé 7B Γöé { Γöé
 Γöé  28 Γöé 1C Γöé  Γöé   Γöé  60 Γöé 3C Γöé < Γöé   Γöé  92 Γöé 5C Γöé \ Γöé   Γöé 124 Γöé 7C Γöé | Γöé
 Γöé  29 Γöé 1D Γöé  Γöé   Γöé  61 Γöé 3D Γöé = Γöé   Γöé  93 Γöé 5D Γöé ] Γöé   Γöé 125 Γöé 7D Γöé } Γöé
 Γöé  30 Γöé 1E Γöé  Γöé   Γöé  62 Γöé 3E Γöé > Γöé   Γöé  94 Γöé 5E Γöé ^ Γöé   Γöé 126 Γöé 7E Γöé ~ Γöé
 Γöé  31 Γöé 1F Γöé  Γöé   Γöé  63 Γöé 3F Γöé ? Γöé   Γöé  95 Γöé 5F Γöé _ Γöé   Γöé 127 Γöé 7F Γöé  Γöé
 ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ


   Dec   Hex  Ch      Dec   Hex  Ch     Dec   Hex  Ch      Dec   Hex  Ch
 ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ
 │ 128 │ 80 │ А │   │ 160 │ A0 │ а │   │ 192 │ C0 │ └ │   │ 224 │ E0 │ р │
 │ 129 │ 81 │ Б │   │ 161 │ A1 │ б │   │ 193 │ C1 │ ┴ │   │ 225 │ E1 │ с │
 │ 130 │ 82 │ В │   │ 162 │ A2 │ в │   │ 194 │ C2 │ ┬ │   │ 226 │ E2 │ т │
 │ 131 │ 83 │ Г │   │ 163 │ A3 │ г │   │ 195 │ C3 │ ├ │   │ 227 │ E3 │ у │
 │ 132 │ 84 │ Д │   │ 164 │ A4 │ д │   │ 196 │ C4 │ ─ │   │ 228 │ E4 │ ф │
 │ 133 │ 85 │ Е │   │ 165 │ A5 │ е │   │ 197 │ C5 │ ┼ │   │ 229 │ E5 │ х │
 │ 134 │ 86 │ Ж │   │ 166 │ A6 │ ж │   │ 198 │ C6 │ ╞ │   │ 230 │ E6 │ ц │
 │ 135 │ 87 │ З │   │ 167 │ A7 │ з │   │ 199 │ C7 │ ╟ │   │ 231 │ E7 │ ч │
 │ 136 │ 88 │ И │   │ 168 │ A8 │ и │   │ 200 │ C8 │ ╚ │   │ 232 │ E8 │ ш │
 │ 137 │ 89 │ Й │   │ 169 │ A9 │ й │   │ 201 │ C9 │ ╔ │   │ 233 │ E9 │ щ │
 │ 138 │ 8A │ К │   │ 170 │ AA │ к │   │ 202 │ CA │ ╩ │   │ 234 │ EA │ ъ │
 │ 139 │ 8B │ Л │   │ 171 │ AB │ л │   │ 203 │ CB │ ╦ │   │ 235 │ EB │ ы │
 │ 140 │ 8C │ М │   │ 172 │ AC │ м │   │ 204 │ CC │ ╠ │   │ 236 │ EC │ ь │
 │ 141 │ 8D │ Н │   │ 173 │ AD │ н │   │ 205 │ CD │ ═ │   │ 237 │ ED │ э │
 │ 142 │ 8E │ О │   │ 174 │ AE │ о │   │ 206 │ CE │ ╬ │   │ 238 │ EE │ ю │
 │ 143 │ 8F │ П │   │ 175 │ AF │ п │   │ 207 │ CF │ ╧ │   │ 239 │ EF │ я │
 │ 144 │ 90 │ Р │   │ 176 │ B0 │ ░ │   │ 208 │ D0 │ ╨ │   │ 240 │ F0 │ Ё │
 │ 145 │ 91 │ С │   │ 177 │ B1 │ ▒ │   │ 209 │ D1 │ ╤ │   │ 241 │ F1 │ ё │
 │ 146 │ 92 │ Т │   │ 178 │ B2 │ ▓ │   │ 210 │ D2 │ ╥ │   │ 242 │ F2 │ Є │
 │ 147 │ 93 │ У │   │ 179 │ B3 │ │ │   │ 211 │ D3 │ ╙ │   │ 243 │ F3 │ є │
 │ 148 │ 94 │ Ф │   │ 180 │ B4 │ ┤ │   │ 212 │ D4 │ ╘ │   │ 244 │ F4 │ Ї │
 │ 149 │ 95 │ Х │   │ 181 │ B5 │ ╡ │   │ 213 │ D5 │ ╒ │   │ 245 │ F5 │ ї │
 │ 150 │ 96 │ Ц │   │ 182 │ B6 │ ╢ │   │ 214 │ D6 │ ╓ │   │ 246 │ F6 │ Ў │
 │ 151 │ 97 │ Ч │   │ 183 │ B7 │ ╖ │   │ 215 │ D7 │ ╫ │   │ 247 │ F7 │ ў │
 │ 152 │ 98 │ Ш │   │ 184 │ B8 │ ╕ │   │ 216 │ D8 │ ╪ │   │ 248 │ F8 │ ° │
 │ 153 │ 99 │ Щ │   │ 185 │ B9 │ ╣ │   │ 217 │ D9 │ ┘ │   │ 249 │ F9 │ ∙ │
 │ 154 │ 9A │ Ъ │   │ 186 │ BA │ ║ │   │ 218 │ DA │ ┌ │   │ 250 │ FA │ · │
 │ 155 │ 9B │ Ы │   │ 187 │ BB │ ╗ │   │ 219 │ DB │ █ │   │ 251 │ FB │ √ │
 │ 156 │ 9C │ Ь │   │ 188 │ BC │ ╝ │   │ 220 │ DC │ ▄ │   │ 252 │ FC │ № │
 │ 157 │ 9D │ Э │   │ 189 │ BD │ ╜ │   │ 221 │ DD │ ▌ │   │ 253 │ FD │ ¤ │
 │ 158 │ 9E │ Ю │   │ 190 │ BE │ ╛ │   │ 222 │ DE │ ▐ │   │ 254 │ FE │ ■ │
 │ 159 │ 9F │ Я │   │ 191 │ BF │ ┐ │   │ 223 │ DF │ ▀ │   │ 255 │ FF │   │
 ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 6. Program Listing ΓòÉΓòÉΓòÉ

This is a list of all your programmed functions. The pushbuttons at the bottom
of this window show your available actions.

You will notice that the programs are not in the usual filename.extension
format. Instead KATCalc uses a new feature of OS/2 1.2 called extended
attributes. Extended attributes (EAs) allow a program like KATCalc to keep
extra information tagged to a file. KATCalc uses EAs to allow you to give your
program files a longer and more meaningful title. This title may be up to 128
characters.

If you look in KATCalc's Working directory you will see your programs. They
have filenames that look like Kxxxxxxx.PGM. If you wish to copy these program
files to floppy disk for transportation to a machine other than an OS/2 1.2
machine (for instance DOS, CMS, or UNIX) you will have to use the OS/2 command
EAUTIL to preserve your titles. This is because OS/2 manages the extended
attributes of a file in a special, hidden, system file instead of "in" the
actual data files themselves. The EAUTIL command tells OS/2 to place the EAs
into a file which you will can copy with the programs.

When when you later place the programs on a target OS/2 computer use EAUTIL
again to rejoin the files with their respective EAs.

An example of this might be sending your programs to a friend in another state
over your companies mainframe network.

   1. From your OS/2 PC
          EAUTIL k0000001.pgm k1.ea /p /s

   2. Upload the files k0000001.pgm and k1.ea to your host mainframe.

   3. Send the two files over the network.

   4. Your friend downloads them to his KATCalc subdirectory on his OS/2 PC.

   5. Your friend types:
         EAUTIL k0000001.pgm k1.ea /j

Your friend can now run the program from the Program Directory in KATCalc.

If you are backing up your programs or transporting them to another OS/2
machine via floppy disk merely:

   COPY *.pgm a:

Since it is an OS/2 to OS/2 migration the EAs will be stored on the floppy by
the source machine and recognize and read by the target machine. The EAUTIL
command is not needed.


ΓòÉΓòÉΓòÉ 7. Installation of KATCalc ΓòÉΓòÉΓòÉ

There is not much extra to do to install KATCalc. Simply add KATCALC.EXE to
your favorite Group. Be sure to specify a Working directory so the calculator
can find its help file and programs (KATCALC.HLP and *.PGM).

Where you place the executable and the programs does not matter, but a new
directory would be the most obvious choice. If you write a large amount of
programs a separate, dedicated KATCalc subdirectory would be a good
organization tool.

When you install KATCalc in whatever Group you choose the following is a
suggested Properties list:


 Required
    Program title:         Programmable Calculator
    Path and file name :   e:\utils\calc\katcalc.exe

 Optional
    Parameters:
    Working directory:     e:\utils\calc

 Program type
    Γûá Presentation Manager
    ΓêÖ Other

In the subdirectory e:\utils\calc the following files should be placed:

 o KATCALC.EXE

 o KATCALC.HLP

 o K*.PGM

 KATCalc requires OS/2 Extended Edition version 1.2 or higher.