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