Administration Client API

The client you create connects to Unwired Server through Sybase Control Center and Sybase Unified Agent.

For example, as this illustration shows, connections are established using an AgentContext and a 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 Unwired 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 administration client API uses several interfaces that contain operations which can be invoked by custom code to perform management of the Unwired 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 administration client API throws only one checked exception, SUPAdminException.
• Best Practices
  Observe these best practices.