ZPOKE.V2 V01 RP AUTOMATION INC. 12JAN89

DESCRIPTION

The programs in this file allow Assembly Language routines to

be written using the MACRO-11 language. The features in this

file include:

Initialize and enter an array

Display data in an array

Update data in an array

Get data from user memory into an array

Put data from an array into memory

Save data on a diskette

Restore data from a diskette

PREPARATION

Load the file ZPOKE.V2 into memory.

PROGRAM EXECUTION

When the ZPOKE program is executed, a menu will be displayed

which will ask what is to be done (see DESCRIPTION section

above for possibilities). The program can be EXIT'd at this

point also. If an illegal response is given, then the menu

will get re-displayed.

Z.INIT

This routine gets CALL'd if the "initialize" option is chosen

as the menu selection. The starting address of the routine

is asked, and then the data for the routine is entered after

that. This continues until all data has been entered.

The outcome of this routine is that an array will be created

which contains the data that is entered. This data array can

now be used with the other options.

Z.DISP

This option can be used to display the data array. The data

will be displayed in octal. The address for each data word

will also be displayed. Also, the data will be DIS-ASSEMBLED

and the resulting MACRO-11 code will also be displayed.

After each page of data is displayed, there will be a pause

and an opportunity to ABORT the display.

Z.UPD

This routine gets called for updating the array data. There

are three ways that this data can be updated: insert, change,

or delete data. Before asking this question about which type

of update is desired, the array data gets displayed (see the

Z.DISP routine). If this question is answered incorrectly,

then it it asked again. There is also a way to QUIT here.

Z.INSERT

This routine gets CALL'd from the Z.UPD routine. A question

is asked about where the data is to be INSERT'd. If this is

entered correctly, then data is entered until it has all been

done.

Z.CHANGE

This routine gets CALL'd from the Z.UPD routine. A question

is asked about where the data is to be CHANGE'd. The current

data then gets displayed and the new data is entered. There

is also a verification for making this change. The change is

then made to the array.

Z.DELETE

This routine gets CALL'd from the Z.UPD routine. A question

is asked about where the data is to be DELETE'd. Then, there

is another question about how many words of data are to get

deleted. The program then updates the array to be correct.

Z.GET

This routine gets CALL'd if the option is chosen for getting

data from user memory into the data array. The beginning and

ending addresses must be entered for where the data is to be

copied from. The program then copies the data into the data

array.

Z.PUT

This routine gets CALL'd if the option is chosen for putting

data into user memory from the data array. A verification is

done for this option because the area that is being copied to

may not be available for user data. If okay, then the data

is copied into memory.

Z.SAVE

This routine gets CALL'd if the option is chosen for saving

the data on a floppy diskette. The filename is entered when

this routine starts. The data will get stored on the diskette

as this specified filename.

Z.RESTORE

This routine gets CALL'd if the option is chosen to restore

the data from a file on the diskette to the data array. The

filename is entered when this routine starts. The data will

get loaded from the diskette and stored in memory as the data

array.

NOTES

All addresses and data that are entered are in OCTAL format.

When using the Z.INIT, Z.GET, or Z.RESTORE options, the data

in the current array will be lost.

MESSAGES

*** ILLEGAL SELECTION ***

This message will get displayed if a wrong number is entered

for a menu selection.

*** ILLEGAL RESPONSE ***

This message will get displayed if wrong data is entered for

a PROMPT entry.

*** ILLEGAL ADDRESSES ***

This message will get displayed if the starting address that

is entered is greater than the ending address (used in Z.GET

routine).

*** Floppy error nn ***

If a floppy error occurs during the program, then this message

will get displayed, where 'nn' is a number which corresponds to

the internal floppy disk drive error code. The codes are:

2 = File already exists (creating new file with same name)

3 = File does not exist (opening file for reading)

4 = Communications error between VAL & floppy

5 = Disk full (writing to disk)

6 = Communications error between VAL & floppy

7 = Communications error between VAL & floppy

10 = Communications error between VAL & floppy

11 = Communications error between VAL & floppy

12 = Floppy not ready

13 = Floppy read error (diskette may be bad)

14 = Communications error between VAL & floppy

41 = No STX received during block transfer

42 = Incorrect checksum received during block transfer

43 = Incorrect response to closing file