Registering an ODBM client

To register with ODBM, a client must first register with the CSL SCI and then with all active ODBMs in the IMSplex.

Application servers for application programs that use the IMS ODBA interface to access IMS databases can register with ODBM as a client. ODBM manages connections to databases owned by IMS DB systems in an IMSplex and protects IMS control regions from the unexpected termination of the application program.

To register an ODBM client:

Procedure

  1. Identify the exit routines that are needed to drive interactions between the CSL SCI and the client.
    The SCI handles communications between all CSL managers in the IMSplex and their client applications.
    1. Identify the SCI Notify exit for the client.
      A database connection can be routed through any active ODBM in the IMSplex, so an ODBM client must registered to all ODBMs. A SCI Notify exit is driven when a new ODBM becomes active in the IMSplex and notifies the client with information about the new ODBM. The client can then register to the new ODBM. The SCI Notify exit is identified with the NOTIFYEXIT parameter of the CSLSCREG request.
    2. Identify the SCI Input exit for the client with the INPUTEXIT parameter of the CSLSCREG request.
      An ODBM client must be able to receive ODBM directives sent from any ODBM in the IMSplex. The SCI Input exit is driven when there is a message or request for the client, so that the client can receive and process it.
  2. Issue the CSLSCREG request to SCI with the information gathered in step 1.
    A client must register to the CSL SCI in the IMSplex before it can register with a CSL manager such as ODBM.
  3. Issue the CSLSCQRY request to SCI to determine which instances of ODBM are active in the IMSplex.
    Before registering with the ODBMs for the first time, the client must manually identify all active ODBMs with this request. Once registered, the SCI Notify exit automatically informs the client when new ODBMs become active.
  4. Issue the CSLDMREG request to all ODBMs in the IMSplex that are reachable and ready to accept registration requests.
Consult the sequence of ODBM client requests for more information about managing the CSL registrations for an ODBM client.