Management API

The client you create connects to SAP Mobile Server through SAP Control Center and SAP Unified Agent.

For example, as this illustration shows, connections are established using an AgentContext and a ServerContext:

Establishing Connections Using AgentContext and ServerContext

You do not need to create an instance of AgentContext. If none is defined, a default one is created by the ServerContext using its host value and default agent port (9999).

• Contexts
  A context is a lightweight, immutable object that is used to retrieve a specific administration interface instance. You create a connection to the SAP Mobile Server when you invoke an API (such as ping) on a supported interface (such as SUPServer), but not when context objects (such as AgentContext or ServerContext) are initialized. There is no need to maintain the states of contexts because state changes are not supported.
• Administration Interfaces
  The Management API uses several interfaces that contain operations which can be invoked by custom code to perform management of the SAP Mobile Server.
• SUPObjectFactory
  Once a context has been instantiated, pass it to a specific method of SUPObjectFactory to retrieve an administration interface. You can then start administration by calling methods of the interface.
• Metadata
  Metadata-based configuration is used by these administration components:
• Exceptions and Error Codes
  The Management API throws only one checked exception, SUPAdminException.
• Best Practices
  Observe these best practices.