CA2251484A1 - Method, apparatus & program product for accessing alarm conditions from a server - Google Patents

Abstract

Apparatus, methods and computer program products are disclosed for an alarm API
for monitoring devices in a network. A client application instantiates an API that contains a logical-object. The application invokes a method of the logical object that is automatically executed on a server and performs an operation on a management information service containing alarm records about the monitored devices.

Description

CA 0225l484 l998-l0-22 _ Page: 1 METHOD, APPARATUS & PROGRAM PRODUCT FOR
ACCESSING ALARM CONDITIONS FROM A SERVER

Background of the Invention 15 Field of the InvenVon This invention relates to the field of management inforrnation service (MIS) access mech~nism~. In particular, the invention provides a JAVA application programmer with an interface to a MIS, such as the Solstice~M Enterprise ManagerTM from Sun Microsystems Inc., to access records in the MIS.

~3ackground Object-oriented progr~rnrning (OOP) languages associate an object's data with prograsnrned-methods for operating on that object's data. Usually, OOP objects are instantiated in a heap memory area and are based on classes that reference the programmed-methods for the OOP object. ~nstantiated OOP objects contain data (in instance variables) specific to that particular instantiated OOP object. Conceptually, an OOP object contains P2766~26-002~0~C 10/21/97 CA 022~l484 l998-l0-22 Page:2 object-related information (such as the number of instance variables in the object), the instance variables, and addresses of programmed-methods that access and/or manipulate the contents of the instance variables in the object. However, because objects often share programmed-methods and object-related information, this shared information is usually s extracted into a class. Thus, the in~t~ntiated object simply contains its instance variables and a pointer to its class.
Smalltalk, Java and C++ are examples of OOP languages. Smalltalk was developed in the Leaming Research Group at Xerox's Palo Alto Research Center (PARC) in the early 1970s. C++ was developed by Bjame Stroustrup at the AT&T Bell Laboratories in 1983 as 10 an extension of the C programming language. Java is an OOP language with elements from C
and C++ and includes highly tuned libraries for the intemet environment. It was developed at Sun Microsystems and released in 1995.
Further information about OOP concepts may be found in Not Jl st Java by Peter van der Linden, Sun Microsystems Press/Prentice Hall PTR Corp., Upper Saddle River, NJ, 15 ( 1997), ~SBN 0-13-864638-4, pages 136-149.
A client/server computing environment allows a client computer to use a service or resource provided by a server computer. Generally many clients use the server computer.
The client/server environment provides advantages well known in the art and described in Not Just Java at page 199. With the advent of progr~mming environrnents that are independent of the computer used to execute them (for example, progr~mmin,~ environments that include the Java Virtual Machine), client applications are being developed that execute on a variety of different computers. Because the executable code for these applications is independent of the computer architecture and operating system that execute the code, only one compilation of the executable code need be created. This compilation of the exçcut~ble code can be transferred from storage on a server, over the network, to a client where the code is executed. Sometimes the client and server portions of an application execute on the same computer.
A "thin-client" is a networked client computer that does not have permanent local storage. Thus, the storage service is provided by a server computer termed a "thick-" or "fat-"

P2766~426-002~DBC 10t21197 CA 022~1484 1998-10-22 Pag~:3 server. Thin-clients read Java applications stored on the fat-server and locally execute them.
These applications can, in turn, access data from the fat-server or other sources on the Internet. The thin-client/thick-server environment is described in ~ot J~st Java at pages 207-218.
As previously mentioned, lava is an object-oriented progr~mming language. Thus, it is useful to transport objects between the client and server. It is also advantageous to invoke an object's method that resides on one computer by a program executing on another computer. Iava generally uses the remote method invocation (RMI) interface to provide this capability. The RMI interface is described in Core Java, by Comell and Horstmann, 2nd edition, ISBN 0-13-596891-7, ~ 1997 Sun Microsystems, Inc. at pages 643-681. Other interfaces exist (such as the CORBA standard) that provide sirnilar functionality.
One difficulty with remote method invocation interfaces is that the application programmer must explicitly obtain a reference to a remote object before invoking that object's programmed-methods. This additional complexity increases the difficulty involved to create a networked application. In addition, the object's programmed-methods are either executed on the client or on the server dependent on the location of the object. Thus, simple programrned-methods, such as obtaining the value of an object's data, are high overhead operations if the object is located on the server because the client must cause the server to execute the programmed-method that retums the value. This value is then returned across the network to a~ the client. These overheads impact the perfommance of the application on the thin-client. It would be advantageous to provide an object that extends across the client/server interface and that has the capability to automatically execute one of its prograrnmed-methods on the client and another of its progldlnll,ed-methods on the server. One aspect of the invention provides this capability.

Another problem with client-server systems, such as the previously described thin-client/fat-server system, is that the server portion of the system generally must invoke operations on an existing service--one that was not necessarily implemented to take P2766/8426-0023/D~C 10121/97 CA 022~l484 l998-l0-22 Page: 4 advantage of modem computing environment features such as a multi-thread capability Thus, the programmer generally limits the implementation of an application to the programming techniques allowed by the existing service. Because many existing server applications do not support thread-safe APIs, multiple client threads (either in the same server, or extending across multiple servers, or both) must synchronize access to the service so the client application can be written using the modem progr~mming techniques. Thus, when the service is upgraded to use the new methodology, the existing client programs will not need to be modified to use the new capabilities of the service. In addition, many APIs are written in a prograrnming language other than the language used to write an application. It is 0 expensive to convert an API written in one language to another language. Thus it is advantageous to provide an API written.in the new language that invokes the methods used by the corresponding API written in the original language. Threads are briefly discussed in Not Just Java at pages 149-156.
A network management inforrnation service is an example of a service that can beprovided to a client by a server. Such a service, like the SolsticeTM Enterprise Manager~M
from Sun Microsystems Inc., gathers information about network devices, stores this information in a management information service (hIlS), and provides this information to other applications. Monitoring this information in a thin-client/fat-server environment would allow a user or network a~lminictrator to monitor network from inexpensive thin-clients or from a Java enabled web browser. Such a network management application on a client must be able to request information about the network devices that are relevant to the network ~AminiStrator. Such an application must also receive notification that a relevant event has occurred in the MIS regarding those devices. Thus, it would be advantageous to provide a technique that serializes clients' access to a shared service and that distributes events generated by the service to the clients that have registered to receive the events.

Yet another problem with client-server systems is that of the client perforrningoperations on their server's MIS. ~n particular, sending large numbers of data records from a MIS system from the server to the client requires significant network bandwidth if the client P2766~26-0023/OBC 10/21~7 CA 022~1484 1998-10-22 _.~

Page: 5 and server reside on different computer systems- Also, if the client is a thin-client it may not have sufficient resources to timely process or store the data records. Thus, it would be advantageous for the server to provide those services that require extensive computational and VO processing to the client through an API.

Summary a' the Invention The present invention provides an apparatus, method and computer program productfor providing an application executing on a client, with an alarm API for interfacing to a MIS
executing on a server. One aspect of the invention includes a computer controlled method for providing a client application with access to a management information service (h~IS) 10 provided by a server. The MIS contains data about a monitored condition. The computer controlled method includes the client application instantiating an application programmer interface (API) that comprises a logical object and includes the client application involcing a prograrnmed-method of the logical object. In addition the server executes the programmed-method to access the MIS.
Another aspect of the invention includes an apparatus having a central processing unit (CPU) and a memory coupled to said CPU for providing a client application with access to a management information service (MIS) provided by a server. The h~IS contains data about a monitored condition. The apparatus comprises an instantiation mechanism configured to inst~ntiate, responsive to said client application, an application programmer interface (APr).
The API comprises a logical object. The apparatus also includes a method invocation mtoch~nicm configured to invoke a programmed-method of the logical object by the client application. In addition, the apparatus includes an execution m~ch~ni5m configured to execute the programmed-method at the server to access the MIS.
Another aspect of the invention includes a computer program product emhedded in a ~; computer usable medium for causing a computer to provide a client application with access to a management information service (~vIIS) provided by a server. The MIS contains data about a monitored condition. When executed on a computer, the computer readable code causes a computer to effect an instantiation mech~nism, a method invocation m~ch~nism, and an P2766~426-002~0~C 10121/97 . _ , . .

CA 022~l484 l998-l0-22 Page:6 execution m~ch~nicm Each of these mech~nicmc have the same functions as the corresponding mechanisms for the previously described apparatus.
These and other features of the invention will become apparent when the following detailed description is read in combination with the accompanying figures.

Description a' the Drawings Fig. l illustrates a computer system capable of using the invention in accordance with a preferred embodiment;
Fig. 2A illustrates a client-server architecture in accordarlce with a preferred embodimçllt:
Fig. 2B illustrates an object-factory in accordance with a preferred embodiment;
Fig. 2C illustrates a server object in accordance with a preferred embodiment;
Fig. 3 illustrates a server-object creation process in accordance with a preferred embodiment;
Fig. 4 illustrates a server-object initi~1i7~-ion process in accordance with a preferred embodim~nt;
Fig. S illustrates an API registration process in accordance with a preferred embodiment;
Fig. 6 illustrates an API operation invocation process in accordance with a preferred embodiment;
Fig. 7 illustrates a client event handler dispatch process in accordance with a preferred embodiment;

P2766~426-002~D~C 10121/97 .

CA 022~l484 l998-l0-22 -Page: 7 Fig. 8 illustrates a client-resident event distribution process used to pass an event to the registered API in accordance with a preferred embodiment;
Fig. 9 illustrates a server event handler process to pass an event to the client s dispatcher in accordance with a preferred embodiment;
Fig. 10 illustrates a constructor process for a logical object in accordance with a preferred embodiment;
Fig. 11 illustrates an invocation process for a logical object in accordance with a preferred embodiment; and Fig. 12 illustrates operation of an application programmer interface having alogical object in accordance with a preferred embodiment.

Des~iption ~f the Pr~erred Embodiments Notations and Nomenclature The following 'notations and nomenclature' are provided to assist in the underst~n~ling of the present invention and the preferred embodiments thereof.
Application Programmer Interface (API)--The API is a definition for the classes and programmed-methods a prograsnmer can use to implement an application.
Constructor--A programmed-method for ini~i~li7ing an instance of an object.
Framework--A framework is a set of classes that provide extensible facilities (using 20 object-oriented methodologies) for performing services for the application program that uses the framework. Thus, frameworks are essenti~lly groups of interconnected object classes that provide a pre-fabricated structurc of portions of a working application. An API differs from a framework in that the framework is an implementation of the API. The framework also includes private methods and data that are not visible to the programmer who uses the API.

P2766/a426-0023/DBC 10/21/97 CA 022~1484 1998-10-22 Page:8 Java Native Interface (JNI)--An API that allows a lava program to invoke programmed-objects and other procedures that are not programmed in Java (for example, C or C++ procedures).
Logical Object--A composite object comprising one or more objects that cooperatein a client/server environment to provide an automatic network invocation of a remote programmed-method. The locality of the prograrnmed-method (that is, whether it is located on the client or the server) is transparent to the programmer.
Management Information Ser~ice (MIS)--A ~S is a service provided by a server computer. Thus, the service is either a library or a framework that provides services to a 10 client. The client and the server may reside in the sarne computer.
Progr~mmed-method--A programrned-method is a procedure associated with an object-oriented object or class that performs a function on the object.
Remote Method Invocation (RMI)--A mechanism that allows distributed programming in a client/server environment using Java.
Topological node--A logical representation of a network device that is monitoredby a management information server.
Procedure--A self-consistent sequence of steps leading to a desired result. These steps are those requiring physical manipulation of physical quantities. Usually these quantities take the form of electrical or rn~n~tic signals capable of being stored, transferred, combined, compared, and otherwise manipulated. These signals are referred to as bits, values, elements, symbols, characters, terms, numbers, or the like. It will be understood by those skilled in the art that all of these and similar terms are associated with the appropriate physical quantities and are merely convenient labels applied to these qu~ntitiçs Overview The manipulations performed by a computer in executing prograrnmed instructions are often referred to in terms, such as adding or comparing, that are cornmonly associated with P2766~426-002~BC 10121/97 , CA 022~l484 l998-l0-22 Page: 9 mental operations performed by a human operator. ~n the present invention no such capability of a human operator is necessary in any of the operations described herein. The operations are machine operations. Useful machines for performing the operations of the invention include programmed general purpose digital computers or similar devices. In all cases the method of computation is distinguished from the method of operation in operating a computer. The present invention relates to method steps for operating a computer in processing electrical or other (e.g., mechanical, chemical) physical signals to generate other desired physical signals.
The invention also relates to apparatus for p~ro~ ing these operations. This 10 apparatus may be specially constructed for the required purposes or it may comprise a general purpose computer as selectively activated or reconfigured by a computer program stored in the memory of a computer. The procedures presented herein are not inherently related to a particular computer or other apparatus. ~n particular, various general purpose machines may be used with programs written in accordance with the t~ching.s herein, or it may prove more convenient to construct more specialized apparatus to perform the required method steps. The required structure for a variety of these machines will appear from the following description.
Also, the invention may be embodied in a computer readable storage medium encoded with a program that causes a computer to perform the programmed logic.

O,u~ra~irlg Environment Some of the elements of a computer system, as indicated by general reference character 100, configured to support the invention are shown in Fig. 1 wherein a processor 101 is shown, having a central processor unit (CPU) 103, a memory section 105 and an input/output (VO) section 107. The I/O section 107 is connected to a keyboard 109, a display unit 111, a pointing device 113, a disk storage unit 115 and a CD-ROM drive unit 117. The 25 CD-ROM drive unit 117 can read a CD-ROM medium 119 that typically contains a program and data 121. The CD-ROM drive unit 117, along with the CD-ROM medium 119, and the disk storage unit 11S comprise a filestorage m~ch~nicm One skilled in the art will understand that the CD-ROM drive unit 117 can be replaced by a floppy disk, magnetic tape unit or similar device that accepts a removable media that can contain the program and data 121. In P2766~426-002~0~C 10/21/97 CA 022~l484 l998-l0-22 Page:10 addition, the computer system 100 includes a network interface 123 that connects the processor 101 to a network 125. The network 125 can be used to communicate between the processor 101 and a networked computer 127. Such a computer system is an example of a system that is capable of executing procedures that embody the invention.
s One skilled in the art will understand that client-server architectures enable the client program and the server program to be executed by the same computer or by separate networked computer systems. While the following description is cast within a networked computer system architecture, the description also applies to a single computer that hosts both the server and the client.

JAVA Management Adapter Fig. 2A illustrates a client-server architecture, indicated by general reference character 200, that enables a multi-threaded client application programmed in one language to use a single threaded service provided by the server. The architecture 200 includes a client 201 that often is a computer or network appliance. One skilled in the art will understand that the subsequently described invention is applicable to fully featured large computers as well as thin-clients. The client 201 communicates to a server 203 that oRen is hosted on a computer separate from the computer that hosts the client 201. An application 205 executes in the client 201 and invokes procedures from an API 207. The API 207 can be an object-oriented framework or a procedural library. The API 207 communicates to a Java-Management-Adapter (JMA) 209 that resides on the server 203. The JMA 209 uses a Java-Native-Interface (JNI) 211 to access the functions of a portable management interface (PMI) 213. The PMI
213 is a multi-thread unsafe framework (written in C~) that provides access to amanagement information service (MIS) 215 (for example, Sun Microsystems ~nc.'s Enterprise ManagerTM).
Fig. 2B illustrates a IMA architecture, indicated by general reference character 220, that includes a JMA dispatcher 221, a first server object 223 and a second server object 225.
The client 201 comrnunicates with the JMA dispatcher 221 to create server objects such as the first server object 223 and the second server object 225. A server object exists for each client P2766~426-002~DBC 10/21/97 CA 022~l484 l998-l0-22 Page: l 1 that registers with the JMA dispatcher 221. The IMA dispatcher 221 is an object factory that creates a server object in the server 203 for each registered client.
Fig. 2C illustrates a server object environment, indicated by general reference character 230, that serializes access from a multi-threaded client to the MIS 215. The server s object environment 230 includes a server object 231 that contains a 'server event handler' thread 233 and a 'controlling PMI' thread 23S that creates an exclusion lock 237. The exclusion lock 237 serializes a thread, such as a 'PMI operation' thread 239 that operates on a JNI/PMI procedure 241. The 'PMI operation' thread 239 is started by the 'controlling PMI' thread 235 in response receipt, by the server object 231, of a request to perform an operation lo from the API 207. Once the 'PMI operation' thread 239 obtains the exclusion lock 237 the 'PMI operation' thread 239 can invoke a JNI/PMI procedure 241 to access the requested servlce.
The 'server event handler' thread 233 receives event conditions from the JNVPMI
procedure 241 and passes these events to the client 201 associated with the server object 231.
Fig. 3 illustrates a server creation process, indicated by general reference character 300, used by the client portion of the JMA dispatcher to inct~nti~te a JMA server object. The server creation process 300 initiates at a 'start' terminal 301 and continues to a 'receive newserver message' procedure 303 that receives a 'r.ew server' message. The 'new server' message is processed by a 'lookup host' procedure 305 that uses a uniform resource locator 20 (URL) string supplied with the 'new server' message to locate and make a connection with the server computer system. If no URL string is provided, the 'lookup host' procedure 305 assumes that the service is located on the same computer as the client. Once the server system is located, the server creation process 300 continues to a 'lookup IMA dispatcher' procedure 307 that locates the JMA dispatcher using methods well known in the art such as connecting 2~ to a known port, or by using a directory to find the dispatcher. Next, an 'instantiate new server' procedure 309 causes the JMA ~icp~-~h~r application on the server to instantiate a new server object on the server system. The new server object provides the desired services to the client. Then the server creation process 300 continues to a 'lookup new server' procedure 311 that locates the just-created server object executing on the server computer system. Then the , CA 022~1484 1998-10-22 .
.

Page: 12 server creation process 300 continues to a 'start eventdispatch thread' procedure 313 that initiates a thread used to dispatch events received by the just-created server to objects that have registered to receive specified events.
Once the client event dispatch thread is started by the 'start eventdispatch thread' procedure 313 the server creation process 300 continues to a 'connect with new server's event handler thread' procedure 315 that causes the event dispatch thread to connect with the server's event handling thread (subsequently described with respect to Fig. 4). Then the server creation process 300 completes through an 'end' terminal 317.
Fig. 4 illustrates a server initialization process, indicated by general reference 0 character 400, that is invoked by the 'instantiate new server' procedure 309 of Fig. 3. The server initialization process 400 initiates at a 'server object start' terminal 401 and continues to a 'start initial PMI thread' process 403 that starts the initial PMI access thread. This thread is used to initialize the PMI through the JNI. This thread also establishes the locking mech~nicmc used to serialize access, by other PMI operation threads within the server object, to the PMI frarnework. One skilled in the art will understand that other thread-unsafe frameworks can be accessed using these techniques. Once the initial PMI thread is started, the server initialization process 400 continues to a 'start event handler thread' process 405 that is used to route events generated by the MIS to the appropriate client. Then, a 'connect with client's eventdispatch thread' process 407 waits until the 'connect with new server's event 23 handler thread' procedure 315 attempts a connection with the event handler thread that was started by the 'start event handler thread' process 405. Once the server's event-handler thread is connected with the client's event dispatch thread, the server initialization process 400 completes though an 'end' terminal 409. Once the server initialization process 400 completes, the server is able to receive, process, and return results for requests from applications executing on the client and is able to pass events from the server to the client.
Fig. 5 illustrates an API registration process, illustrated by general reference character 500, that registers an API, such as an alarm API, with the IMA. The API registration process 500 initiates at a 'register API start' terminal 501 in response to the API invoking the registration process. The API registration process 500 continues to an 'instantiate API

P2766t~426-0023/D~C 1 Ot21t97 _ CA 022~1484 1998-10-22 , Page: 13 service' procedure 503 that instantiates a IMA service for the requesting API. After the service is instantiated, the service starts an API service at a 'start APr service' procedure SOS.
The API service will be used to service requests made to the IMA from the API.
After the API service is started, the API registration process 500, retums the API
5 handle at a retum API service handle' procedure 507. The retumed API handle corresponds to the API service inst~n~i~t~d at the 'instantiate API service' procedure 503. The API
registration process 500 completes through an 'end' terminal 509. The APr can request services (operations) from the IMA once the API is registered.
Fig. 6 illustrates an API operation process, indicated by general reference character 10 600, that processes a PMI invocation that resulted from an API operation. The API operation process 600 inisi~tes at an 'API operation start' terminal 601 in response to the API
application requesting a JMA service that invokes a PMI service. The API operation process 600 continues to an 'invoke lock PMI' procedure 603 that acquires the PMI lock established by the initial P~vII thread created by the 'start initial PMI thread' process 403 of Fig. 4. One 15 skilled in the art will understand that the thread is suspended until the thread is able to acquire the lock. In addition, one skilled in the art will understand that the API service thread assigns a thread to effectuate the requested operation. Once the lock is acquired the API operation process 600 continues to an 'invoke PMI operation' procedure 605. The 'invoke PMI
operation' procedure 605 now invokes the appropriate PMI operation from the PMI
framework through the JNI. Once the PMI operation retums, a 'release PMI lock' procedure 607 releases the PMI lock to allow other threads access to the PMI framework. If a result is retumed by the PMI operation the operation result value is retumed to the API application.
Finally, the process completes through an 'end' terminal 609. Thus, the API operation process 600 serializes access to the PMI frarnework and perfomms the operation requested by 25 the API. In addition, one skilled in the art will understand that the operations used by the IMA can be applied to services other than the PMI framework and may be provided by a traditional routine library.

P27661842~0023/D~C 1 0/21/97 CA 022~1484 1998-10-22 Page:14 The IMA-API interface is optirnized with respect to handling events. Instead of using RMI or other client/server object communication packages, this interface uses a TCP/IP
socket or equivalent.
Fig. 7 illustrates a client event-dispatch process, indicated by general reference character 700, that processes events delivered by the server event handler thread that is subsequently described with respect to Fig. 9. The process 700 initiates at a 'start' terminal 701 and continues to a 'delay for server' procedure 703 that waits for the start of the server's event handler thread (invoked by the 'start event handler thread' process 40S of Fig. 4). The 'delay for server' procedure 703 completes when the process 700 receives the connection 0 initiated by the 'connect with client's eventdispatch thread' process 407. Once the process 700 detects that the server event handler has started, the process continues at a 'start incoming event threads' procedure 705. The 'start incoming event threads' procedure 705 generates enough threads to handle (at most) the maximum number of events expected during the time required to process the longest event. Next a 'receive API event listener registration' procedure 707 waits for an API to register with the process 700. The event listener registration is sent by the 'connect with new server's event handler thread' procedure 315 of Fig. 3. The 'receive API event listener registration' procedure 707 stores the identification of the APr and the event types that are of interest to the API. Next, the process 700 waits at an 'event delivery' procedure 708 for receipt of an event generated and sent from any relevant 20 event source (such as the MIS). Next, an 'assign event to thread' procedure 709 assigns the event to a thread for processing. Once the event is ~csigned to a thread, the thread executes a 'pass event to registered API' procedure 711 that deterrnines which registered APIs (if any) have requested notification for the event and distributes the event to those APIs. Events are sent from the server's event handler process as is subsequently described with respect to Fig.
25 9. Then the process 700 continues to a 'termination requested' decision procedure 713 that deterrnines whether the process 700iS to terrninate. If the process 700isto continue, the process returns to the 'assign event to thread' procedure 709 and wait for the next event.
However, if the process is to terminate, it continues to a 'stop threads' procedure 715 that kills the threads started at the 'start incorning event threads' procedure 705. Then the process :~ completes through an 'end' terminal 717.

P2766~26-002~DBC 10/21197 CA 022~l484 l998-l0-22 -Page: 15 Fig. 8 illustrates a 'pass event to API' process, indicated by general referencecharacter 800, that is invoked by the 'pass event to registered API' procedure 711 of Fig. 7.
The process 800 initiates at a 'start' terminal 801 and continues to an 'event ID match' decision procedure 803 that exarnines the event to deterrnine whether an API has registered s for that particular type of event. If the 'event ID match' decision procedure 803 successfully matches the event with a registered API, the process 800 continues to a 'pass copy of event to APIs event handler' procedure 805 that passes a copy of the event to those APIs that have registered to receive events of that type. In a preferred embodiment this event communications is handled by a low overhead communication mechanism such as TCP/IP
0 sockets or equivalent. Then the process 800 continues to a 'dereference event' procedure 807 that dereferences the original event. If the 'event ID match' decision procedure 803 determines that the event is not of interest to any of the registered APIs, the process simply continues to the 'dereference event' procedure 807. After the 'dereference event' procedure 807 finishes the process 800 completes through an 'end' terminal 809.
Fig. 9 illustrates a 'server event handler' process, indicated by general reference character 900, that receives an event that occurs on the server and passes the event to the client event-dispatch process 700 of Fig. 7. The 'server event handler' process 900 initiates at a 'start' terrninal 901 and continues to a 'receive event' procedure 903. The 'receive event' procedure 903 receives an event generated at the server. Then a 'send event to client' ;D procedure 905 sends the event to the client's event ~li5patcher (previously described with respect to Fig. 7) where the event is received at the 'event delivery' procedure 708. Then the 'server event handler' process 900 completes through an 'end' terminal 907.

Thin-Cla~s A thin-class is a logical class (that defines a logical object) that is implemented to reduce the resource usage on the client. One advantage of the thin-class is that it hides the complexity involved with prograrnrning distributed applications. The thin-class also makes the distributed nature of the object transparent to the programmer because the thin class autom~ic~ily invokes the client-server comml~nic~tion ~ch~nism (if required) to communicate to a prograrnmed-method located on the server. The underlying transport P2766~26-002~0~C 10/21/97 CA 022~1484 1998-10-22 _.

Page: 16 mechanism used in the client-server communication is often the remote method invocation (RMI) mechanism, object request broker mechanism such as defined by the CORBA standard, or some other similar mechanism. Finally, the thin-class allows an API programmer to balance execution speed and memory usage required to effectuate the AP~ by specifying the 5 locality of the programmed-methods used in the class. Thus simple programmed-methods may be located at the client while more complex programmed-methods may be located at the server. The prograrnmer of an application that uses a logical object of the API is completely unaware of the locality of the programmed-methods for that logical object.
Fig. 10 illustrates a 'thin class constructor' process, indicated by general reference 10 character 1000, used by a logical object when the logical object is instantiated. The 'thin class constructor' process 1000 initiates at a 'start' terminal 1001 and continues to an 'instantiate local portion' procedure 1003. The 'instantiate local portion' procedure 1003 creates an object on the client that provides programmed-methods for the logical object that execute on the client. These programmed-methods generally are those that are small enough and simple enough so that the thin-client's resources are not adversely affected by the instantiation of the object or execution of the associated programmed-methods. One example of such an object would be an object that contains limited private data and has programmed-methods that provide access to this private data. Such programmed-methods are generally small and execute sufficiently rapidly that they are appropriately implemented on the thin-client. Next, the 'thin class constructor' process 1000 continues to an 'initialize communication with server' procedure 1005 that initi~t~s communication with the fat-server. This procedure generally locates the server host and connects to a known process. An 'instantiate remote portion' procedure 1007 causes the known process to instantiate a remote portion of the logical object on the fat-server. The remote portion includes programmed-methods that would impact the operation of the thin-client. The API developer determines whether the thin-client or fat-server should execute the programmed-methods and implements the API
accordingly. Finally, the 'thin class constructor' process 1000 completes through an 'end' terrninal 1009. One skilled in the art will understand that the 'thin class constructor' process 1000 creates object stubs and skeletons as al)~ropliate when the client-server communication CA 022~l484 l998-l0-22 . _ Page: 17 mechanism is RMI. Equivalent mechanisms exist, or can be constructed, for other client-server communication technologies.
Fig. 11 illustrates a logical object prograrnmed-method invocation process, indicated by general reference character 1100, for invoking a logical object's programmed-method.
The logical object prograrnmed-method invocation process 1100 initiates at a 'start' terminal 1101 and continues to a 'remote method' decision procedure 1103. The 'remote method' decision procedure 1103 determines whether the programmed-method to be executed is located in the client portion or in the server portion of the logical object. If the prograrnmed-method is located in the client portion, the logical object prograrnmed-method invocation 0 process 1100 continues to an 'invoke local method' procedure 1105 that dispatches the programmed-method resident in the client. The programmed-method executes in the client and using the data resident in the client portion of the logical object. Once the prograrnmed-method returns, the logical object programmed-method invocation process 1100 completes through an 'end' terminal 1107.
However, if the 'remote method' decision procedure 1103 determines that the programmed-method to be executed resides in the server portion of the logical object, the logical object prograrnmed-method invocation process 1100 continues to an 'invoke stub method' procedure 1111. The 'invoke stub method' procedure 1111 sends a copy of the logical object's instance variables in the client portion to the server portion and then invokes the stub object that corresponds to the skeleton object resident in the server portion of the logical object.
In an RMI embodiment, the 'invoke stub method' procedure 1111 communicates with a skeleton object located within the server portion of the logical object. This communication causes an 'invoke skeleton method' procedure 1113 to cause the remote programrned-method to execute. An 'execute remote method' procedure 1115 executes the prograrnmed-method in the server using the jnst~nce variable values sent by the 'invoke stub method' procedure 1111.
Next, a 'send remote data' procedure 1117 sends the possibly modified instance variable data from the server portion of the logical object back to the client portion of the logical object to P2766~426-00231DBC 1 0/21/97 CA 022~l484 l998-l0-22 Page:18 update the client's portion of the logical object. The logical object programmed-method invocation process 1100 then completes through the 'end' terminal 1107.
One skilled in the art will understand that although the previous description is directed towards an embodiment that uses the RA~ capabilities of lava, that the user of other object s communication protocols, such as CORBA, are contemplated by the invention.
in addition, once the local and remote portions of the logical object are constructed, the application can invoke the API logical object's methods transparently as to whether the method is actually executed by the client or by the server. Thus, programming applications for thin-clients is greatly simplified by the use of APIs that implement thin-classes. Such an 10 API hides the details of the client/server cornmunication from the programmer and allows the programmer to transparently use the API without regard to any underlying inter-program communication issues. The prograrnmer of an application that uses the API can transparently use the API objects without concem as to whether the object executes in the client or in the server and the method will be automatically executed on the server as applopliate. Instead this consideration is analyzed by the programmer of the API who determines which methods are to be executed in the client and the server. Some embodiments of the API allow dynarnic detem~ination of the locality of the logical object's methods. These embo-limen~s determine the capabilities and resources of the client and determine the locality of the methods dependent on this determination.
The use of a thin-class also enables the underlying inter-program communication mech~nicm (i.e., RMI, CORBA or other mechanism) to be changed without requiring a change to the application program.

ALARM API
One aspect of the invention is that of an alarm API. The alarm API provides the prograrnmer with facilities for accessing a management information service (MIS) from a thin-client. Thus, an application designed to display alarrn information about networked devices can use the alarm API to obtain information about those devices. The API is an implementation of the previously described thin-class.
P2766~426-002~0BC 10/21/97 CA 022~1484 1998-10-22 Page:19 The API programmer determines which methods are local (to be executed on the client) and which are remote (executed on the server). The prograrnrner who uses the API
need not understand where the programmed-method is executed. The servertclient communication is transparent to the programmer who uses the API. Thus, even in very thin-s clients programmers need not balance the tradeoffs generally required for using the thin-client as the API programmer has already done so.
The thin-client often receives an AlarmRecord in response to subsequently described methods. To minimi7~ the amount of memory used in the thin-client and the bandwidth required between the thin-client and fat-server that contains the network database 0 only selected portions of the AlarmRecord (the attributes-of-interest) are transferred. The programmer selects which attributes-of:interest by specifying an argument of type Alar~RecordAttributeSet in the invocation of the appropriate programmed-methods.
In the following section, the term "method" is used to refer to a "programmed-method."
Fig. 12 illustrates a MIS access process, indicated by general reference character 1200, for providing a client with access to a MIS resident on a server. The process 1200 initiates at a 'start' terminal 1201 by an application executing in the client and continues to an 'instantiate API' procedure 1203. The ~in~t~nti~te API' procedure 1203 instantiates an API in the client. Next, at a 'specify attributes-of-interest' procedure 1205 the application specifies the attributes-of-interest. The attributes-of-interest specify which fields are included in records returned by the server. Next, the application invokes a me~hod in the API at an 'invoke API method' procedure 1207 that sends a message to the server to perfomm an operation. The server then executes the invoked method at an 'execute API method' procedure 1209. This method accesses the MIS to obtain data and perform the desired operations on the data. Generally, this method generates results that are retumed to the client at a 'retum values for attributes-of-interest' procedure 1211. Some methods recursively traverse the topology tree descending from a particular topological node in the network.
These methods may retum a result for each node traversed. The 'retum values for attributes-of-interest' procedure 1211 collects the values for the attributes-of-interest specified by the P2766~426-002~0BC 10/21/97 .

Page: 20 'specify attributes-of-interest' procedure 1205 and sends this information to the client where they can be accessed by the application. The returned information, for an alarrn API, is in the form of alarm records. The process 1200 can return data about a monitored condition in the MIS. Where the MIS is a network MIS this data is often the status of a monitored device or s topological node. This data can be provided to a user of the client application.

public class AlarmR~cord implements Serializable {
String g~tAc~O--V~rator();
boolean ~-tAc~Stat~();
String g-tAc~T~xt();
Date g~t~c~Tlm~();
String ~-tCl-arO~-rator();
boolean g~tCl-ar9tat-();
String g tCl~arT~xt();
Date g-tCl~arTim~();
String g~tDl~-vlayO-v~rator();
boolean ~otDlaplayStat~();
String g~tDls-vlayT~xt();
Date g~tDlsvl~yTlm~();
Date ~t~vontT~m~();
int ~tEv~nt~y~
AlarmRecordId ~tLogR~cordId();
Date g-tLoggln~Tlm~();
String g-tM~n~g-dOb~ct~-tanc-();
EMSeverity ~-tP~rc-l~ v rlty();
String g~tProbabl~Caus~();
EMTopoNodeDn[] g~t.ov~t7O~Dn~();
String toStr~n~();
}

Table l Table 1 is a listing of the public methods available to retum data values from fields in the AlarmRecord. An exception occurs if an attempt is made to return a field that was not cornmunicated to the client. In a preferred embodiment, the locality of each of these methods is on the client. The "String", "boolean", and "Date" types are well known Java data types.

10 The AlarmRecordId type is an opaque object and EMSeverityis an instance of an object enumerated type that includes five values (critical,major,minor,warning and indeterminate),EMTopoNodeDnis an object that uniquely identifies a topology object.

The following describes the function of the public methods in the AlarmRecord.

CA 022~l484 l998-l0-22 Page:21 ~ getAckOperator()--This method returns a string that identifies the network ~lminictrator (a user) who acknowledged the alarm.

~ getAckState()--This method retums a boolean that indic~t~s whether the alarm has been acknowledged.
~ getAckText()--This method returns a string that contains the user's message relating to the acknowledgment of the alarm.
~ getAckTime()--This method returns the date and time when the user acknowledged the alann.
~ getClearOperator() - This method returns a stnng that identifies the user who cleared the alarm.
~ getClearState()--This method returns a boolean that indicates whether the alarm has been cleared.
~ getClearText()--This method returns the text saved by the user who cleared the alarm relating to the clearing of the alarm.
16 ~ getClearTime() - This method returns the date and time when the user cleared the alarrn.
~ getDisplayOperator() - This method returns a string that identifies the user who added a co~ nt string to the alarm.
~ getDisplayState()--This method returns a boolean that indicates whether a user has added a comment string to the alarm.
~ getDisplayText()--This method returns the cornment string that was added to the alarm.
~ getDisplayTime() - This method returns the date and time when the comment string was added to the alarrn.

P2766~Z6-002~D~C 10/21/97 CA 022~l484 l998-l0-22 Page:22 ~ getEventTime t )--This method returns the date and time that the event occurred.
~ getEventType ( )--This method identifies the alarm type. The alarm type indicates the type of the alarm. The alarm type indicates, without limitation, that the alarm is associated with the internet, communi~ion, nerve center, quality ofservice, reoccurring error, equipment, or environment.
~ getLogRecordId ( )--This method returns a unique AlarrnRecordId identifier for this alarm record.
~ get LoggingTime ( )--This method returns the date and time that the event was actually logged in the MIS.
~ getManagedOb; ec tIns tance ( )--This method retums a string that is the fully distinguished name of the device that caused the alarm.
~ getPerceivedSeverity ( )--This method returns the severity of the event.
The severity values are defined in EMSeverity.
~ getProbab1eCause ( )--This method returns a string that indicates the probable cause of the alarm. The probable cause strings are free-form text inputby the network adminictrator.
~ getTopoNodeDns ( )--This method retums an array of EMTopoNodeDn that contain the unique topology identifiers for the nodes affected by this alarm.
~ toString ( )--This method returns a string that is a textual representation of the alarm record.

The AlanTILog class tshown in Table 2) provides a number of methods for obtaining inforrnation from and manipulating the alarm records within the MIS. In general. the locality P2766~26-0023/O~C 10/21/97 Page: 23 of these methods are in the server (the exceptions are indicated). These methods are subsequently described.
~ void clearAlarms (AlarmRecordId[]) - This method clears the alarms specified in the AlarmRecordId array.
s ~ void deleteAlarms (AlarmRecordId[]) - This method deletes the alarms specified in the AlarmRecordId array.

~ void acknowledgeAlarms (AlarmRecordId[]) - This method acknowledges the alarms specified in the AlarmRecordId array.

~ AlarmRecord[] getAlarms (AlarmRecordAttributeSet attrs) --This method returns an AlarmRecord array that contains all alarms from the ~vlIS. Each alarm contains only the alarm information specified by the "attrs"
argument.

CA 022~1484 1998-10-22 Page:24 public class AlarmLo~ ( Alar~Lo~ ~Platform platform);
void clearAlarmJ (AlarmRecordId[]);
void d-l-t~ r~ (AlarmRecordId[]);
void ac~nowlodg~alarms (AlarmRecordId[]);
AlarmRecord[] gotAlarmJ (AlarmRecordAttributeSet attrs);
AlarmRecord[~ gotAlarmJ (AlarmRecordId[] alarmRecordIds, AlarmRecordAttributeSet attrs);
AlarmRecord[] gotAlarmJ (EMSeverity severity, AlarmRecordAttributeSet attrs);
AlarmRecord[] ~otAl~rms (String deviceFDN, AlarmRecordAttributeSet attrs);
AlarmRecord[] gotAlar3J (EMTopoNodeDn deviceTopoNodeDn, AlarmRecordAttributeSet attrs);
AlarmRecord[] ~otAl~rms (String deviceFDN, EMSeverity severity, AlarmRecordAttributeSet attrs);
AlarmRecord[] ~otAlarmJ (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity, AlarmRecordAttributeSet attrs);
AlarmRecord[] gotAlar~sRocursl~o ( - EMTopoNodeDn deviceTopoNodeDn, AlarmRecordAttributeSet attrs);
AlarmRecord[] ~ot~l~ ecursl~o ( EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity, AlarmRecordAttributeSet attrs);
int ~otAlarsCount (String deviceFDN, EMSeverity severity);
int ~otAlarmCount (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity);
int ~otAlarmCount (String deviceFDN);
int ~otAlarmCount (EMTopoNodeDn deviceTopo,~odeDn);
int ~otAlarmCount (EMSeverity severity);
int ~otAlarmCountRocurslvo ~EMTopoNodeDn deviceTopoNodeDn);
int ~o~ CountRocur-lvo (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity);
int[] ~o~ ~suntR-curJl~o (EMTopoNodeDn deviceTopoNodeDn, EMSeverity[] severity);
void sotDls~layToxt (AlarmRecordId id, String displayText);
void addAlarmList-n-r (AlarmLogEventListener listener, AlarmRecordAttributeSet attrs);
void L.- v~ al armLi-tonor (AlarmLogEventListener listener);
}

Table 2 ~ AlarmRecord[] getAlarms (AlarmRecordId[]
alarmRecordIds, AlarmRecordAttributeSet attrs) - This method returns an AlarmRecord array that cont~ins the alarm log records P2766A342~0023/DBC 10/21/97 , CA 022~1484 1998-10-22 __ Pag~:25 identified by the alarlrlRecordIds array. Each alarm log record contains the alarm information specified by the "attrs" argument.

~ AlarmRecord[] getAlarms (EMSeverity severity, AlarmRecordAttributeSet attrs) - This method returns an AlarrnRecord array that contains the alarm log records that have the specified severity. Each alarm log record only contains the alarm inforrnation specified by the "attrs" argument.

~ AlarmRecord[] getAlarms (String deviceFDN, AlarmRecordAttributeSet attrs) - This method returns an AlarmRecord array that contains the alarm log records for the device identified by the fully distinguished name string in the "deviceFDN" argument. Each alarm log record only contains the alarm information specified by the "attrs"
argument.

~ AlarmRecord[] getAlarms (EMTopoNodeDn deviceTopoNodeDn, AlarmRecordAttributeSet attrs) - This method returns an AlarmRecord array that contains the alarm log records for the topological node identified by the "deviceTopoNodeDn" argument. Each alarm log record only contains the alarm information specified by the "attrs" argument.

~ AlarmRecord[] getAlarms (String deviceFDN, EMSeverity severity, AlarmRecordAttributeSet attrs) - T~s method returns an AlarrnRecord array that contains the alarm log records for the specified fully distinguished device name that has a specified severity. Each alarm log record only contains the alarm infommation specified by the "attrs" argument.

~ AlarmRecord[] getAlarms (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity, AlarmRecordAttributeSet attrs) -This method retums an AlarmRecord array that contains the alarm log records for the specified topological node that have the specified severity. Each alarm log record only contains the alarm information specified by the "attrs" argument.

P2766~426-002~C 10/21/97 CA 022~l484 l998-l0-22 Page:26 ~ AlarmRecord[] getAlarmsRecursive (EMTopoNodeDn deviceTopoNodeDn, AlarmRecordAttributeSet attrs) - This method returns an AlarmRecord array that contains the alarm log records for the specified topological node and the alarm log records that are for topological nodes s that are children of the specified topological node. Each alarm log record only contains the alarm information specified by the "attrs" argument.

~ AlarmRecord[] getAlarmsRecursive (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity, AlarmRecordAttributeSet attrs) - This method returns an 0 AlarmRecord array that contains the alarm log records for the specified topological node and the alarm log records that are for topological nodes that are children of the specified topological node; and that have the specified severity. Each alarmlog record only contains the alarm information specified by the "attrs"
argument.

The following methods return information about the number of alarrns in the ~fIS.

~ int getAlarmCount (String deviceFDN, EMSeverity severity)--This method returns an integer value of the number of alarrns, of the specified severity, generated by the specified device.

~ int getAlarmCount (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity) - This method returns an integer value of the number of alarms of the specified severity from the specified topological node.
~ int getAlarmCount (String deviceFDN) - This method retums an integer value of the number of alarms from the specified device.

~ int getAlarmCount (EMTopoNodeDn deviceTopoNodeDn) - This method returns an integer value of the number of alarrns from the specified topological node.

P2766~426-002~DBC 10/21/97 .. . . . , . , _ CA 022~1484 1998-10-22 Page:27 ~ int getAlarmCount (EMSeverity severity) - This method returns an integer value of the number of alarms having a specified severity.

~ int getAlarmCountRecursive (EMTopo~odeDn deviceTopoNodeDn)--This method returns an integer value of the number of s alarms related to a specified topological node including the topological nodes that are children of the specified topological node.

~ int getAlarmCountRecursive (EMTopoNodeDn deviceTopoNodeDn, EMSeverity severity) - Thismethodreturns an integer value of the number of alarms related to a specified topological node0 including the topological nodes that are children of the specified topological node that have the specified severity.

~ int[] getAlarmCountRecursive (EMTopoNodeDn deviceTopoNodeDn, EMSeverity[] severity) - T~s method returns an array of integer values each being the number of alarms related to the ls specified topological node including the topological nodes that are children of the specified topological node that have the severities specified by the array of specified severities.

The following methods are used to perform miscellaneous functions.
2~ ~ void setDisplayText (AlarmRecordId id, String displayText)--This method saves the displayText string into the record identified by id. This allows an operator to store a textual cornment in the alarrn record for retrieval by others.
~ void addAlarmListener (AlarmLogEventListener listener, AlarmRecordAttributeSet attrs) - This method registers a method as an alarm listener with the MIS so that the MIS will send alarm objects to the registered method. The locality of this method is at the client.

P27~2~002~0~C 10~1/97 .

CA 022~l484 l998-l0-22 Page:28 ~ void removeAlarmListener (AlarmLogEventListener listener) --This method removes the previously registered alarm listener from the list of registered listeners. The locality of this method is at the client.
The AlarmLogEventListener class (Table 3) provides call-back methods 5 responsive to particular events in the MIS.

public abstract class Alar2Lo~v- tLl~t-n-r ( void al- ~-cordCr-at-d (AlarmLogEvent event);
void ~ cordD~l-t~d (AlarmLogEvent event);
void al~m~-~ordModl~l-d (AlarmLogEvent event);
Table 3 ~ alarmRecordCreated (AlarmLogEvent event) - This call-back method is invoked on a registered alarm listener when a new alarm record is created in the MIS. The event argument is an object that provides access to the newly created alarm record.
~ alarmRecordDeleted (AlarmLogEvent event) - This call-back method is invoked on a registered alarm listener when an existing alarm record is deleted in the h~S. The event argument is an object that identifies the deleted alarm record.
~ alarmRecordModified (AlarmLogEvent event) - This call-back method is invoked on a registered alarm listener when an existing alarrn record is modified in the MIS. The event ar~ nt is an object that provides access to the modified alarrn record.
The AlarmLogEvent class (shown in Table 4) obtains information relating to MIS
events. The locality of these method is at the client.

P2766~26-0023/D~C 10l21/97 CA 0225l484 l998-l0-22 , Page:29 public class Al- To~v-~t implements java.lo. Serializable {
public static final int O~JECT_CR~AT~D = 1 public static final int 08JECT_D~T~D = 2 public static final int ATTR_VALUE_r~ n = 3 public static final int srAr~-ruat~n = 4 public static final int RELA~IONgHIP_~-~Q~n = 5 int ~e~E~-nt~y~
AlarmRecord ~-tAl~rmR-cord();
AlarmRecordId ~-tAl- R~c~rdId();
Table 4 ~ int getEventType()--This method retums an integer that classifies the retumed event by retuming one of the above defined values (OBJECT_CREATED, OBJECT_DELETED,ATTR_VALUE_CHANGED,STATE_CHANGED, RELATIONSHIP_CHANGED).
~ int getAlarmRecord() - This method retums the AlarmRecord that was created or modified.
~ int getAlarmRecordId() - This method returns the AlarmRecordId for the AlarmRecord that was created, deleted, or modifi~d.
From the foregoing, it will be appreciated that the invention has (without limitation) the following advantages:
1. The invention provides an API that interfaces to a networked MIS.
2. The invention limits the amount of data that is sent from the server to the client by allowing the programmer to specify attributes-of-interest.

3. The invention locates recursive and other compute or I/O intensive operationsat the server thus limiting the processing impact on the client and limiting the data flow over the client/server communication mechanism.

4. The invention provides a IAVA API that accesses a non-lAVA MIS.

P2766~426-0023/D8C lO/21/97 CA 022~1484 1998-10-22 Page:30 Although the present invention has been described in terms of the presently preferred embodiments, one skilled in the art will understand that various modifications and alterations may be made without departing from the scope of the invention. Accordingly, the scope of the invention is not to be limited to the particular invention embodiments discussed herein, 5 but should be defined only by the appended claims and equivalents thereof.

P2766/3426-0023/DE~C 10/21/97

Claims (21)

Page: 31 Claims What is claimed is:

1. A computer controlled method for providing a client application with access to a management information service (MIS) provided by a server, said MIS
containing data about a monitored condition in a network, and said method comprising steps of:
(a) instantiating, by said client application, an application programmer interface (API) comprising a logical object;
(b) invoking a programmed-method of said logical object by said client application;
and (c) executing said programmed-method at said server to access said MIS.

2. The computer controlled method of claim 1 wherein said monitored condition is a status of a monitored device.

3. The computer controlled method of claim 1 wherein said monitored condition is a status of a topological node.

4. The computer controlled method of claim 1 further comprising:
(d) returning said data to said client application after execution of said programmed-method.

5. The computer controlled method of claim 4 wherein said data comprises a plurality of attributes, and step (d) further comprises steps of:
(d1) specifying an attribute of interest of said data; and (d2) returning said attribute of interest to said client application after execution of said programmed-method.

Page: 32

6. The computer controlled method of claim 4 further comprising:
(e) presenting said data to a user of said client application.

7. The computer controlled method of claim 1 wherein step(c) further comprises recursively executing said programmed-method on a child node of a specified topological node.

8. An apparatus having a central processing unit (CPU) and a memory coupled to said CPU for providing a client application with access to a management information service (MIS) provided by a server, said MIS containing data about a monitored condition in a network, said apparatus comprises:
an instantiation mechanism configured to instantiate, responsive to said client application, an application programmer interface (API) comprising a logical object;
a method invocation mechanism configured to invoke a programmed-method of said logical object by said client application; and an execution mechanism configured to execute said programmed-method at said server to access said MIS.

9. The apparatus of claim 8 wherein said monitored condition is a status of a monitored device.

10. The apparatus of claim 8 wherein said monitored condition is a status of a topological node.

11. The apparatus of claim 8 further comprising:
a data return mechanism configured to return said data to said client application after execution of said programmed-method at said server.

Page: 33

12. The apparatus of claim 11 wherein said data comprises a plurality of attributes, and step (d) further comprises steps of:
an attribute specification mechanism configured to specify an attribute of interest of said data; and an attribute return mechanism configured to return said attribute of interest to said client application after execution of said programmed-method.

13. The computer controlled method of claim 8 wherein the execution mechanism further comprises a recursive mechanism configured to recursively execute said programmed-method on a child node of a specified topological node.

14. The apparatus of claim 11 further comprising:
a data presentation mechanism configured to present said data to a user of said client application.

Page: 34

15. A computer program product comprising:
a computer usable storage medium having computer readable code embodied therein for causing a computer to provide a client application with access to a management information service (MIS) provided by a server, said MIS
containing data about a monitored condition in a network, said computer readable code comprising:
computer readable program code configured to cause said computer to effect an instantiation mechanism configured to instantiate, responsive to said client application, an application programmer interface (API) comprising a logical object;
computer readable program code configured to cause said computer to effect a method invocation mechanism configured to invoke a programmed-method of said logical object by said client application; and computer readable program code configured to cause said computer to effect an execution mechanism configured to execute said programmed-method at said server to access said MIS.

16. The computer program product of claim 15 wherein said monitored condition is a status of a monitored device.

17. The computer program product of claim 15 wherein said monitored condition is a status of a topological node.

18. The computer program product of claim 15 further comprising:
computer readable program code configured to cause said computer to effect a data return mechanism configured to return said data to said client application after execution of said programmed-method at said server.

Page: 35

19. The computer program product of claim 18 wherein said data comprises a plurality of attributes, and step (d) further comprises steps of:
computer readable program code configured to cause said computer to effect an attribute specification mechanism configured to specify an attribute of interest of said data; and computer readable program code configured to cause said computer to effect an attribute return mechanism configured to return said attribute of interest tosaid client application after execution of said programmed-method.

20. The computer program product of claim 18 further comprising:

computer readable program code configured to cause said computer to effect a data presentation mechanism configured to present said data to a user of said client application.

21. The computer controlled method of claim 15 wherein the execution mechanism further comprises computer readable program code configured to cause said computer to effect a recursive mechanism configured to recursively execute said programmed-method on a child node of a specified topological node.