                                                            BLKDSP.LIT


          FUNCTION:


               To display the contents of a particular block on a specified
          device.


          HINTS/RESTRICTIONS:


               BLKDSP  may  be  run from any account on the system and will
          function for any device on the system.


               BLKDSP 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:


               .BLKDSP {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 BLKDSP will default to the
          device you are currently logged into.


          OPERATION:

               1.  Type BLKDSP followed by the device and block number  you
                   wish to search for.

               2.  BLKDSP  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.  BLKDSP 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 longword, highlight the first
                   block  of  the  longword,  and type an <L>, the longword
                   will be displayed on the 24 line of the screen. Type any
                   key to continue.

               6.  To exit BLKDSP type a <Q> and you will return to AMOSL.

          ERRORS:

               A.  ^specification error:

                        Your command line was of incorrect  format.  The  ^
                   points to the location that BLKDSP 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.  All other error messages are from AMOSL operating system



          CHARACTERISTICS:


               You can use BLKDSP for any block on any mounted device


               BLKDSP is both re-entrant and reusable.


               BLKDSP  is  control C (^C) interruptable, if CTRLC is SET on
          the user's terminal.


                                        BLKDSP.LIT was written by:
                                        Quaker State Oil Refining Corp.
                                        Research Center
                                        Oil City, PA  16301 - April 1984







                                     2

.
