!
!  UBAOPN.HLP -- on-line help file for the program UBAOPN
!
!  Programmer:  Philip Watson
!               The University of Texas at Austin
!               Computation Center
!               Austin, Texas 78712
!
1 Ubaopn
 UBAOPN is a program that reads and writes device registers on UNIBUS 0
 and UNIBUS 1, and is generally used by the systems staff to test newly-
 installed devices.  You should be careful not to disrupt UNIBUS devices
 with indiscriminate use of UBAOPN.  The program requires the privilege
 PFNMAP.

 To run, type:      $ RUN SYS$SYSTEM:UBAOPN
 It prompts with:   UBAOPN>
2 Commands
 UBAOPN prompts for its first command with    UBAOPN>
 After a register is opened, the prompt is    Unibus unit:address = value :

 where unit, address, and value are octal numbers.  You respond to the
 prompts with a line containing the following items, in order.

         [unit:address] [value] [control] [!comment]

 Each item is optional, except that a unit and address must be specified
 in the first command.  You can use spaces and tabs between the items,
 which are defined below.

 unit:address -- UNIBUS unit number, 0 or 1, and device register address,
                 760000 to 777776 (octal) for the register to read or write.
                 The address must be a word (even) address.

 value        -- a value, 0 to 177777 (octal), to write to the current
                 address

 control      -- a character indicating the next address to examine:
                 <missing> to step to next higher word, "." to reexamine
                 the current word, or "^" to back up to the previous word

 !comment     -- a comment beginning with "!"
2 Examples
 Here is an example session using UBAOPN:

   $ RUN SYS$SYSTEM:UBAOPN
   UBAOPN>0:760000                         ! Read address 760000 on UNIBUS 0
   Unibus 0:760000 = 000000 : <return>     ! Step to next word
   Unibus 0:760002 = 000000 : 400          ! Write 400 (octal) to 760002
   Unibus 0:760004 = 000000 : 1:767002     ! Read address 767002 on UNIBUS 1
   Unibus 1:767002 = 000000 : 200^         ! Write 200 (octal) and step back
   Unibus 1:767000 = 000400 : <control-z>  ! Exit

 This is how UBAOPN can be used as a foreign command:

   $ UBAOPN = "$SYS$SYSTEM:UBAOPN"
   $ UBAOPN  0:770000  004000     ! Write 004000 (octal) to 0:770000
