CTL (IMS control region), contains control information, SSM (subsystem member), IMS.PROCLIB library, IMSID option" /> Initializing the adapter and connecting to the queue manager

 

Initializing the adapter and connecting to the queue manager

The adapter is a set of modules loaded into the IMS control and dependent regions, using the IMS external subsystem attach facility.

This procedure initializes the adapter and connects to the queue manager:

  1. Read the subsystem member (SSM) from IMS.PROCLIB. The SSM chosen is an IMS EXEC parameter. There is one entry in the member for each queue manager to which IMS can connect. Each entry contains control information about a WebSphere MQ adapter.

  2. Load the IMS adapter.
    Note:
    IMS loads one copy of the adapter modules for each WebSphere MQ instance that is defined in the SSM member.

  3. Attach the external subsystem task for WebSphere MQ.

  4. Run the adapter with the CTL EXEC parameter (IMSID) as the connection name.

The process is the same whether the connection is part of initialization or a result of the IMS command /START SUBSYS.

If the queue manager is active when IMS tries to make the connection, the following messages are sent:

When IMS tries to make the connection and the queue manager is not active, the following messages are sent to the IMS master terminal each time an application makes an MQI call: 

CSQQ001I IMS/TM imsid not connected to queue manager ssnm.
         Notify message accepted
DFS3607I  MQM1     SUBSYSTEM  ID  EXIT FAILURE, FC = 0286, RC = 08,
JOBNAME = IMSEMPR1

If you get DFS3607I messages when you start the connection to IMS or on system startup, this indicates that the queue manager is not available. To prevent a large numbers of messages being generated, do one of the following:

  1. Start the relevant queue manager.

  2. Issue the IMS command: 

    /STOP SUBSYS
    so that IMS does not expect to connect to the queue manager.

If you do neither, a DFS2607I message and the associated CSQQ001I message are issued each time a job is scheduled in the region and each time a connection request to the queue manager is made by an application.