PVM-ATM 3.3.2.0 --------------- PVM-ATM is an implementation to transparently run PVM user programs over ATM networks and fully utilize the high bandwidth of ATM networks. The current version required Fore Systems ATM cards for Sun workstations and is limited to a Fore Systems local ATM network. Key Features: + PVM 3.3.2 message passing library compatible + Message passing using ATM AAL3/4 and AAL5 directly instead of TCP and UDP + Implemented on Fore Systems' ATM API instead of socket programming + Employing the multicasting capability for PVM Daemon processes + Improved communication performance A set of files are used to allow runing PVM 3.3.2 over Fore Systems' ATM API. This approach leaves original PVM 3.3.2 files un-touched. Users can easily restore the original PVM 3.3.2 by re-execute the make files. Prepare PVM-ATM --------------- Make sure the PVM 3.3.2 was properly installed in your ~/pvm3 directory. For the detailed installation information of PVM 3.3.2, please refer to Readme file in ~/pvm3 directory. Copy pvm-atm3.3.2.0.tar.Z file to ~/pvm3 directory. Uncompress and unpack pvm-atm3.3.2.0.tar.Z file using the following commands: uncompress pvm-atm3.3.2.0.tar.Z tar xvf pvm-atm3.3.2.0.tar The tar command will unpack the pvm-atm3.3.2.0.tar and put related files into proper directories. The files in pvm-atm.3.3.2.0.tar will not replace existing files in your PVM directory. Instead, PVM-ATM files will be put in existing directories with different file names or in new directories. The following files and directories will be generated from the tar file. ~/pvm3/Announce.pvm-atm ~/pvm3/README.pvm-atm ~/pvm3/console/Makefile.atm ~/pvm3/console/consatm.c ~/pvm3/examples/Makefile.atm ~/pvm3/examples/aimkatm ~/pvm3/lib/aimkatm ~/pvm3/pvmgs/Makefile.atm ~/pvm3/src/ATM4/ATM4 ~/pvm3/src/ATM4/Makefile ~/pvm3/src/ATM5/ATM5 ~/pvm3/src/ATM5/Makefile ~/pvm3/src/Makefile.atm ~/pvm3/src/ddproatm.c ~/pvm3/src/ddproatm.h ~/pvm3/src/lpvmatm.c ~/pvm3/src/pvmdatm.c ~/pvm3/src/startupatm.c ~/pvm3/src/tdproatm.c ~/pvm3/src/waitcatm.c Switch from PVM to PVM-ATM -------------------------- Two parameters in each Makefile.atm file in directories pvm3/src pvm3/console pvm3/pvmgs need to be changed for the header files and libraries of the Fore's ATM API. FORE_INC = [the directory where Fore's ATM API include files located] FORE_LIB = [the directory where Fore's ATM API libraries located] for example: FORE_INC = /usr/local/fore/include FORE_LIB = /usr/local/fore/lib Go to "pvm3/src/ATM4" or "pvm3/src/ATM5" directory and change the "PVM_ARCH" on Makefile and type "make" to compile and link all files needed to run PVM using ATM (with AAL3/4 or AAL5). Using ATM API ------------- + Start PVM by PVM console: pvm ATM_device_name -n or pvm ATM_device_name -n [-d] [hostfile] where is the hostname for the ATM interface. example: pvm fa0 -ni2-atm + Start PVM by PVM Daemon: pvmd ATM_device_name -n [-d] [hostfile] example: pvmd fa0 -ni2-atm hostfile After switching from PVM 3.3.2 to PVM-ATM, the user program needs to be re-compiled to incorporate the changes. There is an example Makefile.atm in ~/pvm3/examples directory for your reference. The Makefile.atm file was modified from original Makefile.aimk file with the following two changes: FORE_LIB = [the directory where Fore's ATM API libraries located] and LIBS = $(PVMLIB) $(ARCHLIB) -L$(FORE_LIB) -latm -lm To build any of the examples you can type: aimkatm [example_name] Restoring PVM 3.3.2 ----------------- Simply type "make" in ~/pvm3 directory. Contact ------- Please direct any email (questions, bugs, bug fixes, etc.) to pvm-atm@cs.umn.edu