Configuring the Adapter for IMS

In this section:

xThis section describes configuration steps and parameters for the Adapter for IMS in the DBCTL and XMI Server environments.


Top of page

x
Configuring the Adapter for IMS in the DBCTL Environment

How to:

Reference:

You can configure the Adapter for IMS DBCTL from the Web Console or the Data Management Console.



x
Procedure: How to Configure the Adapter

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.

Note: Restart the server so the connection to DBCTL can be initialized.



x
Reference: Connection Attributes for IMS DBCTL

The IMS Adapter in under the DBMS group folder.

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

IMS Sec

ON activates DBCTL security. This setting requires that the server be in authorized mode.

OFF does not implement DBCTL security.

IMS DBCTL

START.

IMS RECONNECT

The adapter uses the IMS DBCTL environment to connect to IMS databases. Reconnection to DBCTL is now handled automatically using the IMS RECONNECT parameter.

The default reconnection time interval is 2 minutes. However, if an ABEND occurs during an IMS shut down, you must increase the reconnection time interval.

Note: For best results, we strongly recommend that you use the IMS /CHECKPOINT FREEZE command as your mechanism for shutting IMS down.

If this parameter is set to 0, reconnection works as in previous releases, without automatic restart. In this case, you must restart the server to establish the connection to DBCTL.

IMS Class

Points to a valid class that contains the security rule. The Systems Administrator can define any class name required by the security implementation of the site. The default value is PCICSPSB.

IMS PZP

The suffix of the IBM/IMS DFSPZP module that is created during the IMS/DBCTL installation process. For more information, see Assembling and Linking the DRA Startup Table in How to Create the DRA Startup Table: DFSPZPxx.


Top of page

x
Configuring the Adapter for IMS in the XMI Server Environment

In this section:

How to:

Reference:

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



x
Procedure: How to Configure the Adapter

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 XMI

The IMS Adapter in under the DBMS group folder.

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

Port

Enter the port number on which the XMI server will be listening.

Host

Enter the name or address of the host machine on which the XMI server is running.



x
Syntax: How to Configure the Communication (ODIN) File for the IMS XMI Server

The XMI Server requires a communication file to specify the TCP/IP port that it will listen on. This file is allocated to the EDACS3 DDNAME in the sample JCL files IIMSBMP or IIMSDLI. The member named XMIODIN must be created in a PDS library and have the following contents:

NODE=IMSXMI 
BEGIN
 PROTOCOL=TCP
 CLASS=SUSERVER
 PORT=nnnn 
END

where:

nnnn

Is the TCP/IP port selected for the XMI Server job. It must match the port number selected on the Web Console or DMC when the IMS XMI Adapter was configured.



x
Runtime Requirements in the XMI Server Environment

To invoke a WebFOCUS request or SQL query in the XMI Server environment, you must issue a USE command in any supported server profile or user-written procedure. The syntax is

USE mfdname ON XMIIMS1 
END

where:

mfdname

Is the name of the Master File used in the request.

XMIIMS1

Is the client node in the ODIN file of the Reporting Server.


WebFOCUS