README.md



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