


                                ZG 0177
                                -------

                FORMAT RT-11            DATE 4/28/83
                                    UPDATES: 5/17/84 - CD DRIVER W/SET OPTION.


               SUBJECT:  RT-11 (V4 and V5)  CD DRIVER and RELATED TESTS
               --------

               DESCRIPTION:  A Device Handler for the DR11-W
               -----------   High Speed Interprocessor Communication Link.


                               CONTENTS
                               --------

        This ZG tape contains the following files:

        1. README.TXT   -       This file

        2. CDRT11.MAC   -       CD Driver Source
                                    Default SET options (Vector and CSR):
                                        (VECTR0=300, CSR0=172414)  

        3. CDRTRD.MAC   -       Test: single read (with display of data read)
        4. CDRTWR.MAC   -       Test: single write (with display of data written)
        5. CDRTAT.MAC   -       Test: multiple read/write (loop-around test)
        6. CDRTBT.MAC   -       Test: multiple write/read (loop-around test)
        7. CDRTSF.MAC   -       Test: open PTC .SPFUN

        8. CDRTRD.OBJ   -       Test: Object for #3
        9. CDRTWR.OBJ   -       Test: Object for #4
       10. CDRTAT.OBJ   -       Test: Object for #5
       11. CDRTBT.OBJ   -       Test: Object for #6
       12. CDRTSF.OBJ   -       Test: Object for #7

       13. CDRTRD.SAV   -       Test: Executable for #3
       14. CDRTWR.SAV   -       Test: Executable for #4
       15. CDRTAT.SAV   -       Test: Executable for #5
       16. CDRTBT.SAV   -       Test: Executable for #6
       17. CDRTSF.SAV   -       Test: Executable for #7

       18. CDRT11.COM   -       Command file to build and install
                                the CD Driver (CD.SYS)
                Fermilab Documents (* - MEM+RNO in RUNOFF format)
       19. DS77.*        DR11-W Link transmission protocol
       20. DS78.*        RT DR11W driver design spec
       21. DS83.*        Four RTMULTI Connected Machine Applications
       22. IN90.*        RT11 CD Driver: Signal Spec
       23. PN159.*       CDPACK - FORTRAN callable routines
                          for interprocessor communications
       24. PN160.*       High Speed Interprocessor Data links using the DR11-W
                          (DECUS general paper on connected machines)
       25. PN161.*       Using the DR11-W for interprocessor communication 
                                                      Page 2


                          in RT-11 (DECUS RT Driver paper)
       26. PN162.*       An RSX device driver inplementing Network protocols
                          on the DR11-W (DECUS RSX Driver paper)
       27. PN174.*       Packet type code assignments






                References
                ----------                            

        1. ZG-0178 (Vault tape) - CDPACK routines

        2. The documents (Manuals, Specs, Notes, etc.)
   *    RT-11 SYSTEM PROGRAMMERS MANUAL  (DIGITAL EQUIP. CORP.)
   *    RT-11 USERS GUIDE                (DIGITAL EQUIP. CORP.)
                Fermilab Documents
    $   DS77        DR11-W Link transmission protocol
   *$   DS78        RT DR11W driver design spec
   *$   DS83        Four RTMULTI Connected Machine Applications
   *$   IN90        RT11 CD Driver: Signal Spec
   *$   PN159       CDPACK - FORTRAN callable routines
                     for interprocessor communications
    $   PN160       High Speed Interprocessor Data links using the DR11-W
                     (DECUS general paper on connected machines)
   *$   PN161       Using the DR11-W for interprocessor communication
                     in RT-11 (DECUS RT Driver paper)
    $   PN162       An RSX device driver inplementing Network protocols on
                    the DR11-W (DECUS RSX Driver paper)
        PN166       RSX Communications Driver
        PN173       Guide to RSX Communications software
   *$   PN174       Packet type code assignments
        PN179       VMS Communications driver

        The documents marked (*) are essential for understanding and
          correct use of the CD Driver.
        The documents marked ($) are included in this ZG tape.
                                                      Page 3



                        A Brief Guide to Using a CD Driver.
                        - ----- ----- -- ----- - -- ------


        1. INSTALLATION.

        1.1 Build the CD Driver.
                (a) Assign the logical name "DK:" to the device
                     containing files CDRT11.MAC and CDRT11.COM 
                     (your kit device).
                     For example, if your kit device is "DX:", then
                     type ASSIGN DX: DK: on your keyboard.
                (b) Execute the Driver build command procedure by typing
                     @CDRT11
                     Make sure you don't have a file CDPREF.MAC on your
                     system disk (SY:), since this file is created and
                     then deleted by the Driver build command procedure
                     (CDRT11.COM)
 
        1.2 Verify and set, if necessary, the DR11-W VECTOR/CSR pair 
             in the CD Driver.
             The CD Driver is built with the following default set-up
                VECTOR=300, CSR=172414
             If your PDP-11 installation has different DR11-W VECTOR/CSR 
             set-up, for example, VECTOR=340, CSR=172434,
             type the following commands:
                SET CD VECTR0=340
                SET CD CSR0=172434


        1.3 Execute the following RT-11 Monitor commands to make sure
             the right device handler is installed:
                REMOVE  CD
                INSTALL CD
                SHOW DEVICES
             The last command will print out a list of device drivers and
             their installation status. If this list does not show the
             CD Driver as "installed", then REMOVE one of the installed
             drivers you don't need and repeat step 1.3


        2. IF YOU use the CDPACK routines you can use the guide provided
            with the ZG0178 tape and you can skip the rest of this guide.


        3. LOAD

        The CD Driver can be loaded either with a RT-11 Keyboard Monitor
        command (LOAD CD) or via a system call in your program (.FETCH).


        4. IN YOUR PROGRAM ...

        4.1 Open a channel using the .LOOKUP system call.       
                                                      Page 4



        4.2 Make sure you have enough queue elements available (minimum 3
             is advised). Use the .QSET system call to allocate additional
             queue elements.

        4.3 Open a READ session (make sure you do not use conflicting
             PTC numbers - see DS78 and PN174 for details.

        4.4 Now you can issue your .READx, .WRITx or .SPFUN <signal> system 
             calls to the CD Driver (use .READW or .WRITW with caution - 
             your program could hang) - see DS78 for details.

        4.5 End your program with a .HRESET system call to disable the 
             DR11-W interrupts.

        4.6 For examples of using .FETCH, .LOOKUP, .READW, .WRITW, .SPFUN
             and .HRESET system calls refer to test listings (files ##3-7).

                                                                                                                                                         