METHOD AND SYSTEM FOR IMPLEMENTING REMOTE PROCEDURE CALLS IN A DISTRIBUTED COMPUTER SYSTEM

Abstract: A system and a method for implementing remote procedure calls in a distributed computer system (Figure 2) provide a base object class (Figures 1(1) and 1(2)) from which all distributed objects can be derived. A program extracting all classes derived from the base class provides an inheritance tree (Figure 3(a)) to allow down casting from a root class to a base class and to allow passing high level data structure between participants of a remote procedure call. An Unix script provides stub routines (Figures 7a and 7b) for implementing client-server model communicating processes.

Description: Method and System for Implementing Remote Procedure Calls in a Distributed Computer System Background of the Invention 1. Field of the Invention The present invention relates to distributed computer systems, and in particular, relates to the use of remote procedure call mechanisms in distributed computer systems. 2. Description of the Related Art In a distributed computer system, efficiency can be enhanced by sharing of resources (e.g. a file system) among numerous computers in the system. In addition, multiple computers can be used cooperatively in such a system to perform a common task. A number of communication paradigms have been developed to structure a network of computers to allow these computers to work cooperatively or to share resources. Among these paradigms is the "client-server" model. In the client- server model, one or more computers (the "servers") are assigned to provide services which other computers (the "clients") in the distributed computer system may request, either by passing messages to the servers or by invoking remote procedure calls. In the client-server paradigm, the client initiates a service request, and the server responds to such service request. A remote procedure call is a mechanism by which a program executing in a process space of one computer causes a procedure to be executed in a process space of another computer ("remote computer") . One implementation of the client-server paradigm has a client process invoke a remote procedure call to activate the requested service in a server process. A convenient implementation of the server process is a daemon process. A daemon process is a computer process which receives messages from other processes, and which, once started, is resident in the computer until a "kill" message is received from another process, a timer times out, or when the all expected messages are received. Such a daemon process is often used to manage a shared resource. For example, a daemon process for a print queue receives messages from processes which require the use of one or more printers associated with the print queue. To effectuate a print operation, a requesting process sends a print request to the daemon process which, if appropriate, would set up and schedule the necessary print processes to satisfy the print request. The daemon process provides efficiency, since tasks requiring printer-specific information are assigned to the daemon process and off-loaded from the requesting processes. A daemon process is said to be "sleeping" while waiting for a message from a requesting process, and is said to be "awaken" when performing its assigned task. Modern software are designed to exploit the advantages of modularization and data abstraction. Modularization allows a complex system to be partitioned at defined functional interfaces into interrelated subsystems. Each subsystem's implementation complexity are thus shielded from ("transparent to") other subsystems, and can therefore be developed and modified to a large extent independently from other subsystems. Data abstraction simplifies the task of programming by the use of high level data structures, which are logical or conceptual representation of the objects the data represent. Thus, data abstraction allows the programmer to manage data at a conceptual level, rather than managing data as a collection of primitive data types. Ideally, suitable modularization should allow an application programmer to invoke services of the operating system, e.g. to request status of a print job, without knowledge of the intricacies as to how the service is procured or where the service provider is located. In addition, high level data structures support should be provided to allow an application program to interface with another program without dismantling the application program's high level data structure to lower level primitives. Contrary to the goals of data abstraction and modularization, even though distributed computer systems have been used widely, remote procedure calls are implemented in language independent frameworks. Consequently, only relatively low level data structures can be passed between the computer processes involved in the remote procedure call, thereby requiring the application programmer to treat a distributed object specially. Such requirement defeats modularization. Further, because a suitable mechanism for communicating high level data structures is unavailable, the data structure of an application program is often dismantled explicitly in the application program code to create the low level data structure necessary for communicating data across machine boundaries. The portability and reliability of such application programs are affected. Thus, a mechanism of a high level of abstraction is desired to insulate application programs from having to set up for remote procedure calls. For example, remote procedure calls should be made transparent to the application programmer. That is, the mechanism should allow an application program to be written without knowledge or requirement that certain data structures of the application program are to be implemented on or be dependent upon resources controlled by a remote machine. Summary of the Invention In accordance with the present invention, a remote procedure call structure and method supporting high level data structures are provided by the use of a common data structure or class ("base" class) . By using the shared data structure to derive a distributed or shared object, a preprocessor can be built to automatically generate both client and server stub routines for a remote procedure call. An application program calling the server routines can pass to the server routine high level data in the same manner as passing the same data structure to a local routine. In one embodiment of the present invention, the server is created as a daemon process at system initialization time. The server creates a remote procedure call server object ("RpcServer") which can accommodate one or more remote procedure call client objects ("RpcClients") . An RpcClient created in the client provides a communication channel between the RpcServer on the server and the client. In addition, an RpcClient is also created on the server to provide asynchronous communication between the server and the client. When an RpcClient object is created in the client, a "manifest" is sent to the RpcServer, which responds by sending its own manifest to the RpcClient. A manifest contains class meta-information of each class in the corresponding server or client. Such class meta- information includes, for each class: (i) a "type code" identifying the class, (ii) the name of class, (iii) the number of base classes, (iv) the names of all the base classes, if any, from which the class is derived from. In addition, for each shared object, the manifest also provides: (i) the type code of the shared object, and (ii) an index into a list of shared objects in the manifest sender's environment, such list containing, for each shared object, a pointer to the shared object. A distributed or shared object is implemented by the combination of a master object ("master") implemented in the server and one or more slave object ("slave") implemented in the client. Both the master and the slave are derived from the same common base class. To maintain correspondence between the master and each of its slaves, since the master and its slaves reside in different memory spaces, the master is provided a key to allow a remote procedure call to obtain a pointer to the slave in the slave's memory space, and each slave is provided a key to the master in the master's memory space. Thus, a remote procedure call can operate upon the remote object passing only a key to the remote object. The present invention preserves local procedure call semantics by requiring the slave wait on the return of the remote procedure call. Local procedure call semantics are also preserved by an error handling mechanism which (i) traps exceptions in the server's memory space, (ii) passes the exception back to the client, and (iii) the client in turn passes the exception back to the appropriate level of software for handling. In the application program, the remote exception appears no different from an exception generated by a procedure executed locally. In one embodiment, RpcClients are also created in the server to allow the server to communicate with a master object's slaves. In that embodiment, message daemons for broadcasting messages to the slaves are created by the server. Each slave provides to the master a key which can be presented to the client through the server's RpcClient for translation into a pointer to the slave. This pointer to the slave can be used to invoke a method for the slave to receive message from the message daemon. Further, in accordance with the present invention, an automatic program generates both client and server stub routines for invoking a method in a distributed object. Because the present invention provides support for distributed object in the context of a relatively high level data structure, such as a C++ class, and preserves local call semantics, distributed objects can be implemented in a manner transparent to the application programmer, thereby enhancing robustness and maintainability of the distributed objects. The present application simplifies application programs which are used to control a distributed computer system. The present invention will be better understood upon consideration of the detailed description below and the accompanying drawings. Brief Description of the Drawings Figure 1 shows the declarations of the classes SharedThang, SharedThangld, and Remoteld in one embodiment of the present invention. Figure 2 is a block diagram showing the process spaces of a server process and a client process in one embodiment of the present invention. Figure 3a is a block diagram showing the steps involved in creating an inheritance tree using a macro 6IPTS_DECLARE and a program GenType. Figure 3b is a listing of a script file chomp.cpp which extracts the magic symbols a program GenType uses to provide an inheritance tree in accordance with the present invention. Figure 4a is a block diagram illustrating a program which implements a daemon process Sectd. Figure 4b is a listing of the program segment Sectd.C, which is executed in server process Sectd of the present embodiment. Figure 4c is a listing of a routine SectdProg_l, which is called by RPC mechanism 204 to invoke a procedure in Sectd. Figure 5 is a block diagram illustrating the creation of an object of the class RpcServer, which is used to provide communication between the present embodiment's Sectd process and its clients. Figures 6a and Figure 6b are respectively a block diagram of the program code which implements an object of the class SectClientController, and a listing of the program code. - 1 - Figures 7a and 7b are respectively the block diagrams stub routines SectController: :startTester and rStartTester generated by the oz script for the master and slave objects, which implements in SectClientController and Sectd the distributed class SectController. Figure 8 is the source code in file SectController.C for the actual implementation of the class SectController in Sectd. Figures 9a and 9b are respectively the stub routine program segments SectController: rstartTester and rstartTester generated by the oz script upon the class StartTester, as illustrated in block diagrams of Figures 7a and 7b. Figure 10 is a block diagram illustrating a script file oz for generating stub routines for client and server processes, in accordance with the present invention. Figure 11 is an example of a specification file for input into the oz script of Figure 10. Appendix C is a listing of the program GenType. Appendix D is a listing of script file oz. Detailed Description of the Preferred Embodiments In this detailed description, although the present invention can be implemented in any distributed computer systems using any programming language, an embodiment of the present invention using the programming language "C++" is described. The reader is referred to An Annotated C++ Refernence Manual by Ellis and Stroustrup, published by Addison and Wesley, (1990) , hereby incorporated by reference in its entirety, for an explanation of the C++ programming language. In this embodiment also, a well- known text processing program "awk," which runs in the UNIX operating system, is used to generate program segments. The use of awk and other similar text processing programs are well-known to those skilled in the art. A description of awk can be found in Section 1 of SunOS Reference Manual , Release 4.1, (1990) available from Sun Microsystems, Moutain View, CA. SunOS Reference Manual is also hereby incorporated by reference in its entirety. In the following description and the accompanying drawings, names under the C++ programming language, which are involved in the names of overloaded functions and operators, are used interchangeably with their equivalent signature-encoded names of the C programming language ("mangled names") in accordance with the so called "name mangling rules." Those skilled in the art will appreciate the correspondence between mangled and unmangled names, so that a detailed description of name mangling is omitted. An explanation of the name mangling rules may also be found in An Annotated C++ Reference Manual , incorporated by reference in its entirety above. The present invention is applicable to all distributed computer systems supporting remote procedure calls. One example of such a system is a computer network under NFS (network file system) available from Sun Microsystems, Mountain View, CA. One application of the present invention can be found in the Gifts product from Tandem Computers, Inc. of Cupertino, CA. Under Gifts, application programs are used to control, diagnose and configure hardware components of remote machines. In a fault tolerant environment, the present invention allows the Gifts product to control hardware, adding and removing components from service, and reconfiguring hardware without physical access and interruption of service. In the following description, an "object" is a data structure typically comprising "attributes" and "methods." An attribute can be a data structure associated with the object. One example of such data structure is an array of values (e.g. integers) , or a state variable useful in representing state information of the object. A method comprises one or more instructions useful in effectuating meaningful actions associated with the object. When implemented in a procedural programming language, a method is typically represented by either an operator or a procedure. In addition, each object belongs to one or more classes. All objects within a class are alike in that each object possesses the same set of attributes and methods. Each class of objects can be used to define other classes of objects. A derived class inherits from a "parent" class the parent class's attributes and methods, and, in addition, includes attributes and methods defined for the derived class, or modified from the parent class. In this hierarchy, a class from which one or more other classes are derived is called a "base" class. An embodiment of the present invention provides a base class SharedThang from which all distributed objects are to be derived. The class definition of SharedThang and its implementation are found in the files SharedThang.C and SharedThang.h of Appendix A. The class SharedThang has attributes (i) stid, which is a pointer to an object of the class SharedThangId, and (ii) commonType, which is a pointer to an object of the class Classlnfo. The stid attribute points to a SharedThangId object ("SharedThangId") , which accesses a list of all shared objects ("shared object list") in the current process space. For each shared object, if the shared object is a master, its SharedThangId maintains a list of the shared object's slaves ("slaves"). Alternatively, if the shared object is a slave, SharedThangId keeps the identity of the shared object's master ("master"). A Classlnfo object has the attributes (i) type, which is a "type code" identifying the class ("instant class") , (ii) name, which is a character string identifying the instant class, (iii) nbases, which is the number of base classes, if any, from which the instant class inherits, (iv) bases, which is an array of pointers each pointing to an object of the class Classlnfo, each such object corresponding to one of the instant class's base classes and (v) xdr, which is a pointer to a routine provided for encoding or decoding an object of the instant class to and from a neutral data format suitable for transmission between computers by a data buffer of the class XdrBuffer. In addition, the class Classlnfo includes the methods (i) CastDown, which can be used to exchange a pointer of an object for a pointer to another included object of a root class, (ii) typeof or get, which returns a Classlnfo structure corresponding to the instant class of an object, (iii) na eof, which returns the name of the instant object's class, and (iv) traverse, which visits every node in an inheritance tree (see below) . The class definition of Classlnfo and its implementation are found in Classlnfo.h and Classlnfo.C included in Appendix B. In the present embodiment, an object of the class Classlnfo is created for (i) each supported data type (e.g. integers, real etc.), (ii) each class declared, and (iii) the pointer type associated with each declared class. In SharedThangId, the slaves and the master are each represented by an object of the class Remoteld. Each Remoteld identifies the counterpart (or "twin") of a shared object in the remote environment. For example, a twin of a shared object in the server (i.e. a master) haε a list slaves of Remoteld objects, each Remoteld object corresponding to one of the master's slaves. Conversely, a twin of a shared object in a client (i.e. a slave) has a Remoteld object master corresponding to the slave's master. Each Remoteld object comprises a pointer to an object of the class RpcClient, and an index into a shared object list of a SharedThangId. Since the server's and the client's SharedThanglds typically have different shared object lists, the same shared object has different indices in the client's and the server's shared object list. The RpcClient identifies a communication channel between a master and a slave, and is explained below in further detail. Figure 1 provides the declarations of the classes SharedThang, SharedThangId and Remoteld. Class SharedThang provides the methods: (i) id(), which returns the attribute stid, (ii) masterid(), which returns the Remoteld of the master of a SharedThang, and (iii) getCommonType() , which returns commonType, which is an object of the class Classlnfo. Class SharedThangId provides the methods addClient and addMaster, for adding to a master's list slaves a Remoteld corresponding to a slave, and for adding in the slave a Remoteld corresponding to the master, respectively. In the present embodiment, a remote procedure call is performed by executing an RPC function execute passing to the rpc mechanism a "message" and a procedure number. The procedure number identifies the connection between the communicating programs, and the message iε contained in a buffer ("message") of the class XdrBuffer. The definition and implementation of XdrBuffer are included in the files XdrBuffer.h and XdrBuffer.C listed in Appendix B. To encode in a message or to decode from a message an object derived from the class Thang (from which SharedThang derives) , a method xdr in the Classlnfo object of the object's clasε is provided by the class implementer. In a message of the present embodiment, an encoded object has the fields: (i) byte_count, which is the size in bytes of the encoded object, and (ii) a list of subrecords. Each subrecord has the fields: (i) type_tag, which is the type code of an included object, (ii) byte_count, which is the size in bytes of the subrecord, (iii) primitives, which is a list of primitive data structures, and (iv) a list of subrecords. Figure 2 illustrateε in the process spaces of a server machine and a client machine in an embodiment of the present invention. In the server machine 200, an RPC mechanism 204 is a conventional application program which provides for other application programs a remote procedure call interface to accesε the low level intermachine communication εerviceε in server machine 200's kernel 250. Analogouεly, Rpc mechanism 203 provides a conventional application program interface for other application programs to access the intermachine communication services of kernel 251. Typically, the header files of an Rpc mechanism, such as Rpc mechanisms 203 or 204, are compiled with an application program to provide a conventional program interface. Kernel 250 and 251 controls the underlying physical connection, e.g. a network or bus protocol, between the interconnected computers. In the present embodiment, the interconnected computers can be of very diverse architectures. For each distributed object implemented in the present embodiment, a "master" of the distributed object is created in a server procesε, repreεented by server 206, to invoke the actual local procedure call. To access a method in the master object, it is necessary to exchange the key, which is an index into server 206's εhared object list (i.e. the list of all SharedThangs in server 206), for a pointer to the master object in server 206's memory space. Since a pointer in the shared object list is a pointer to an included object (class SharedThang) of the master, if it is necessary to activate a member function of another included object (say, clasε foo, which iε derived from claεε SharedThang) of the master, the pointer to SharedThang from the shared object list is required to be exchanged for a pointer to the included foo object. This procesε, which iε called "down casting" is performed by class Classlnfo's member function CastDown. To implement CastDown, it is necesεary that have the class derivation history of the clasεeε of all εhared objects. In the present embodiment, this derivation history is provided by using (i) a macro GIFTS_DECLARE to modify the declarations of each clasε of εhared objectε, (ii) to extract from the code generated by the preproceεsor cpp a list of shared object clasεes, and (iii) providing such a list to a stand alone program GenType to generate code in the C language, which can be compiled to form a run-time inheritance tree. This procesε iε illustrated by the block diagram of Figure 3a. As shown in Figure 3a, a macro GIFTS_DECLARE is provided at step 301 to insert into the declaration of every class ("instant class") derived from the class Thang the declarations of: (i) a member function typeofO, (ii) a number of symbolε, each symbol comprising the concatentation of the character string " magic " and the name of a base class from which the instant clasε deriveε, and (iii) a character εtring na eof, which iε aεεigned the name of the inεtant class. As a result of the macro GIFTS_DECLARE , the compilation of these additional declarations will include in the symbol table of each class a number of symbols prefixed with the character string " magic ." These symbols are used in the present invention to encode the derivation posεibilitieε of each claεs derived from the clasε Thang. The macro GIFTS_DECLARE is listed in macros.h, which is included in Appendix B. At step 302, a "script" file chomp.cpp extracts, using a text processing utility egrep, from the symbol tables of compiled object files the inserted symbols which are prefixed with the character string" magic ." These symbols are then provided to a stand-alone program GenType (step 303) running in UNIX from a command line interpreter or "shell". These εymbolε allow GenType to build an inheritance tree relating all claεεeε of objects derived from Thang. Chomp.cpp is listed in Figure 3b. The inheritance tree compriseε (i) an array list, which is an array containing the Classlnfo structures corresponding to all clasεeε, pointers to clasεeε, and primitive data typeε εupported; and (ii) for each claεε ("instant clasε") of shared objects, an array of pointers to Classlnfo, each element of the array pointing to a base clasε from which the inεtant claεε is derived. GenType outputs the inheritance tree built in step 303 in C code, which is compiled to create the inheritance tree as a static data εtructure in each of the εerver and client addreεε εpaces. In addition, GenType also generates the code to implement the typeof() member function for each class. The typeof() function accesses the list data structure to retrieve the type code of an object. The source code for GenType is provided as GenType.C of Appendix C, which is hereby incorporated by reference in its entirety. As discuεεed above, given a pointer to a Thang object included in a larger object, the purpose of Classlnfo's member function CastDown is to retrieve a pointer to either another included object of the larger object, or the larger object itself. The intended class for the down casting is provided to CastDown by name. To obtain a pointer to the larger object, a function root is called to return the pointer "root" of the larger object. If the down casting is to an included object of the larger object, CastDown traverseε the inheritance tree from the Classlnfo of "root," returned from Classlnfo's member function get, in an attempt to reach the intended class. If a clasε matching the name of the intended class is reached, CastDown computes a pointer to the larger object, using the offset between the destructor function and the this pointer in each intervening object of the derivation path. (In the programming language C++, each object is provided a pointer this, which points to the object itεelf) . If the computed pointer to the larger object matches the pointer returned from root, the down casting is succeεεful, and the pointer to the included object of the intended claεε iε returned. Otherwise, the inheritance tree is further traversed for another inheritance path reaching the intended clasε. Thiε procedure iε required because the language C++ allowε multiple inheritance pathε. Server 206 iε normally implemented as a daemon. Figure 4a is a block diagram of the program which implements a daemon Sectd (System Exercise and Confidence Test Daemon) . Daemon Sectd houseε a maεter object SectController. Sectd and SectController are respectively implemented by the program segmentε Sectd.C and SectController.C, which are liεted in Figures 4b and 8. As shown in Figure 4a, Sectd is started as an application program (i.e. server 206) using the Gifts uεer interface (εtep 401) . Sectd then creates the master for the distributed object SectController (step 402) by calling the "server" side constructor routine. As shown in the program segment SectController.C of Figure 8, a method startTester is the only method of the class SectController implemented in Sectd. In general, methods of a εhared object are implemented only on the server side. The constructor routine (server side) for SectController returns a pointer for the SectController object created (step 403) . To communicate with its clients, Sectd creates a communication server object RpcServer (step 404) . RpcServer is used to filter communication between RPC mechanism 204 and Sectd. Figureε 5 iε a block diagram illuεtrating an implementation of an RpcServer. RpcServer is implemented by two program segmentε RpcServer.h and RpcServer.C listed in Appendix A. After creating the RpcServer, Sectd goes to sleep waiting for service requests from client objects, such as client 207 of client machine 251. The remote procedure call mechanism 204 calls a routine SectdProg_l, (listed in Figure 4c) , which invokes a routine in Sectd in accordance with a handle received from a client object. As shown in Figure 5, Sectd creates an RpcServer by calling, at step 501, the conεtructor routine of an RpcServer. This constructor routine (i) calls a syεtem routine svc_register to create a transport level service for communicating between RPC mechanism 204 and Sectd (step 502) , and (ii) registers the RpcServer in the network's register εervice (εtep 503) . The network's register service provides a look-up service in the network for locating programs. The network's regiεter receives a host machine name, the program's name, and a version, and returns a handle to the requested program. An entry in the network register service allows a remote program to access the RpcServer using the program number in a remote procedure call. For each method of the distributed object, a stub routine is provided in Sectd and each of its clients, such as client 207. Thus, as εhown in Figure 2, to set up a remote procedure call for the method StartTester of SectController, "stub" routines 202 and 201 are provided to be executed in Sect 's and client 207's proceεε εpaces respectively. Stub routines 201 and 202 typically perform what are called "marshalling" and "un arshalling" operations. Marshalling maps machine-dependent data structures from the formal parameters of the.method call (e.g. pointer to an array) of one machine into a "neutral" data structure, which can be passed to the potentially different environment of another machine. Unmarshalling maps the neutral format interchanged between the environments into machine-dependent data structureε. For example, when application program 205 calls client stub routine 201 with a list of arguments in machine-dependent data structures, client stub routine 201 performs the marshalling, and sends the marshalled arguments to RPC mechanism 203, usually in the form of an interprocesε meεsage. RPC mechanism 203, and its counter part RPC mechanism 204, requests from kernel 251 system services (e.g. ports and protocols) for communicating acrosε machine boundaries. The marshalled arguments sent by RPC mechanism 203 are received by RPC mechanism 204, which in turn pasεes the marshalled arguments to Sectd. Sectd, which is a daemon procesε, calls stub routine 202 to unmarshall the received arguments. Stub routine 202 then passes the unmarshalled argumentε to the local procedure 205 (e.g. "startTester 14SectControllerFRUiRC5Twine" )', which implementε the actual requeεted service of method StartTester. Results, if any, are returned from local procedure 205 to stub routine 202, which marshals 5 the results for return to client 207. Return of resultε from Sectd to client 207 followε in reverεe substantially the path of the marshalled arguments. Stub routine 201 unmarshals the result, which is then returned to application program 208. There is no limit on the number 10 of clients, such as client 207, Sectd can εervice. The program segment for SectClientController, which is listed in SectClientController.c of Figure 6b and abstracted in the block diagram of Figure 6a, is an example of a portion of a client process, such as client 15 207, which makes a remote procedure call. Prior to making any remote procedure calls, SectClientController creates an object of the clasε RpcClient to form a communication channel between itself and Sectd (step 601) . The clasε RpcClient is also derived 20 from the clasε SharedThang. An implementation of the RpcClient object and related functionε are found in the fileε, RpcClient.h, RpcClient.c, RpcUtil.h, RpcUtil.h, Wrapper.h and Wrapper.c included in microfiche Appendix A. Aε εhown in Figure 6a, when SectClientController 25 createε an RpcClient object, RpcClient's constructor routine (SectClientController 1 s side) makes a request to syεtem εervices to request a transient program number, which is presented with the version number to initiate a 30 The name of this program is an example of a mangled name. The first part of the name, which precedes the " " is the C++ member function name, and the second part of the name, which follows the " " is the signature portion. The signature portion encodes the parameter list to this 35 member function. Mangled names allow implementation of "overloading" in the programming language C++ without modification to the C language. A C++ program is typically compiled by a C compiler, after a preproceεεor cpp generateε from the C++ program εource code in the C 40 programming language. tranεport level service (step 602) . This transport level service is used as a server in SectClientController for receiving messages from Sect 's RpcClient object, which is discussed below. (Sect 's RpcClients provide a path for communicating to the Sect 'ε clientε εtate information of master objects in Sectd, thereby forming a call-back mechanism) . Thus, with respect to mesεageε received from Sectd, SectClientController actε aε a εerver. Thiε tranεport level service is registered with the network register service to allow mesεages from Sectd to reach SectClientController (step 603). RpcClient's constructor routine then makes a remote procedure call (εtep 604) to a remote routine ret 9RpcClientFPCcϋlϋlR8ManifestϋlPC9RpcHandlePC7timeinte rval ("ret") in Sectd (through SectdProg_l, shown in Figure 4c) . The remote procedure call to ret sendε Sectd (i) the tranεport level εervice'ε tranεient program number and version number, (ii) the host machine name of SectClientController, (iii) a "manifest" (εee below) of SectClientController (explained below) and (iv) the index of the RpcClient object in SectClientController'ε εhared object liεt. In turn, remote procedure call to ret, which iε implemented in the program εegment in Wrapper.C of Appendix A, callε in εtep 605 the conεtructor routine (server side) for RcpClient to (i) translate the received manifest, (ii) and for the purpose of call-back, assigns as master of Sectd's RpcClient the index in Sect 's liεt of objectε SectClientController•s RpcClient. Sectd also creates a meεεage daemon ozmsgd (step 606) . The remote procedure call to ret returns a manifest including the information to all clasεes implemented in Sectd. Mesεage daemon ozmsgd iε intended as a facility to "call-back" the slaves of a master in Sectd, to notify the slaveε of either (i) an aεynchronouε change of εtate in the maεter, (ii) the creation of a new εhared object in Sectd, or (iii) the deεtruction of a εhared object in Sectd. In the conventional εerver-client model, a client requeεtε service from a server by εending the server a message. The server then acknowledges or returns a result after the requested service is performed. In this conventional model, the server does not initiate communication with the client. However, in the present embodiment, because a master of a distributed object serviceε one or more clientε, it iε εometimeε necessary for the master of the distributed object to communicate asynchronusly a change in εtate of the master object. To this end, acting as a client in this instance, daemon ozmsgd calls SectClientController, and all similar clients of Sectd, to communicate the master object's change in state, and the creation or desctruction of a shared object, as discuεεed above. In the preεent embodiment, a manifeεt contains, for each known class, class "meta-information." In order for slave and master objects to be properly matched, such meta-information includes, for each clasε, (i) a type code, which identifies the clasε, (ii) the name of the clasε, (iii) the number of base clasεes, if any, from which the clasε is dervied and (iv) the names of such base clasεeε. In addition, a manifeεt containε, for each shared object in the process providing the manifest, a type code and the index of the shared object into the sending process's shared objects list. The manifest is built from the structure list, a portion of the inheritance tree created by GenType described above. The definition and implementation of the class manifest are provided in the files manifest.c and manifest.h included in Appendix B. In the present embodiment, a syεtem deεigner provideε all εyεtem objects for the application programmer to use. Although these system objects may be distributed or local, the implementation is hidden from the application programmer. When SectClientController class is first instantiated, the constructor routine of the SectClientController locates the master SectController from a master'ε εhared object list created from the manifest received from the SectController (step 607) . As illustrated by this example, a connection between a master and the slave does not require that the master and the slave objects be of the same clasε. In this embodiment, compatibility is achieved since SectClientontroller iε a class derived from SectController. Thus, the same SectController in Sectd can be used to control a number of devices belonging to clasεeε derived from the SectController class. To complete the connection, SectClientController requests a "join" with the master object SectController in Sectd by making a call to a function JoinWithMaster (step 608) , passing to JoinWithMaster: (i) a pointer to SectClientController, (ii) a handle Join_With_Slave_l, representing an instruction to JoinWithMaster to call a routine JoinWithSlave, (iii) a pointer to SectClientController's RpcClient, (iv) the name of the base class "SectController," and (v) an index master into Sect 's εhared object liεt, master corrrespondε to a SectController object in Sectd. Both JoinWithMaster and JoinWithSlave are listed in the program segments of files RpcUtil.h and RpcUtil.C included in Appendix A. JoinWithMaster gets the Classlnfo object corresponding to claεε SectController. The Classlnfo object is returned by applying the typeof method on the name "SectController". The index master and the RpcClient are then associated by SharedThangId's member function addMaster with the SectClientController object. Thereafter, a remote procedure call (εtep 609) uεing the handle Join_With_Slave_l invokeε through SectdProg_l the function rJoinWithSlave FPllSharedThangP9RpcClientUi ("r oin") in Sectd to provide to Sectd SectClientController'ε index into SectClientController's shared object list. The remote procedure call to rjoin paεεeε to Sectd (i) the index master, identifying SectController in Sectd's liεt of SharedThangε, and (ii) the indiceε of RpcClient and SectClientController into SectClientController's shared object liεt. To match up with the corresponding RpcClient in Sectd, the index of RpcClient is exchanged for a pointer to the corresponding RpcClient's included object of the claεε SharedThang. Thiε SharedThang pointer iε in turn down caεted to a pointer to the RpcClient object created by Sectd above. rjoin then callε the local routine JoinWithSlave to aεεociate Sectd'ε SectController with the Remoteld formed by (i) paεεed index of SectClientController and (ii) Sect 'ε correεponding RpcClient object. Thiε Remoteld object is inserted in the SectController's slaves list, using the addClient member function of SharedThangId. To ensure that the implementation is transparent to the application programmer, the present invention provides a mechanism which preserveε for a remote procedure call "local procedure call semantics." With local procedure call semantics, the client process waits for the procedure call to return in the same manner as a procedure in the client process's memory space. Further, due to the difficulty of implementing language independent error handling mechanisms in a conventional remote procedure call, an error occurring in the remote environment is often not returned to the local environment. Instead, the calling procedure returns a time-out mesεage after some time when the expected resultε are not received. However, local procedure call εemanticε can only be preεerved when the error handling mechanism for remote procedure calls is alεo made indiεtinguiεhable from the error handling mechaniεm for local procedure calls. In a conventional implementation of remote procedure calls, the client continues sequential execution in its process space until an explicit "wait" instruction is executed. Such implementation is undesirable because the application program is required to have both knowledge of a remote implementation and synchronization with a remote event. Remote procedure calls can be effectuated by invoking in SectClientController a stub routine, such as stub routine 201, in the manner described with respect to Figure 2. In this embodiment, stub routines 201 and 202 are generated simultaneouεly uεing a stub-routine generator implemented by a "script" file (the "oz" script) . A script file is a program executable by an UNIX command line interpreter (called a "shell" in UNIX parlance) . Figures 7a and 7b are respectively the block diagrams stub routines SectController: startTester and rstartTester l4SectControllerFRϋiRC5Twine ("rstartTester") generated by the oz script for the master and slave objects, which implements in SectClientController and Sectd the distributed clasε SectController. Figure 8 iε the εource code in file SectController.C for the actual implementation of the claεε SectController in Sectd, which haε one member function SectController: :StartTester in addition to constructor and destructor functions. Since StartTester is to reside in Sectd, SectClientController*s accesε to StartTester iε through the εtub routine generated by the oz εcript. The oz εcript generateε two stub routines for SectController in fileε εvc_SectController.C and clnt_SectController.C, for compilation with Sectd and SectClientController, reεpectively. For the purpose of compiling SectClientController, SectClientController.C includes the file clnt_SectController.C. For the purpoεe of compiling the server 206, SectController.C includes svc_Controller.C. Since the member function StartTester is actually implemented only in Sectd, the body of member function SectController::StartTester is included only for compilation in the Sectd. The εtub routine generated by the oz script in Sectd is prepended by the character "r" to distinguish it from actual SectController: rstartTester code. Hence, as shown in Figure 8, the alternative compilation directive "#if defined(Server) " is used where inclusion in the Sect 'ε verεion of SectController.C (i.e. svc_SectController) iε deεired, and the alternative compilation directive "#if defined(oz)" is used where inclusion in the SectClientController's SectController.C (i.e SectController: :startTester stub) is deεired. Aε a result of compilation, an object file SectController.o is obtained for each version of SectController.C for binding with its respective client or server. Application programs binding with the client's version of SectController.o are not required to know that SectController is a distributed object. As εhown in Figure 7a, SectController: :startTester obtainε the index masterid (i.e. the index into Sect 's εhared object list) of SectController (step 701) . The unsigned long integer handle which encodes the member function to call (i.e. rstartTester) is then retrieved (step 702) by the member function rwhich of RpcClient, mapping the name of the member function to the handle. The arguments to the member function parml and parm2, the address masterid of the master and the RpcClient object rid.id are then provided in a buffer structure of the clasε XdrBuffer, which iε εupported by the RPC mechaniεmε 203 and 204 (εtep 703) . The buffer and the handle of the remote function are paεsed by the RPC mechanism to Sectd (step 704) . Figure 9a is the εource code of the example εtub routine of Figure 7a generated by the oz script for SectClientController. Figure 7b is a block diagram example of the stub routine rstartTester generated by the oz script for Sectd of an object of the clasε SectController. As shown in Figure 7b, the index of the master's RpcClient object into Sectd'ε εhared object liεt iε extracted from the message received from SectClientController (step 750) . This index of the RpcClient object is then used to retrieve a pointer in Sectd's memory space to the RpcClient's SharedThang included object, using the SharedThang: :get(id) member function (step 751) . The pointer is then down cast to become a pointer to an object of the class RpcClient (step 5 752) . The remaining parameters of the XdrBuffer are then used to obtain the index id of a SectController in Sect 's shared object list, and para eterε parml and parm2 of the startTester (step 753) . The index id iε uεed to retrieve a pointer corresponding to SectController's included 0 SharedThang object. This pointer is then down casted into a pointer to an object of the class SectController (step 754) . rstartTester then calls the actual local procedure StartTester, as a member function of the clasε SectController (step 755) . If no error occurred in the 5 local procedure call the return value in variable parml and the error code LPC_Success is returned (step 756) . Otherwiεe, exceptionε are caught by one of two catch εtatementε and the error code iε returned. In thiε manner, an exception is passed back to the stub routine in 0 SectClientController. Thus, the preεent invention preserves local call semantics in a remote procedure call. Figure 9b is the εource code of the example stub routine rstartTester of Figure 7b generated by the oz script for Sectd. 5 Figure 10 is a block diagram illustrating the operation of the oz script. Thoεe εkilled in the art will appreciate that many variationε can be used to provide the stub routines. Such variations include but are not limited to the use of a program executable by other than a 0 shell, or the use of other text procesεing utilities other than awk. The oz εcript of the preεent embodiment receiveε as input a specification file, and accepts optional command line arguments. These command line arguments εpecify (i) whether na eε in the specification 5 file are required to be "unmangled" (-raw option) ; (ii) whether a client stub routine file is to be generated (-c option) ; (iii) whether a server stub routine file is to be generated (-s option) ; (iv) whether the compiler directives for alternative inclusion of the server or client stub routine files should be appended to the body of the .C file implementing the distributed object (-m option); and (v) whether handles to the remote functionε, e.g rstartTester, should be generated for inclusion to the program, e.g. SectProg_l, called by the RPC mechanism on the server side (-h option) . Figure 11 is the content of a εpecification file used by the oz script to generate the stub routines for SectController illustrated in Figures 7a and 7b. To illustrate the generation of the stub routines diεcuεsed above, consideration of the first line in the specification file sufficeε. Aε shown in Figure 10, oz script parseε the command line and extracts from the command line arguments for setting the internal states of the oz script (step 1001) . According to whether the -raw option is set, name mangling operations are performed on the specification file (step 1002) . Mangling translates the name of a C++ function into a unique name, which includes an encoding of the function's parameter list. The results of name mangling the specification file are stored in a new file input (the "input" file) . In this embodiment, another shell script "mangle" was used to perform name mangling. However, other shell scripts which conform substantially with the name mangling rules set forth in the reference above are equally applicable. If the -raw option is not set, the specification file is copied into the input file (step 1003) directly, bypassing the name mangling step. In addition, if the -m option is set, alternative compilation directives are added to the source code file of the distributed class (step 1004) . The input file iε then parsed to extract from the unmangled names a list of the base clasεes represented in the input file (step 1005) . For example, in the input file derived from the specification file of Figure 11, two base classes "SectTester" and "SectController" are extracted from the input file. The extracted list of base classes are included into a "baselist" file. Awk command files svc.awk and clnt.awk are prepared in the next steps 1006 and 1007. Command file svc.awk (i) provides the necessary header file interfaces to the remote procedure call facility and declaration of other data structures, such as SharedThangId, (ii) examines an input temporary file for a member function call, (iii) provides in the server object unmarshalling instructions for pasεing input type parameterε to actual implementations of the distributed object and (iv) provides marshalling inεtructions for returning values of parameters of other input/output types. Command file svc.awk also provides an inεtruction in the output εerver object for downcaεting a SharedThang object to the baεe class specified in the input temporary file. Command file clnt.awk also provides interfaceε to the remote procedure call facility, and declaration of data εtructureε. In additional, clnt.awk arεhalε input type parameterε to create a remote procedure call uεing the input parameters, and provide unmarshalling instructions for output or bidirectional parameters which valueε are returned from the remote procedure call. At εtep 1008, the baεelist file is used to extract, for each base claεε, member function callε from the input file to be placed into an output temporary file. This temporary file is then used at step 1009 by both command files clnt.awk and svc.awk to generate the output stub routine files svc_<base>.C and clnt_<base>.C (where <base> is the name of the base class, e.g. SectController above) . At step 1010, the member functions of the clasε SectController are encoded into handleε to be included in a file SectdProg.c. SectdProg.c includes a Sectd function SectProg_l which callε via a εwitch εtatement functionε in Sectd, in accordance with the handle provided to the RPC mechaniεm. Appendix D provides the source liεting of the oz script described in block diagram form in Figure 10. The above description illustrateε εpecific embodimentε of the present invention and does not limit the present invention. Numerous modifications and variations are posεible within the scope of the present invention. For example, although the detailed description provided above useε as an example an implementation in the C++ programming language, the present invention is applicable to any object oriented programming language. The present invention iε εet forth by the following claims.

Claims: Claimε : 1. A structure for providing high level data structure ("object") support for application programs of a distributed computer εyεtem, comprising: first and second computers, said first computers providing a first application level interface to a first remote procedure call mechanism, and said second computer providing a second application level interface to said remote procedure call mechanisms; meanε including phyεical connection for coupling εaid first and said remote procedure call mechanismε εo aε to tranεport data between εaid firεt and second computers; means for providing a base class of sharable objectε across said first and second computers; means for providing a plurality of classes of sharable objects each derived from εaid baεe class; and means for providing an inheritance tree rooted in said base class, εaid inheritance tree relating each of said plurality of clasεeε to εaid baεe class and others of εaid plurality tree in accordance with derivation; and meanε for traversing εaid inheritance tree for conεtructing an object provided via εaid firεt and second remote procedure call mechanisms. 2. A method for providing high level data structure ("object") support for application programs of a distributed computer system, comprising the steps of: providing first and second computers, said firεt computerε providing a firεt application level interface to a firεt remote procedure call mechanism, and said second computer providing a εecond application level interface to said remote procedure call mechanismε; coupling said first and said remote procedure call mechanisms so aε to transport data between said first and second computers, said coupling step including providing phyεical connection between said first and εecond computers; providing a baεe claεs of sharable objects across said first and second computers; providing a plurality of clasεeε of εharable objectε each derived from εaid baεe class; and providing an inheritance tree rooted in said base clasε, said inheritance tree relating each of said plurality of claεεeε to said base class and others of said plurality tree in accordance with derivation; and traversing said inheritance tree for constructing an object provided via said first and second remote procedure call mechanisms. AMENDED CLAIMS [received by the International Bureau on 3 February 1994(03.02.94); original claims 1,2 amended; new claims 3-20 added; other claims unchanged (6 pages)] 1. A structure for sharing data objects in application programs of a distributed computer system, said distributed computer system comprising first and second computers, said structure comprising: a first application level interface, in said first computer, to a first remote procedure call mechanism; a second application level interface, in said second computer, to a second remote procedure call mechanisms; means, in said first and second computers, for coupling said first and said second remote procedure call mechanisms, for transporting data between said first and second computers; first means, coupled to said first application level interface, for providing a data structure representing a base class of sharable objects, each sharable object being accessible by processes in said first and second computers; second means, coupled to said second application level interface, for providing said data structure representing said base class of sharable objects; first means, coupled to said first application level interface, for providing data structures representing a plurality of classes of sharable objects each derived, in accordance with a hierarchy of classes, from said base class, each sharable object in each of said plurality of classes of sharable objects being accessible by processes in said first and second computers; second means, coupled to said second application level interface, for providing said data structures representing said plurality of classes of sharable objects; first means, in said first computer, for constructing an inheritance tree rooted in a data structure representing said base class, said inheritance tree having data structures representing relationships among said classes of sharable objects and said base class, in accordance with said hierarchy of classes; second means, in said second computer, for constructing said inheritance tree in said second computer; first means, in said first computer, for traversing said inheritance tree to construct a data structure representing a relationship between a first object and a second object in said first computer, said first object being specified in a machine-independent format by a process in said second computer via said first and second remote procedure call mechanisms; and second means, in said second computer, for traversing said inheritance tree to construct a data structure representing a relationship between a first object and a second object in said second computer, said first object being specified by a process in said first computer, via said first and second remote procedure call mechanisms. 2. A method for sharing data objects in application programs of a distributed computer system, said distributed computer system comprising first and second computers, said method comprising the steps of: providing, in said first computer, a first application level interface to a first remote procedure call mechanism in said first computer; providing, in said second computer, a second application level interface to a second remote procedure call mechanism in said second computer; coupling said first and second remote procedure call mechanisms in said first and second computers so as to transport data between said first and second computers; providing a data structure in each of said first and second computers for representing a base class of sharable objects in said first and second computers and providing data structures in each of said first and second computers for representing a plurality of classes of sharable objects each derived from said base class; and providing, in each of said first and second computers, an inheritance tree rooted in a data structure representing said base class, said inheritance tree having data structures relating, in accordance with a hierarchy, said plurality of classes and said base class; and traversing, in each of said first and second computers, said inheritance tree to construct a data structure representing a relationship between a first object and a second object, whenever said first object is specified by a procesε in one of said first and second computers and provided to the other of said first and second computers via said remote procedure call mechanisms in said first and second computers. 3. A structure as in Claim 1, wherein each of said sharable objects comprises a server object in a selected one of said first and second computers, and a client object in the other of said first and second computers, said server and client objects communicating via said first and second application level interfaces. 4. A structure as in Claim 3, wherein said client object belongs to either (a) the server object's class of sharable objects, or (b) a class of sharable objects derived from said server object's class of sharable objects. 5. A structure as in Claim 3, wherein said server object being provided with a plurality of methods to be executed on said selected computer, and said client object accessing each of said methods via a remote procedure call over said first and second application level interfaces. 6. A structure as in Claim 5, further comprising means for computing, based on said inheritance tree and using a pointer to a shared object, a pointer to either (a) a parent object containing said shared object, or (b) an included object of said parent object. 7. A structure as in Claim 6, wherein said server object maintains a list of sharable objects, and wherein said client object specifies a method in one of said sharable objects in said list using an index into said list, said server object then taking said index to obtain a pointer to said method using said means for computing a pointer. 8. A structure as in Claim 5, wherein said server object returns result of executing any one of said methods to said client object via said first and second application level interfaces, and said client object waits in a sleep mode until said result is received. 9. A structure as in Claim 5, wherein said server object returns any error message generated during execution of any one of said methods to said client object via said first and second application level interfaces. 10. A structure as in Claim 3, wherein said client object creates a server communication object and a message notifying said server object creation of said server communication object, and wherein, in responεe to εaid meεεage, said server object creates a client communication object for sending mesεageε to εaid client object. 11. A structure as in Claim 4, wherein said server object sends said client object a server manifest listing the server object's class and classes from which said server object's class is derived, and wherein said client object sends said server object a client manifest listing the client object's class and classes from which said client object's class is derived. 12. A method as in Claim 2, further comprising the step of implementing each of said sharable objects as a server object in a selected one of said first and second computers, and a client object in the other of said first and second computers, said server and client objects co - municating via said first and second application level interfaces. 13. A method as in Claim 12, further comprising the step of providing said client object in either (a) the server object's class of sharable objects, or (b) a class of sharable objects derived from said server object's class of sharable objects. 14. A method as in Claim 13, further comprising the steps of: providing said server object with a plurality of methods to be executed on said selected computer; and accessing, from said client object, each of said methods via a remote procedure call over said first and second application level interfaces. 15. A method as in Claim 14, further comprising the step of computing, in each of said first and second computers, based on said inheritance tree and using a pointer to a shared object, a pointer to either (a) a parent object containing said shared object, or (b) an included object of said parent object. 16. A method as in Claim 15, further comprising the steps of: maintaining in said server object a list of sharable objects; specifying an index into said list, when accessing any method in one of said sharable objects in said list; and taking said index to obtain a pointer to said method using said step for computing a pointer. 17. A method as in Claim 14, further comprising the steps of: returning from said server object a result of executing any one of said methods to said client object via said first and second application level interfaces, and waiting in a sleep mode of said client object until said result is received. 18. A method as in Claim 14, further comprising the step of returning any error message generated during execution of any one of said methods to said client object via said first and second application level interfaces. 19. A method as in Claim 12, further comprising the steps of: creating in said client object a server communication object and a message notifying said server object creation of said server communication object; and creating in said server object, in response to said message, a client communication object for sending messages to said client object. 20. A method as in Claim 13, further comprising the steps of: sending said client object a server manifest listing the server object's class and classes from which said server object's class is derived; and sending said server object a client manifest listing the client object's class and classes from which said client object's class is derived.

Inventors: DAVIDSON THOMAS J, KELLEY MICHAEL T, DAVIDSON, THOMAS, J., KELLEY, MICHAEL, T.
Applicants: TANDEM COMPUTERS INC, TANDEM COMPUTERS, INCORPORATED
Application year: 1993
Main classification: G06F13
IPC codes: G06F9, G06F13, G06F15, H04L29