Configuring the Adapter for IMS

How to:

Reference:

xThis section describes configuration steps and parameters for the Adapter for IMS in the DBCTL environment.

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

WebFOCUS

Feedback