In this section: |
Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.
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.
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:
Before you begin this configuration process, you must start the Web Console.
You can configure the adapter from the Web Console or the Data Management Console.
or
From the Data Management Console, expand the Adapters folder.
The Adapters folder opens.
The Add Adapter to Configuration pane opens.
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.
1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.
DNS name of the host LPAR of the target IMS region. You can also code the four part IP address.
Port number on which the IMS Connect is listening. This value may be obtained from viewhws. See Output From Viewhws .
ID of the IMS region that provides the transaction processing. This value may be obtained from viewhws. See Output From Viewhws .
RACF Group for the user (when OTMA security is not none.)
There are two methods by which a user can be authenticated when connecting to an IMS Application:
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 .
A user ID that is valid for an IMS logon.
The password associated with the user ID above.
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).
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES connection /,: "HOST dns_name COM PORT port DATASTORE IMS_region RACFGROUP RACF_Group"
where:
Indicates the adapter.
1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.
DNS name of the host LPAR of the target IMS region. You can also code the four part IP address.
Port number on which the IMS Connect is listening. This value may be obtained from viewhws.
ID of the IMS region that provides the transaction processing. This value may be obtained from viewhws.
RACF Group for the user.
For information about security options, see Security on Microsoft Windows and UNIX .
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES IMS8C /,: "HOST IBIMVS.IBI.COM PORT 6686 DATASTORE IMS8C RACFGROUP EDA"
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
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.
How to: Reference: |
Configuring the adapter consists of specifying connection and authentication information for each connection on z/OS.
You can configure the adapter from either the Web Console or the Data Management Console.
or
From the Data Management Console, expand the Adapters folder.
The Adapters folder opens.
The Add Adapter to Configuration pane opens.
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.
1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.
Target member name. This value may be obtained from /DIS OTMA. See Output From /DIS OTMA .
Target member group name. This value may be obtained from /DIS OTMA. See Output From /DIS OTMA .
User ID.
RACF group.
There are two methods by which a user can be authenticated when connecting to an IMS Application:
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.
Is a user ID that is valid for an IMS logon.
Is the password associated with the user ID above.
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).
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
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES connection /,: "XCFMEMB target_member_name XCFGROUP target_member_group_name XCFUSMEMB userid RACFGROUP racf_group"
where:
1-8 character logical name. Select a name that reflects the IMS region you are configuring the connection for.
Name of the target member. This value may be obtained from /DIS OTMA.
Name of the target member group. This value may be obtained from /DIS OTMA.
User ID.
RACF group.
For information about security options, see Security on z/OS.
ENGINE IMSTRAN SET CONNECTION_ATTRIBUTES IMS8C /,: "XCFMEMB TMEM8C XCFGROUP IMSGRP8C XCFUSMEMB EDAERH RACFGROUP EDA"
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 |