                                                            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

.
