Configuring a Connection to IMS/TM

In this section:

How to:

To access an adapter, you must first configure a connection to that adapter. After the connection is created, it is automatically saved. You must establish a connection to the system every time you start iWay Explorer or after disconnecting.

The following target types are available when you configure a connection to IMS/TM:


Top of page

x
Procedure: How to Configure a TCP/IP Connection to IMS/TM

To configure a TCP/IP connection to IMS/TM:

  1. In the left pane of iWay Explorer, expand the iWay Adapters node.
  2. Select the IMS node.
  3. In the right pane, move your pointer over Operations and select Define a new target.

    The Add a new IMS target dialog box opens in the right pane, as shown in the following image, where you assign a name and description to the new target.

    1. In the Target Name field, type a name for the connection.

      The name is used to build a repository entry as well as to identify the connection.

    2. In the Description field, type a description for the target name you just created.
    3. From the Target Type drop-down list, select TCP/IP Communication as the type of target.
  4. Click Next.

    The connection name is verified for the system. If you entered an invalid instance name, a new Input dialog box opens and prompts you for an instance name again.

    The following image shows the Set connection info dialog box, which opens to the TCP/IP Parameters tab window and contains six entry fields. The following step describes the entries needed.

    Note: The IMS connection parameters are consistent with those found in your IMS system. For more information on parameter values that are specific to your IMS configuration, consult your IMS system administrator.

  5. Enter the TCP/IP parameters to configure a new connection to IMS/TM.

    You can obtain this information from the IMS/TM Systems Administrator. This information should be the same for all programs in a single IMS/TM system.

    The following table lists and describes the TCP/IP parameters.

    Parameter

    Description

    Host

    Host name, or IP address, for the computer where IMS/TM is running.

    Port

    Port number on which IMS Connect is listening.

    User

    Valid user ID for IMS/TM.

    Password

    Valid password associated with the IMS/TM user ID.

    IMS Datastore

    Name of the IMS/TM datastore.

    XCF Group

    Name of the XCF group.

  6. If you click the Advanced tab, the following parameters appear, as shown in the following image.

    Enter the Advanced parameters. The following table lists and describes the Advanced parameters.

    Parameter

    Description

    Override of *SAMPLE* message exit

    Specify a message exit if you want to override the sample message exit.

    Code Page of Host

    Select the codepage from the drop-down menu. Cp500 is the default value.

  7. Click Finish.

    The newly created connection, TCPIP_Connection, appears as a node under the IMS service adapter. The configuration information is stored in the repository for the configuration you defined during installation.



x
Procedure: How to Configure a CRM Gateway Connection to IMS/TM

To configure a CRM gateway connection to IMS/TM:

  1. In the left pane of iWay Explorer, expand the iWay Adapters node.
  2. Select the IMS node.
  3. In the right pane, move your pointer over Operations and select Define a new target.

    The Add a new IMS target dialog box opens in the right pane, as shown in the following image, where you assign a name and description to the new target.

    1. In the Target Name field, type a name for the connection (for example, CRM1).
    2. In the Description field, type a description for the target name you just created (for example, CRM on IBIMVS).
    3. From the Target Type drop-down list, select CRM Gateway.
  4. Click Next.

    The Set connection info dialog box opens, as shown in the following image.

  5. Enter the CRM gateway parameters to configure a new connection to IMS/TM.

    The following table lists and describes the CRM gateway parameters.

    Parameter

    Description

    CRM Host

    Host name, or IP address, for the computer where the CRM gateway is running.

    CRM Port

    Port number on which the CRM gateway is listening.

    Log Mode

    Defines the characteristics of the APPC sessions that the CRM gateway establishes across a CRM Link.

    The characteristics of different logon modes are tailored to support different types of applications. For example long-running batch applications might use different logon modes than short-lived online applications. Logon modes can define different logical unit protocols, classes of service, packet sizes, and pacing algorithms.

    Use the same logon mode for the CRM gateway logical unit and the back-end application logical unit.

    Remote LU

    LU of IMS.

    Max Sync Level

    Enter 1 to obtain non-transactional connections. Enter 2 for transactional connections.

    Maximum Sessions

    The number of maximum sessions that are allowed in the allocated pool. This value determines the number of concurrent requests that can be active at any given time. The CRM and the back-end system must configure their maximum sessions to the same value.

    Min Wins

    The CRM gateway and the back-end system are pre-allocated with a number of sessions for their use. This value is referred to as minimum winner sessions. The owner of these pre-allocated sessions has priority for its winner sessions. However, they may be reassigned depending on system load.

    The total of the minimum winner sessions for both sides must be less than or equal to the maximum session value. If the total is higher than the maximum session value, you will be unable to activate the link.

    For best results in determining minimum sessions, evaluate the number of sessions that are required for the CRM and for the back-end system to support concurrent requests.

    Default User ID

    If IDENTIFY is selected from the Security Type drop-down list, this value represents the user ID that is transmitted to the LU.

    Security Type

    The security level of a CRM Link defines what security credentials are required for all requests that utilize this link. The following options are available from the drop-down list:

    • LOCAL (No security credentials provided)

      In the simplest case, no security credentials are provided with requests sent on the link. This implies that the user has been authenticated in the originating domain, and that no further authentication is required. The value for the CRM would be LOCAL. The corresponding value for the back-end system must be defined in the connection definitions.

    • IDENTIFY (User ID is provided)

      It is possible that the application processing the request needs to identify the user making the request for access control to application resources. For this case, only a user ID is provided with the request. The value for the CRM would be IDENTIFY. The corresponding value for the back-end system must be defined in the connection definitions.

    Note: The following restrictions apply when using CRM gateway connections with the iWay Transaction Adapter for IMS:

    • The referenced CRM gateway must be configured to identify itself as CRM1. This is specified in the JCL that launches the CRM gateway.
    • Each adapter CRM gateway connection Host and Port must be unique. As a result, it is not possible to have two adapter connections to the same CRM gateway instance.
  6. Click Finish.

    The newly created connection, CRM1, appears as a node under the IMS service adapter. The configuration information is stored in the repository for the configuration you defined during installation.



x
Connecting to an IMS/TM Target

You can connect to a defined IMS/TM target (for example, TCPIP_Connection) from iWay Explorer.



x
Procedure: How to Connect to a Defined IMS/TM Target

To connect to a defined IMS/TM target:

  1. Expand the iWay Adapters node.
  2. Expand the IMS node.
  3. Click the target name (for example, TCPIP_Connection) under the IMS node.
  4. Move your pointer over Operations and select Connect.

    The Connect to TCPIP_Connection dialog box opens, populated with values you entered for the connection parameters.

  5. Verify your connection parameters. If required, provide the password and then click OK.

    The x icon disappears, indicating that the node is connected.


iWay Software