Instruction Manual

OEM External Specification
OEM User’s Guide—520330-001
A-43
Adapter Request API (OEM to Adapter)
Object.Delete
Use the Object.Delete is used to remove objects from the EM Framework. Remove
multiple objects as part of a single operation by blocking them together. Although the
OEM Server reports objects at level n, the framework itself could report at a higher
level. In these cases, the adapter and framework determine whether the higher level
objects should be removed from the framework. In most cases, this decision is based on
whether all subordinate objects have been removed.
Parameters
Path (input)
is the full path of all objects included in ObjectNames; for example \NewYork. If
this value is not “”, it is prefixed to each item contained in the ObjectNames list.
This simplifies building the ObjectNames list for the OEM Server in cases where
a large number of objects are to be deleted.
ObjectNames (input)
is a comma-separated list of all objects to be deleted. The standard ObjectNames
format is supported:
ObjectName[:State] [,ObjectName[:State], …]
But the State values are ignored for delete operations.
Return Value
•
0 if the request was accepted by the adapter
•
Non-zero if the adapter cannot service the request
Considerations
Delete requests from client applications first pass through the OEM Server. Once all
references to a particular object have been removed, the OEM Server generates a delete
request for that object and passes it to the adapter.
Example
Dim Adapter As New EMAdapterClass
Dim RC As Integer
RC = Adapter.Object.Delete('\Chicago', 'CPU\0, CPU\1')
In this example, the Path “\Chicago” is prefixed to each object name. This causes the
objects “\Chicago\CPU\0” and “\Chicago\CPU\1” to be removed.
Function Object.Delete(Path As String, ObjectNames As String)
As Integer