;


                    The Memory Utility MU3


                      M - Overview of MU3

                       C - MU3 Commands


                ---- Command Summary ----
                1 - Movement:     +  -  A  arrows
                2 - Value Entry:  N  T
                3 - Other:        H ^R ^C

:M
Command:  MU3 1.0

Syntax:
    MU3            <-- Invoke MU3 pointing to ZCPR3 Env Desc
or
    MU3 address    <-- Invoke MU3 pointing to address (hex)

Function:

    MU� provide� � screen-oriente� edito� whic� ma� b� use� �
t� examin� an� modif� memor� a� th� user'� discretion��  I� �
load� a� � transien� an� run� fro� th� TPA�� startin� a� �
100H�  MU� find� mos� o� it� applicatio� i� tha� i� doe� no� �
overla� th� ZCPR� CP�� s� th� use� ca� examin� th� operatin� �
syste� directl� wit� MU3.

Options:  None


Comments:

    MU� use� th� ZCPR� TCA� fo� support��  Wor� Sta� curso� �
motio� conventio� applie� an� th� user'� arro� key� ma�� b� �
activ� i� the� ar� specifie� i� th� TCA� entry.

    Al� numeri� inpu� argument� defaul� t� hexadecimal� �
suc� a� number� t� b� inpu� an� addresses��  Thi� ca� b� �
overridde� b�� prefixin� th� numbe� wit� � '#�� character�  �
Fo� instance� i� respons� t� th� � (selec� address� command� �
th� use� ma� typ� 7d� o� #200� t� indicat� memor�� locatio� �
7D0 hex.

    Al� command� ar� simpl� an� self-explanatory��  The� �
include:  C - Enter ZCPR3 Command Line
         N - Enter Hex Numbers         T - Enter Text
         A - Specify Address           +/- Next/Last Block
         H - Hex Calculator            Arrows - Movement
        ^R - Refresh Screen           ^C - Exit MU3

Selected Error Messages:  None

Examples of Use:

    MU3 F000
         - invoke MU3 and point to address 0F000H

:C
                      The Commands of MU3

    MU�� i� quit� simpl� t� us� an� recognize� onl� � fe� �
commands�  Thes� command� ar� presente� i� � men� t� th� MU� �
use� a� th� progra� i� running.

    Th� MU� displa� scree� i� formatte� a� indicate� below:

                       MU3 Memory Editor
                                            Value

    Hexadecimal Memory Dump            ASCII Dump

-- Movement --  -------------- Operation ---------------
    ^E          A Enter Address           + Next Block
     ^          H Hex Calculator          - Last Block
^S <-+-> ^D     N Enter Hex Numbers      ^R Replot Screen
     v          T Enter Text             ^C Exit MU3
    ^X          C Enter Command Line

    A� th� use� move� abou� o� th� screen� usin� eithe� th� �
Wor�  Sta� curso� movemen� conventio� o� hi� arro� keys� th� �
valu� i� th� uppe� righ� corne� changes� indicatin� bot� th� �
he�� valu� an� ASCI� characte� representatio� o� th� byt� �
bein� pointe� to��  Also�� � curso� move� i� th� Hexadecima� �
Memor�� Dum� region�� indicatin� wher� th� use� i� i� th� �
current 128-byte block.

    Onc� th� use� i� pointin� t� � desire� byte� h� ma� us� �
th� � o� � command� t� chang� memor� startin� a� th� byt� h� �
is pointing to.

:1
                    Movement Commands

    Th� curso� ma� b� move� abou� o� th� scree� vi� th� �
Wor� Sta� curso� movemen� convention�  I� th� arro� key� fo� �
th� user'� termina� ar� installe� vi� th� ZCPR�� TCAP�� the� �
they keys may also be used to move the cursor.

    A� an�� time�� th� use� ma� strik� th� lette� �� (cas� �
make� n� difference� t� selec� � differen� regio� o� memor� �
t� view��  MU� wil� displa� 12� byte� o� memor� startin� a� �
the address given by the user.

    Th� command� �� an� - mov� th� displa�� forwar� an� �
backward�� resp� fo� on� bloc� (12� bytes)�  Th� movemen� i� �
instantaneous�� an� th� curso� i� repositione� t� th� firs� �
byte in the new block.

:2
                   Value Entry Commands

    Th� � comman� i� use� t� ente� � grou� o� hexadecima� �
number� int� memor� startin� a� th� addres� bein� pointe� �
to�  Th� use� i� prompte� fo� input� an� h� ma� the� ente� � �
serie� o� hexadecima� values�� separate� b� spaces��  Entr� �
terminate� whe� th� use� strike� th� RETUR� key��  Cas� i� �
not significant.  Any number prefixed with '#' is decimal.

    Fo� example�� th� followin� i� � sampl� sequenc� o� �
values which may be entered:

         0 1f f3 ff 2c c3 0 2 3 4 #192 #255

    Th� Ԡ comman� i� use� t� ente� tex� int� memor� �
startin� a� th� curso� position��  Th� use� i� prompte� fo� �
input�� an� h� ma� the� ente� � strin� o� characters��  Al� �
character� inpu� ar� significant�  Entr� terminate� whe� th� �
user strikes the RETURN key.  Case is significant.


    If�� whil� i� th� middl� o� tex� entry� th� use� wishe� �
t� inser� � numeri� value�� th� escap� forma� <nn�� i� �
provided�� wher� 'nn� i� � hexadecima� valu� a� show� above�  �
Th� for� <#nn� i� als� provided�� wher� 'nn� i� thi� cas� i� �
� decima� value��  Th� for� '<<� insert� � singl� '<� �
character into memory.

    Fo� example�� th� followin� enter� th� sequenc� '<thi� �
i� � test>�� followe� b� carriag� retur� an� lin� fee� �
characters into memory starting at the cursor:

         <<this is a test><0d><#10>

'0d�� i� 0� he� an� '#10� i� 1� decima� o� 0�� hex��  Th� �
leading '<<' translates into one '<'.

:3
                      Other Commands

    Th� � comman� allow� th� use� t� ente� � comman� lin� �
fo� immediat� executio� b� th� ZCPR� Comman� Processor��  I� �
MU�� i� invoke� a� � shel� vi� th� SHSEԠ command�� thi� �
comman� provide� a� escap� mechanis� a� wel� a� � wa�� t� �
execut� � comman� lin� fro� withi� MU3��  Th� SHCTR̠ PO� �
command will terminate the current shell on the shell stack.

    Th� � comman� invoke� � hexadecima� calculator��  Th� �
use� i� aske� t� ente� tw� hexadecima� numbers�� an� thes� �
number� ar� adde� an� subtracted�� wit� th� result� bein� �
printe� immediately��  Again� decima� number� ma� b� entere� �
by prefixing them with '#'.

    Th� ^� comman� refreshe� th� scree� fo� th� user�  Thi� �
i� hand� i� th� scree� wa� garble� i� som� way�� suc� a� b� �
turning off the CRT.

    The ^C command causes MU3 to exit to ZCPR3.