Start of README v1.1

MC101 calculator

MC101 was developed by McKay Software Services Ltd www.mckaysoftware.ie

This describes the purpose and components of MC101 and how to download, install, and use the MC101 program.

CONTENTS


1. OPERATION
2. FUNCTIONS
3. FEATURES
4. COMMANDS
5. COMMAND KEYS
6. DISPLAY
7. To run MC101
8. SAVEFILE
9. SHIPPING LIST
10. Change Log

1. OPERATION

A number or command is keyed on a line and ENTER is pressed. The number is preceded by an arithmetic operator + - * /. If the arithmetic operator is omitted, + is assumed. A negative number is entered by keying a minus sign after the number.

The result is applied to the answer. A visible subtotal is updated after each line is entered. The entered number lines are rolled up. In this way, the numbers are always available to view. Each line is given its own numeric label, which increments automatically. The user may change this to an alphanumeric label.

===>CONTENTS
2. FUNCTIONS

The functions provided are ... Arithmetic Percent Factorial Nth Power Nth Root Absolute Random + - * / % ! ** // AB RAND Arithmetic + - * / 12, + 5, -25, /123, *754 The arithmetic operator may be used in front of any other function, except AB. The number range is 20,5 for positive numbers and 19,5 for negative numbers - i.e. 15 (or 14) digits to the left of the decimal point and 5 to the right. Percent 10%, *25% A negative number is converted to positive prior to the operation.. Factorial 5! A negative number is converted to positive before the operation. Only the integer portion is used; any mantissa is ignored. The number range is 1 to 17. Nth Power **, **3, 5**, 4**5 If no base (number to the left of **) is given, the answer is assumed. If no exponent (number to the right of **) is given, 2 is assumed. Only the integer portion of the exponent is used; any mantissa is ignored. When multiplying by a power, key * **. A negative base is converted to positive prior to the operation. A negative exponent is converted to positive prior to the operation. Nth Root //, //3, 5//, 27//3 If no base (number to the left of //) is given, the answer is assumed. If no exponent (number to the right of //) is given, 2 is assumed. Only the integer portion of the exponent is used; any mantissa is ignored. When dividing by a root, key / //. A negative base is converted to positive prior to the operation. A negative exponent is converted to positive prior to the operation. Absolute ABsolute turns a negative answer into positive. Any arithmetic operator used in front of AB is ignored. Random RAND will generate a random number in the range 0>1. RAND on its own will generate a different random number on each call. RAND cam be used with any integer of up to 10 digits. A different number is returned each time RAND is used. RAND followed by an integer will generate the same random number each time it is called with that integer. ===>CONTENTS

3. FEATURES

The features provided are ... 15 memory locations User names for each memory location User specified colours for memory values User name for answer User specified colours for answer values Editing Line numbers Line labels 15 memory locations 15 distinct memory locations are avilable. These may be named and edited separately. A Memory location can be keyed anywhere a number can be used. The number stored in that location is retrieved first. User names for each memory location The user can specify names for the memory locations. The name must start with an alphabetic character. Subsequent characters may be alphabetic or numeric or _ # @ $ £ € Alphabetic characters can be upper or lower case. User specified colours for memory values The user can specify colours for the value in memory locations. Different colours can be used for positive and negative numbers. The colours available are GREEN, WHITE, RED, TURQUOISE, YELLOW, PINK and BLUE. User name for answer The user can specify a name for the answer location. The name must start with an alphabetic character. Subsequent characters may be alphabetic or numeric or _ # @ $ £ € Alphabetic characters can be upper or lower case. User specified colours for answer values The user can specify colours for the value in the answer location. Different colours can be used for positive and negative numbers. The colours available are GREEN, WHITE, RED, TURQUOISE, YELLOW, PINK and BLUE. Editing The values in the answer and memory lcoations can be edited as follows .... Number of decimals Currency symbol Thousands separator Decimal separator Line numbers Each line is given an incrementing number as it is used. The user can replace this with a label. The number starts at 1 and increments to 9999 Any numeric entries here are replaced by the line number. The line number can be used as a target in the UNDO, REDO and GOTO commands. Line labels Each line is given an incrementing number as it is used. The user can replace the line number with a label. The label must start with uppercase alphabetic, followed by uppercase characters or numbers. Note that the length of a label is 4 characters. The label can be used as a target in the UNDO, REDO and GOTO commands. ===>CONTENTS

4. COMMANDS

The commands provided are ... CA Clear Answer CM Clear Memory AM Answer to Memory MA Memory to Answer UNDO undo REDO redo GOTO goto line REPEAT repeat line CA Clear Answer CA will clear the answer to zeros. The most recent subtotal entry is also cleared to zeros. CM Clear Memory CM, on its own, will clear all memory locations to zeros. CM, followed by a memory location, will clear that memory location to zeros. AM Answer to Memory AM, followed by a memory location, will copy the answer to the named memory location. This replaces any value previously in that location. The Answer location retains the value. MA Memory to Answer MA, followed by a memory location, will copy the contents of the named memory location to the Answer location. This replaces any value previously in the Answer location. The specified memory location retains the value. UNDO undo UNDO will undo or reverse out an operation. UNDO on its own will reverse out the last operation. UNDO TO will undo all the operations back to and including the specified line number or line label. UNDO ALL will reverse out all operations. Only entries from the Edit window and line labels will remain. REDO redo REDO will reinstate the corresponding UNDO'd operation. REDO on its own will reinstate earliest UNDO operation. REDO TO will reinstate all the UNDO'd operations up to and including the specified line number or line label. REDO ALL will reinstate all UNDO'd operations. Note that REDO always uses current values. For example, if a memory value is changed between the UNDO and REDO of a statement using that memory value, the changed memory will be used. GOTO goto line GOTO will display the specific line. Either a line number or a line label may be used as the target. REPEAT repeat one or more lines REPEAT will repeat one or more lines. Either a line number or a line label may be used as the target. REPEAT 1 to 5 REPEAT 1 ===>CONTENTS

5. COMMAND KEYS

The following command keys are used ... F3 Exit F4 Prompt F5 Undo F6 Editing F7 Save F9 Repeat F10 Display Memory Locations F11 Goto top F12 Cancel F14 Display Command Keys F17 Redo F19 Restore F22 Display Legend F23 Bottom F3 Exit F3 will close the program. Setting are saved in the CFG file. A prompt is issued, asking if user wants to save log, memory and template values. F4 Prompt F4 allows the user to select library, file and member values from a displayed list. When restoring or saving log, memory and template values, the user can display a list of available libraries, files and members to select from. F5 Undo F5 will undo one operation. The last operation is reversed out. F6 Editing F6 will open the editing window. Answer and memory locations names and colours may be changed in this wndow. This is where editing is applied to the values in Answer and memory locations. F7 Save F7 allows the user to save log, memory or template values. Log, memory and template values may be saved to a disk file at any time. The user can determine the library, file and member to be used. F9 Repeat F9 allows the user to repeat the last entry. F9 will repeat the last entry. F10 Display Memory Locations F10 will display the values in the memory locations. F10 is a toggle, and is linked to F22 Display Legend. F11 Top F11 will display the first page of entries when a subsequent or last page of entries is currently displayed. Line labels may be changed, but not the entries. F12 Cancel F12 will return from the window to the main display. This will return the main ndisplay. No action is performed. F14 Display Command Keys F14 will display command keys in a new window. F14 displays the command keys with a fuller description. F17 Redo F17 will reinstate the most recent UNDO operation. The most recent UNDO operation will be reapplied. REDO always uses current values. For instance, if a value is changed between an UNDO and associated REDO, the value after the change is used. F19 Restore F19 allows the user to restore log, memory or template values that were previosly saved to a file. Log, memory and template values may be restored from a disk file at any time. The user can determine the library, file and member to be used. F22 Display Legend F22 will display the legend. i.e. the operators, commands etc. F22 is a toggle, and is linked to F10 Display Memory Locations. F23 Bottom F23 will display the last page of entries. Line labels may be changed, but not the entries. ===>CONTENTS

6. DISPLAY



MC101S1 MC101 ISERIES CALCULATOR SIMULATOR 2/24/10 PUB1 MCKAY SOFTWARE SERVICES LTD 13:43:27 JMCKAY www.rpglanguage.com www.mckaysoftware.ie AN 1,089.24354 + Add ** Power CA Clear Answer GOTO - Subtract // Root CM Clear Memory UNDO * Multiply AB Absolute AM Answer to Memory REDO / Divide RAND Random No. MA Memory to Answer REPEAT ! Factorial % Percentage 1 + 1.000000 1.000000 2 + 2.000000 3.000000 3 / 3.000000 1.000000 4 * 4.000000 4.000000 5 * 8.000000 32.000000 6 + 32.000000**2 1,056.000000 1,024.00000 7 + 1,056.000000//2 1,088.496150 32.49615 8 + RAND 1,089.243540 RANDOM .74739 9 Bottom F3 Exit F6 Edit F5 Undo F7 Save F9 Repeat F22 Legend F11 Top F14 Keys F17 Redo F19 Restore F23 Btm

MC101S3 MC101 ISERIES CALCULATOR SIMULATOR 2/24/10 PUB1 MCKAY SOFTWARE SERVICES LTD 14:00:28 JMCKAY www.rpglanguage.com www.mckaysoftware.ie Temporary L8 AirTicket 175.25 L9 Taxi 15.00 LA Meals 65.30 LB L4 LC L5 LD L6 LE L7 LF 2 am AirTicket 175.250000 3 CA 4 + 15.000000 15.000000 5 am Taxi 15.000000 6 CA 7 + 65.300000 65.300000 8 am Meals 65.300000 9 CA 10 Bottom F3 Exit F6 Edit F5 Undo F7 Save F9 Repeat F22 Legend F11 Top F14 Keys F17 Redo F19 Restore F23 Btm

MC101S3 MC101 ISERIES CALCULATOR SIMULATOR 11/06/09 MCKAY SOFTWARE SERVICES LTD 23:55:34 JMCKAY www.rpglanguage.com www.mckaysoftware.ie Temporary Expenses 255.55 Airticket 175.25 L9 Taxi 15.00 LA Meals 65.30 LB L4 LC L5 LD L6 LE L7 LF 10 Airticket 175.250000 11 taxi 175.250000 Invalid entry 12 Taxi 190.250000 13 Meals 255.550000 14 am Expenses 255.550000 15 CA 16 Bottom F3 Exit F6 Edit F5 Undo F7 Save F9 Repeat F22 Legend F11 Top F14 Keys F17 Redo F19 Restore F23 Btm

=+++++++++++++++++++++++++++++++++++++++++++++++= * DEC CUR DEC THOU COLOURS / * POS SYM SYM SYMB + - / * AN AN 5 . , WHT WHT / * L1 L1 5 . , WHT WHT / * L2 L2 5 . , WHT WHT / * L3 L3 5 . , WHT WHT / * L4 L4 5 . , WHT WHT / * L5 L5 5 . , WHT WHT / * L6 L6 5 . , WHT WHT / * L7 L7 5 . , WHT WHT / * L8 L8 5 . , WHT WHT / * L9 L9 5 . , WHT WHT / * LA LA 5 . , WHT WHT / * LB LB 5 . , WHT WHT / * LC LC 5 . , WHT WHT / * LD LD 5 . , WHT WHT / * LE LE 5 . , WHT WHT / * LF LF 5 . , WHT WHT / * / * ENTER to update / * F12 to cancel / * / =-----------------------------------------------=

=++++++++++++++++++++++++++++++++++++++++++++++++++++= * C O M M A N D K E Y S / * F14 Command Keys / * F3 Exit / * F4 Prompt / * F5 Undo F17 Redo / * F6 Editing / * F7 Save F19 Restore / * / * F9 Repeat / * F10 Display Memory F22 Display Legend / * F11 Goto Top F23 Goto Bottom / * F12 Cancel / * / =----------------------------------------------------=

===>CONTENTS
7. To run MC101

Command MC101C calls the program MC101. There are no parameters to the command nor the program. This is a stand-alone program.

The screen file is MC101FM. A configuration file MC101CFG holds configuration settings from one run to the next. A log file MC101LOG can be used to save data from a run. This can then be restored in a future run. Similarly, the edit setting - colours, decimal positions, currency symbol, decimal and thosuands separator, can be saved and restored in MC101TMLT. Finally, data in the memory locations can be saved and restored in MC101MRY. Activation group is *CALLER. The objects can be stored in a library of your own choice.

===>CONTENTS
8. SAVEFILE

The objects are provided in a savef MC101SAVF.  To restore the savef, first create a savef on the AS400.

Use FTP with binary to upload the file to the savf you created. You may then move the contents to a library or libraries of your choice.

===>CONTENTS
9. SHIPPING LIST
The following objects are shipped in the savefile MC101SAVF ...

MC101C	CMD	This is the command which calls the program.
MC101CL	CL program	Calculator emulation program - creates userspaces, CFG file.
MAKESPACE	CMD	Command to create userspace, wraps api QUSCRTUS.
MC101	RPGLE program	The calculator emulation program.
MC101FM	Screen file	Screen layouts
MC101SRC	Source file	This contains the source for the commands MC101C and MAKESPACE and CLP MC101CL.

===>CONTENTS


10. Change Log V1.0

Initial release of MC101
===>CONTENTS