Configuring the Adapter for IMS

Topics:

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

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.

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 sidebar, click Connect to Data.

    or

    From the Data Management Console, expand the Adapters folder.

    In the DMC, the Adapters folder opens. In the Web Console, the Adapters page opens showing your configured adapters.

  2. In the Web Console, click the New Datasource button on the menu bar and find the adapter on the drop-down list or, in the DMC, expand the Available folder if it is not already expanded.
    On the Web Console, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.
  3. In the DMC, 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 chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Adapters list in the DMC resources tree or the Configured list in the Web Console.
    In the Web Console, the adapter remains on the Available Adapters list with a check mark to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

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

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 Create the DRA Startup Table: DFSPZPxx.

Configuring the Adapter for IMS in the XMI Server Environment

Topics:

How to:

Reference:

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

Procedure: How to Configure an Adapter

  1. From the Web Console sidebar, click Connect to Data.

    or

    From the Data Management Console, expand the Adapters folder.

    In the DMC, the Adapters folder opens. In the Web Console, the Adapters page opens showing your configured adapters.

  2. In the Web Console, click the New Datasource button on the menu bar and find the adapter on the drop-down list or, in the DMC, expand the Available folder if it is not already expanded.
    On the Web Console, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.
  3. In the DMC, 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 chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Adapters list in the DMC resources tree or the Configured list in the Web Console.
    In the Web Console, the adapter remains on the Available Adapters list with a check mark to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

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.

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.

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

Feedback