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 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).