


                                ZG 0178
                                -------

                FORMAT RT-11            DATE 4/29/83
                                    UPDATES: 5/24/84 - DOCUMENTS ADDED,
                                                       CDLIB.OBJ REMOVED


               SUBJECT:  RT-11(V4,V5)  CDPACK ROUTINES and RELATED TESTS
               --------

               DESCRIPTION:  A Library of the CDPACK routines for the DR11-W
               -----------   High Speed Interprocessor Communication Link.


                               CONTENTS
                               --------

        1. README.TXT   -       This file

        2. CDASGN.MAC   -       CDPACK MACRO-11 Source
        3. CDCMPL.MAC   -       CDPACK MACRO-11 Source
        4. CDDRV .MAC   -       CDPACK MACRO-11 Source
        5. CDERRM.MAC   -       CDPACK MACRO-11 Source
        6. CDERRN.MAC   -       CDPACK MACRO-11 Source
        7. CDERRT.MAC   -       CDPACK MACRO-11 Source
        8. CDMACL.MAC   -       CDPACK MACRO-11 Source
        9. CDMODE.MAC   -       CDPACK MACRO-11 Source
       10. CDPACK.MAC   -       CDPACK MACRO-11 Source
       11. CDPREF.MAC   -       CDPACK MACRO-11 Source
       12. CDRSX .MAC   -       CDPACK MACRO-11 Source
       13. CDRT  .MAC   -       CDPACK MACRO-11 Source
       14. CDSTAT.MAC   -       CDPACK MACRO-11 Source
       15. CDUINT.MAC   -       CDPACK MACRO-11 Source
       16. CDUTIL.MAC   -       CDPACK MACRO-11 Source
       17. CDWAIT.MAC   -       CDPACK MACRO-11 Source
       18. END   .MAC   -       CDPACK MACRO-11 Source

       19. CDPMAC.COM   -       A command file to create
                                CDPACK Object Library 

       20. RCVTST.FOR   -       Test: receive a Message Block or SIGNAL
       21. XMTTST.FOR   -       Test: transmit a Message Block or SIGNAL
       22. RCVLUP.FOR   -       Test: receive several Message Blocks
       23. XMTLUP.FOR   -       Test: transmit several Message Blocks
       24. ECHO.FOR     -       Test: loop-around xmt/rcv Msge Blocks
       25. DLPACK.TXT   -       Text library used in #22 - #24

       26. RCVTST.SAV   -       Test: Executable for #20
       27. XMTTST.SAV   -       Test: Executable for #21
       28. RCVLUP.SAV   -       Test: Executable for #22
       29. XMTLUP.SAV   -       Test: Executable for #23
       30. ECHO.SAV     -       Test: Executable for #24
                                                      Page 2


 
                Fermilab Documents (* - MEM+RNO in RUNOFF format)
       31. PN159.*      -       CDPACK - FORTRAN callable routines
                                for interprocessor communications
 
       32. PN174.*      -       Packet type code assignments









                References:   1. ZG-0177 (Vault tape) - RT11 CD Driver
                ----------                            
                              2. The documents (Manuals, Specs, Notes, etc.)
   o    RT-11 SYSTEM PROGRAMMERS MANUAL  (DIGITAL EQUIP. CORP.)
  **    RT-11 USERS GUIDE                (DIGITAL EQUIP. CORP.)
  **    RT-11 FORTRAN USERS GUIDE        (DIGITAL EQUIP. CORP.)
  **    RT-11 FORTRAN REFERENCE MANUAL   (DIGITAL EQUIP. CORP.)
                Fermilab Documents
        DS77        DR11-W Link transmission protocol
   o    DS78        RT DR11W driver design spec
   o    DS83        Four RTMULTI Connected Machine Applications
   o    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)
   o    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 CDPACK routines.
        The documents marked (o) are useful but not essential.
        Other documents are listed for reference only.
                                                      Page 3



                        A Brief Guide to Using the CDPACK routines.
                        - ----- ----- -- ----- --- ------ --------


        1. INSTALLATION.

        1.1 Install the RT-11 CD Driver as described in the guide provided
with the ZG0177 tape (on the RT11 CD Driver).

        1.2 Copy the library of CDPACK routines to your disk by issuing 
the following command from your terminal:
                COPY  MT:CDLIB.OBJ  DK:*.*

If you wish to create your own LIBRARY, refer to CDPMAC.COM (#19) for
an example.

        1.3 Compile your FORTRAN program
                FORTRAN  MYPROG

        1.4 Link your program using the CDPACK library
                LINK   MYPROG,CDLIB

        1.5 Run your program
                RUN   MYPROG

        2. IN YOUR PROGRAM ...

        Read PN159 which describes in detail how to use the CDPACK in
your program, and contains some examples. For more examples see (##21,22).

                                                                                                          