Nexus Examples Overview

Before running these examples you must build and install Nexus 4.0 at your site. See the Nexus home page.

These examples were designed as a small tutorial for Nexus 4.0. As such, they are rich with documentation. However, they are not intended as a replacement for the Nexus documentation. They assume a basic understanding of Nexus terminology.

This directory contains sub-directories, each with an example program demonstrating some set of Nexus features. The first four examples were designed to be examined in order, from the most fundamental operation in Nexus and proceeding with increasing complexity.

• SingleRsr

  An introduction to Nexus. SingleRsr presents the minimum amount of code to send a single message. It introduces fundamental Nexus concepts as well as the set of functions that must appear in all Nexus programs.

• RsrWithReply

  A small addition to the SingleRsr. Here we show how to implement a monitor that allows us to wait for a reply to a message that we send.

• Ring

  This is the traditional ring example where a master and a set of slaves are configured in a ring and a single message is passed around that ring. Here we show how to implement a barrier by generalizing the monitor in RsrWithReply. It also demonstrates how to configure a more complex communication topology.

• ClientServerTalk

  This demonstrates Nexus attachment which can be used to implement a client/server application. This particular example is a curses-based version of the Unix "talk" program.

Each sub-directory contains a README.html file, a Makefile, and the source code. Follow the directions in each README.html that explain how to modify the Makefile, make the example, and run the example.

Credits

These examples were written by

Robert Bach
John Bresnahan
Nick Karonis
Doug Sale

High-Performance Computing Laboratory
Department of Computer Science
Northern Illinois University
DeKalb, IL

February 1997.

We also thank Ian Foster, Steve Tuecke, and George Thiruvathukal of the Mathematics and Computer Science Division at Argonne National Laboratory for their suggestions and help in preparing these examples.