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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.