Runtime services

A set of services, collectively called the ZIETrans Runtime Services, are provided as an interface to the ZIETrans runtime, ZIETrans rich client applications, and running application instances. Using this set of provided APIs is the recommended method of interaction with the ZIETrans runtime, since you don't need to be concerned with the underlying details.

Table 1 describes the types of services provided. There is only one instance of the runtime service and client service per Eclipse environment, but there can be multiple instances of the application service (since multiple ZIETrans rich client applications can be installed into an Eclipse environment) and the session service (since a user can start multiple sessions, or application instances).

Table 1. Provided services
Service	Description	Scope
Runtime	Provides runtime-related services, such as runtime initialization, creating new client sessions, providing access to the connection manager and application manager classes.	One per Eclipse environment.
Application	Provides interface for retrieving information about the ZIETrans rich client application.	One per ZIETrans rich client plug-in application.
Client	Provides interface for retrieving information about a client or user.	One per Eclipse environment.
Session	Provides interface for interacting with ZIETrans runtime on behalf of a particular application instance / host connection.	One per running application instance.

Note: Service classes should not be extended.

Note: For code examples in the following sections, the following imports might be needed:

import java.util.Collection; import java.util.Iterator;  
import com.ibm.hats.rcp.runtime.RcpRuntimePlugin;
import com.ibm.hats.runtime.services.IApplicationService; 
import com.ibm.hats.runtime.services.IClientService;
import com.ibm.hats.runtime.services.IRuntimeService; 
import com.ibm.hats.runtime.services.IServiceManager;
import com.ibm.hats.runtime.services.ISessionService; 
import com.ibm.hats.runtime.services.ServiceType;