Configuring the Adapter for IMS Transactions

In this section:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.


Top of page

x
Declaring Connection Attributes

In order to connect to IMS Transactions, the adapter requires connection and authentication information. You supply this information using the SET CONNECTION_ATTRIBUTES command. You can:

You can declare connections to more than one data source by including multiple SET CONNECTION_ATTRIBUTES commands. The actual connection to IMS Transactions takes place when the first query that references that connection is issued. If you issue multiple SET CONNECTION_ATTRIBUTES commands:

For detailed instructions about declaring connection attributes for your operating system, see Configuring the Adapter on Windows and UNIX or Configuring the Adapter on z/OS.


Top of page

x
Configuring the Adapter on Windows and UNIX

How to:

Reference:

The Adapter for IMS Transactions must be configured in order to gain access to IMS programs, create metadata and build the repository. The HWS command viewers can provide some of the information required for configuration. The setup information becomes the content of the of the Adapter for IMS Transactions communications nodes.

To configure the Application Adapter Server for IMS access, perform these steps:

  1. Configure the Adapter for TCP/IP on Windows or UNIX.
  2. Create Synonyms.

Before you begin this configuration process, you must start the Web Console.



x
Procedure: How to Declare Connection Attributes on Windows and UNIX

You can configure the adapter from the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters.

    or

    From the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the connection attributes reference.
  6. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.


x
Reference: Connection Attributes for IMS Transactions on Windows and UNIX

The IMS Transaction adapter is under the Procedures group folder.

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

CONNECTION NAME

1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.

HOST

DNS name of the host LPAR of the target IMS region. You can also code the four part IP address.

PORT

Port number on which the IMS Connect is listening. This value may be obtained from viewhws. See Output From Viewhws .

DATASTORE

ID of the IMS region that provides the transaction processing. This value may be obtained from viewhws. See Output From Viewhws .

RACF GROUP

RACF Group for the user (when OTMA security is not none.)

SECURITY

There are two methods by which a user can be authenticated when connecting to an IMS Application:

  • Explicit. If you require all connected users to connect to IMS using the same security profile, select Explicit and provide a User ID and Password.
  • Password Passthru. If Password Passthru is selected, the user ID and password sent from the client application will be used to connect to IMS.

If Explicit security is selected, two additional input fields are shown for User and Password. Enter values that are valid for logging on to IMS.

For more information about available security models, see Security on Microsoft Windows and UNIX .

User

A user ID that is valid for an IMS logon.

Password

The password associated with the user ID above.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).



x
Syntax: How to Declare Connection Attributes Manually on Windows and UNIX
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES connection /,: "HOST dns_name
 COM PORT port DATASTORE IMS_region RACFGROUP RACF_Group"

where:

IMSTRAN

Indicates the adapter.

connection

1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.

dns_name

DNS name of the host LPAR of the target IMS region. You can also code the four part IP address.

port

Port number on which the IMS Connect is listening. This value may be obtained from viewhws.

IMS_region

ID of the IMS region that provides the transaction processing. This value may be obtained from viewhws.

RACF_Group

RACF Group for the user.

For information about security options, see Security on Microsoft Windows and UNIX .



Example: Declaring Connection Attributes
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES IMS8C /,: "HOST IBIMVS.IBI.COM
 PORT 6686 DATASTORE IMS8C RACFGROUP EDA"


Example: Output From Viewhws
IEE600I        REPLY TO 01 IS;VIEWHWS
HWSC0001I      HWS ID=HWSB Racf=N
HWSC0001I      Maxsoc=2000 Timeout=8888 23
HWSC0000I      *IMS CONNECT READY* HWSB
HWSC0001I      Datastore=IMS7B Status=ACTIVE
HWSC0001I          Group=IMSGRP7B Memb
HWSC0001I      Datastore=IMS6A Status=ACTIVE
HWSC0001I          Group=IMSGRP6A Member=HWSMEM6A
HWSC0001I          Target Member=TMEM6A
HWSC0001I      Datastore=IMS7A Status=NOT ACTIVE
HWSC0001I          Group=IMSGRP7A Member=HWSMEM7A
HWSC0001I          Target Member=TMEM7A
HWSC0001I          Port=6685 Status=ACTIVE
HWSC0001I          No active Clients


x
Reference: Security on Microsoft Windows and UNIX

If the adapter is deployed on Microsoft Windows or UNIX, starting the server without security is recommended. The client application should provide the User ID and Password to be used for the connection to IMS. This User ID and Password is passed through to IMS for validation. The server does not validate the User ID and Password with the operating system.

If the Explicit option is selected and security information is entered in the adapter configuration window, it overrides this security mode and a single User ID and Password are used for all connected users.

If the adapter is started with security, and Password Passthru is selected, the local security profiles must be synchronized with those of the IMS platform, thereby creating additional security maintenance overhead.


Top of page

x
Configuring the Adapter on z/OS

How to:

Reference:

Configuring the adapter consists of specifying connection and authentication information for each connection on z/OS.



x
Procedure: How to Declare Connection Attributes on z/OS

You can configure the adapter from either the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters.

    or

    From the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the connection attributes reference.
  6. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.


x
Reference: Connection Attributes for IMS Transactions on z/OS

The IMS Transaction adapter is under the Procedures group folder.

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

CONNECTION NAME

1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.

XCF Member

Target member name. This value may be obtained from /DIS OTMA. See Output From /DIS OTMA .

XCF Member Group

Target member group name. This value may be obtained from /DIS OTMA. See Output From /DIS OTMA .

XCF User ID

User ID.

RACF Group

RACF group.

SECURITY

There are two methods by which a user can be authenticated when connecting to an IMS Application:

  • Explicit. If you require all connected users to connect to IMS using the same security profile, select Explicit and provide a User ID and Password.
  • Password Passthru. If Password Passthru is selected, the user ID and password sent from the client application will be used to connect to IMS.

If Explicit security is selected, two additional input fields are shown for User and Password. Enter values that are valid for logging on to IMS.

For more information about available security models, see Security on z/OS.

User

Is a user ID that is valid for an IMS logon.

Password

Is the password associated with the user ID above.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).



Example: Output From /DIS OTMA
R 20,/DIS OTMA
IEE600I REPLY TO 20 IS;/DIS OTMA
DFS000I     GROUP/MEMBER      XCF-STATUS   USER-STATUS    SECURITY
IM8C
DFS000I     IMSGRP8C
IM8C
DFS000I     -TMEM8C           ACTIVE       SERVER         NONE
IM8C
DFS000I     -HWSMEM8C         ACTIVE       ACCEPT TRAFFIC
IM8C


x
Syntax: How to Declare Connection Attributes Manually on z/OS
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES connection /,: "XCFMEMB
 target_member_name XCFGROUP target_member_group_name XCFUSMEMB userid 
 RACFGROUP racf_group"

where:

connection

1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.

target_member_name

Name of the target member. This value may be obtained from /DIS OTMA.

target_member_group_name

Name of the target member group. This value may be obtained from /DIS OTMA.

userid

User ID.

racf_group

RACF group.

For information about security options, see Security on z/OS.



Example: Declaring Connections Attributes on z/OS
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES IMS8C /,: "XCFMEMB TMEM8C
  XCFGROUP IMSGRP8C XCFUSMEMB EDAERH RACFGROUP EDA"


x
Reference: Security on z/OS

If the adapter is deployed on z/OS, you must start the server with security turned on (the default).

The client application must provide a valid User ID and Password that is authenticated by the Adapter for IMS Transactions with calls to security packages (RACF, ACF2 and Top Secret). If the User ID and Password are valid, the subsequent connection to IMS is Trusted.


iWay Software