IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

Chapter 4. Configuring IMS Connect 47

4.3.4 Creating the IMS Connect configuration member

You have to create a configuration member in your PROCLIB data set for specifying the

environment for IMS Connect. IMS Connect uses the information it retrieves from the member

to establish communication with IMS and TCP/IP. You can define several configuration

members in the partition data set (PDS) to select from during the IMS Connect startup.

Specify the member name to be used in the HWSCFG= parameter of the IMS Connect

startup JCL (see Example 4-1 on page 45).

IMS Connect configuration statement parameters

You have to specify values for some of the parameters that define the way in which IMS

Connect is to communicate with TCP/IP and IMS OTMA in the IMS Connect configuration

member. The IMS Connect configuration member contains four types of configuration

statements: HWS, TCPIP, DATASTORE, and IMSPLEX. Descriptions of the configuration

statements are as follows:

 HWS

The HWS statement specifies one IMS Connect. It includes the following keyword

parameters:

–ID

The IMS Connect name. It consists of alphanumeric character data, begins with an

alphabetic character, and has a length between 1 and 8 characters.

–RACF

Y (yes), or N (no). Determines whether or not the password and user ID (provided by

either the client application or a user exit routine) are passed to RACF for

authentication.

This setting can also be changed using the IMS Connect SETRACF command.

If this is set to N, no RACF validation of the user ID is done, and the user ID (if

provided) is simply passed to IMS. If this is set to Y, IMS Connect calls RACF to

validate the user ID and password combination before passing the request through to

IMS. N is the default.

Even if the value is Y, the IMS Connect user exit can set the trusted user flag and tell

IMS Connect not to issue the RACF call.

– RRS

Y (yes), or N (no). Defines if RRS should be enabled. This enables two-phase commit.

N is the default.

–XIBAREA

Specifies the number of full words allocated for the XIB user area. Both the user

initialization exit routine and the user message exit routines can access and modify the

XIB user area.

The default value is 20; the maximum value is 500. If you do not specify value for this

parameter, or you specify a value outside of the 20 to 500 range, the system uses the

default value of 20.

Important: Performance problems might occur if RACF statistics are kept for a

user ID.