OEM User's Guide

OEM External Specification
OEM User’s Guide—520330-001
A-47
Adapter Request API (OEM to Adapter)
IncludeContext
Use the IncludeContext method to inform the OEM Server that it should include each
object’s context data when calling the adapter’s Object.Add method. This allows the
adapter to pass this additional information on to the enterprise management framework
so it can be displayed to users.
Parameters
None
Return Value
•
True if the adapter needs to receive context data for each object
•
False if the adapter does not need to receive context data for each object
Considerations
To maintain compatibility with earlier versions of adapters, the OEM Server assumes
that each adapter does not accept context information. If an adapter needs to receive
context as part of Object.Add calls, it must supply an IncludeContext method, and that
method must return True. If the method is not supplied or it does not return True, context
is not included by the OEM.
The IncludeContext value is evaluated on a per-adapter basis. In environments where
more than one adapter is active, a particular adapter’s IncludeContext setting has no
impact on other adapters.
Example
Dim Adapter As New EMAdapterClass
Dim RC As Boolean
RC = Adapter.IncludeContext
If RC = True Then
' Build and send object list containing object names, states,
and context
Else
' Build and send object list containing object names and states
only
End If
Function IncludeContext() As Boolean