Airlines SDK Help Globe Icon

Using the SDK with the e-Vantage ID Manager

If you are using the e-Vantage ID Manager with either Host Access Server (HAS) or the Management and Control Services (MCS), your application can take advantage of the ID Manager's ability to provide multiple terminal or session IDs for UTS or T27 host sessions. This allows your application to open multiple host sessions simultaneously, using only one WebView (and associated connection).

Note The ID Manager is only used for connecting to 3270, 5250, UTS, or T27 host sessions, which require a unique ID; ALC and VT host sessions do not require a unique ID.

The following sections outline the steps involved in using the ID Manager with your application.

Creating IDs in the ID Manager

To use the ID Manager with your custom application, you must first complete the following tasks within the ID Manager:

Enabling ID Manager in the HAS Configuration

Once you have created IDs and assigned them to an Address Pool or User in the ID Manager, you must create a configuration in HAS Management, specifying the following:

Configuring ID Usage within the SessionLoader Object

The SDK's SessionLoader object provides two methods that you may need to use if you are obtaining terminal or session IDs for your application from the ID Manager:

This method
Does this
setResourceManagerOptions Allows you to specify the initial number of IDs that are allocated to the application from the ID Manager, as well as the increment in which additional IDs will be obtained when all allocated IDs are already in use. If you do not use this method to specify these values, the default values of 5 (initial reserve) and 5 (reserve increment) are used.
Note This method also has a third parameter rsa which is not currently used, and should be set to an empty string ("").
In addition to allowing you to request a larger number of IDs, you can also use this method to limit the number of IDs in use. For example, if your application requires only one ID, you can use this method to specify an initial reserve of 1, with a reserve increment of 1.
Shutdown Ensures that all IDs defined with a Lease Timeout (from e-Vantage ID Manager) are properly retained by the SDK for future use, once your application no longer requires them. (IDs that do not have a Lease Timeout defined are freed automatically when the application closes.) You must call this method when your application terminates if you are using leased IDs.
Caution If the IDs have a Lease Timeout value defined, you must call this method when your application terminates. Failure to do so may cause these IDs to become unusable by your application or by e-Vantage ID Manager.

For more detail about using these SessionLoader methods, see Establishing a Host Connection.

Related Topics
Defining a Configuration and WebView