OEM User's Guide

OEM External Specification
OEM User’s Guide—520330-001
A-10
OEM Request API (Client Application to OEM)
In this example, the popup menu item Disk Performance is removed for all DISK
entities.
Popup.Cleanup
Use Popup.Cleanup to remove all popup menus for a given client name. This is
particularly useful when a client application is shutting down and all popups associated
with it must be removed from the OEM Gateway and EM framework.
Parameters
ClientName (input)
is a client-defined name used to identify the owner of the popups. For most clients,
this can simply be the application name. However, more complex clients might need
to use more than one ClientName and CallbackObject to localize processing
for different types of commands (for example, one ClientName and
CallbackObject for DISK commands and another for CPU commands).
Return Value
•
0 if the request was queued successfully
•
An OEM error number if an error occurred
Considerations
For a client application to remove any popup menus, it must first have added them using
the Popup.Add method.
If a client application is using multiple ClientNames, it should call Popup.Cleanup for
each of these names when shutting down.
Example
Dim OEM As New OEMClass
Dim RC As Integer
RC = OEM.Popup.Cleanup('MyClientName')
In this example, all popup menu items associated with “MyClientName” are removed.
Function Popup.Cleanup(ClientName As String) As Integer