OEM User's Guide

OEM External Specification
OEM User’s Guide520330-001
A-5
OEM Request API (Client Application to OEM)
OEM Request API (Client Application to OEM)
The OEM Request API defines the interface that client applications use to access the
Open Enterprise Management Gateway. The examples included in the following
descriptions are given using pseudo code similar to Visual BASIC; they might not be
syntactically correct for Visual BASIC or any other environment.
ReportingLevels
ReportingLevels returns the number of levels the OEM Server requires in the object
hierarchy. All clients must ensure that they report objects at this level. For example, if
ReportingLevels is 3, the OEM Server expects to receive objects in the form
\node\entity_type\object_name, where:
node
is a node name.
entity_type
is the type of object being reported on (for example, CPU or DISK).
object_name
is the name of the actual object.
If ReportingLevels is 1, only \node would be expected.
Parameters
None
Return Value
The number of levels in the OEM Server object hierarchy.
Considerations
All clients using the OEM must determine the supported ReportingLevels before
reporting objects to the OEM and must report only at that level.
Because ReportingLevels is user-configurable, clients should check the value before
every OEM update.
Example
Dim OEM As New OEMClass
Dim Levels As Integer
Levels = OEM.ReportingLevels
Function ReportingLevels() As Integer