BLKEDT.LIT
FUNCTION:
To display and edit the contents of a particular block on a
specified device.
HINTS/RESTRICTIONS:
BLKEDT must be run from account [1,2] and will function for
any block on any mounted device on the system.
BLKEDT will display the block of information in a similar
format to DUMP BLOCK, but will wait when the screen is full
(one-half a block).
FORMAT:
.BLKEDT {device:}block-number
The device may be any device that the driver is resident for
and is currently on the system. Multiple digit drive numbers are
permitted.
Block number is the block you wish to display. The entry may
be in either hex or octal depending on the current SETting. A hex
block number must start with a numeric character. For example
block F43 must be entered as 0F43. If the block number entry does
not agree with the current SETting for hex or octal, the input
block number will be incorrect.
DEFAULTS:
If no device is specified, then BLKEDT will default to the
device you are currently logged into.
OPERATION:
1. Type BLKEDT followed by the device and block number you
wish to search for.
2. BLKEDT will display the block in a format similar to
DUMP BLOCK (see System Commands Reference Manual for
DUMP). The display will halt after 256 bytes are
displayed and wait your command.
3. BLKEDT will then display a word in reverse video with
the different translations of the word on the 22nd line
1
of the screen. By use of the arrow keys, or the control
characters (^H,^J,^K,^L) you can diplay different words.
4. You may display the other half the block by using
Control-T to page ahead and Control-R to page back.
Using the arrow key at the bottom of the displayed
screen will only go to the top of the screen and not to
the next page.
5. If you wish to display the long word, highlight the
first block of the long word, and type an <L>, the long
word will be displayed on the 24 line of the screen.
Type any key to continue.
6. To edit the data you have all the formats of display
available to enter the data, plus you may change only
the MSB (most significant byte) or the LSB (least
significant byte). All of the editing routines require
the first character to be a <#>. The second character
will determine how much data you will edit. An <L> will
edit a longword beginning with the highlighted word; a
<W> will edit the word that is highlighted; a <B> will
edit the byte that is highlighted; an <'> will allow
entry of one ASCII character to the byte that is
highlighted; and a <[> will designate the start of a
RAD50 triad to be packed. Byte editing is defaulted by
not entering any of the above symbols. Bytes, words,
and longwords may be entered in decimal, octal, or hex.
To enter the value in decimal follow the value with a
decimal point <.>; to enter in hex or octal you must
have the proper mode SET for your terminal.
7. You must enter the hex or octal number according to your
current setting or incorrect results will occur.
8. To flip between the MSB and LSB display hit the
space-bar.
9. The <DEL> or <RUBOUT> key will clear your entry and let
you start again. It will not erase just the last
character.
10. The entire ASCII character set cannot be packed into
RAD50. The only characters that will pack are 0-9, A-Z,
., $, ? (period, dollar sign, and question mark). Only
capital letters A-Z will pack.
11. In the ASCII input mode you can input any ASCII value
greater than a space (32 decimal or 40 octal) except a
DEL.
12. Remember that the appearance of the LSB and MSB are
reversed; therefore, use caution when entering ASCII
characters and byte values.
13. You may not enter a word, longword, or RAD50 triad when
the display is set for the MSB, BLKEDT will return :
<? word boundary error>.
2
14. To exit BLKEDT type an <F> and you will update the block
on the device and return to AMOSL. If you do not wish to
update, the block type a <Q>.
ERRORS:
A. ^specification error:
Your command line was of incorrect format. The ^
points to the location that BLKEDT does not understand.
B. ?Block number too large for this device.
The number you have entered is larger than the
number of blocks on the specified, or default device.
C. ?Block number specified is a negative octal number
The number you have entered equates to a negative
octal number. Check the block and try again.
D. ? Input format error
BLKEDT does not understand your command.
E. ? Word boundary error
You have tried to enter a word to the MSB. Change
to LSB and try again.
F. ? Longword boundary error
You have tried to enter a longword to the MSB.
Change to LSB and try again.
G. ? Operand size error
The entry is too large for the format you are
trying to enter.
H. ? Longword boundary violation
You have tried to enter a longword that will cross
over the boundary of the block and into another block.
I. All other error messages are from AMOSL operating system
CHARACTERISTICS:
You can use BLKEDT for any block on any mounted device
You must be logged into account [1,2] to run BLKEDT.
BLKEDT is both re-entrant and reusable.
3
BLKEDT is control C (^C) interruptable, if CTRLC is SET on
the user's terminal.
BLKEDT.LIT was written by:
Quaker State Oil Refining Corp.
Research Center
Oil City, PA 16301 - April 1984
4