Topics: |
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:
To configure a TCP/IP connection to IMS/TM:
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.
The name is used to build a repository entry as well as to identify the connection.
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.
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. |
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. |
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.
To configure a CRM gateway connection to IMS/TM:
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.
The Set connection info dialog box opens, as shown in the following image.
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:
|
Note: The following restrictions apply when using CRM gateway connections with the iWay Transaction Adapter for IMS:
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.
How to: |
You can connect to a defined IMS/TM target (for example, TCPIP_Connection) from iWay Explorer.
To connect to a defined IMS/TM target:
The Connect to TCPIP_Connection dialog box opens, populated with values you entered for the connection parameters.
The x icon disappears, indicating that the node is connected.