Remote Environment Selection with the SelectionHint Property

  • Article

Developers can use the SelectionHint property to specify a remote environment (RE) programmatically.

By setting the SelectionHint property, applications can specify which CICS or IMS RE should be used when servicing Transaction Integrator (TI) requests. The algorithm used by an application in selecting an RE is determined by the application code. For example, a business enterprise can use separate CICS or IMS regions when handling requests from different branches. In this case, the application chooses the RE that identifies the region suitable for the current branch.

To specify an RE in an application, set the SelectionHint property to the name of the RE you want to use. TI Designer automatically adds the write-only SelectionHint property to each TI component.

Before you can use the SelectionHint property to specify a remote environment (RE) programmatically, the following must be in place:

  • Host Integration Server must be installed on all computers running the TI run-time environment or TI Designer.

  • The TI component must be assigned to an RE even though RE selection is in use. The RE assigned to the component is used when an application that has a TI component does not explicitly set the SelectionHint property.

    To assign a TI component to an RE, use TI Manager and follow the instructions provided in the TI online Help.

In This Section

Remote Environment Selection Guidelines

Writing Code that Specifies a Remote Environment

Cost of Remote Environment Selection