\begindata{text,539404080} \textdsversion{12} \template{default} \define{global } \chapter{1 Using AMS User Interfaces from Non-Unix Clients} The Andrew Message System is designed so that users can access it from a wide variety of machines and interfaces. To achieve this goal, the functions involved in message reading and sending are divided into two parts: the user program (or AMS client), and a database access program (or message server). This seperation of functions makes it possible for AMS user programs to run on one machine while the message server runs on another machine. It also makes it possible for AMS user programs to run on non-unix machines such as the IBM-PC. When the AMS client is run seperately from the message server, the client communicates with the message server using SNAP: the Simple Network Access Protocol. Therefore, the snap libraries must be available to both the AMS client and the message server. AMS Clients that use SNAP are called snapified clients. When a snapified AMS client is run on a unix machine, the messageserver may run on the same machine, or it may run on a different machine. When a snapified AMS client is run from a non-unix machine the server must run on a different machine from the client. The AMS client (user program) runs on the non-unix machine. In turn, the AMS client communicates with the message server, which runs on a unix machine. If your site is an AFS cell, the machine that runs the message server is an AFS client; otherwise, the machine may be either mainframe unix computer, or a distributed computing client machine. Because the client is seperate from the server, a daemon, known as Guardian, is used to connect the client with the server. When a user starts a snapified client, the client initializes the CUI library on the local machine, and then attempts to establish a connection with a server. When this happens, the CUI library contacts the guardian daemon on the host where the message server is running. Guardian verifies that the user is allowed to access the messages database (in an AFS cell guardian attempts to authenticate the user) and connects the client to the server. Guardian is a multi-purpose client/server daemon; while its primary use is to connect AMS clients with AMS servers, it can be used to connect other types of clients with other types of servers. Several of these servers are included in the Andrew distribution. \section{1.1 Clients That Use Guardian} Snapified AMS clients are the primary users of guardian. There are three AMS user interfaces available from the Andrew software distribution: \typewriter{CUI}, the Common User Interface;\typewriter{ VUI}, the Visual User Interface; and\typewriter{ messages}, the ATK user interface. Each of these clients can be built either as a non-snapified client , i.e. a client that has the messageserver built in, or as a snapified client. Both types of clients are built from the same sources, but the snapified clients can only be built if the snap environment is defined in the andrew environment include file \typewriter{andyenv.h}. \indent{ }In addition to the AMS clients, two non-AMS client programs are included in this distribution. Because these clients are not AMS clients, they do not depend on the snap environment being defined for your system. \indent{\typewriter{loadav} - This client asks a server (loadserv) for a load and usage report for each machine in a pool of monitored machines. Users can use this client to determine which machine in the monitored pool is the least loaded. \typewriter{pcclient} - This client is used to test the pcserver software from a unix machine. } \section{1.2 Available Servers} Every client program that uses guardian must have a cooresponding server. The following servers are available with this distribution: \indent{\typewriter{messageserver} - This server is the database access program for AMS clients. \typewriter{loadserv} - This is the load average server that communicates with the loadav client. Loadserv monitors the load on a pool of host machines and reports its results when queried by loadav. \typewriter{pcserver} - This is the server for pcclient. The pcserver allows IBM-PC users to access files on the host system from the msdos environment. Directories on the host system are represented as drives on the PC; files in the directory can be manipulated as though they were located on a PC disk. \typewriter{bioya} - This is a test server that allows programmers to test and debug guardian. } \begindata{bp,537558784} \enddata{bp,537558784} \view{bpv,537558784,1449,0,0} Copyright 1992 Carnegie Mellon University and IBM. All rights reserved. \smaller{\smaller{$Disclaimer: Permission to use, copy, modify, and distribute this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice, this permission notice, and the following disclaimer appear in supporting documentation, and that the names of IBM, Carnegie Mellon University, and other copyright holders, not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. IBM, CARNEGIE MELLON UNIVERSITY, AND THE OTHER COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL IBM, CARNEGIE MELLON UNIVERSITY, OR ANY OTHER COPYRIGHT HOLDER BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. $ }}\enddata{text,539404080}