Registering an RM client

Register RM clients to manage resources and access IMSplex-wide processes.

The following steps describe how to register an RM client first with the IMSPlex Structured Call Interface (SCI), and then with the RMs active in the IMSPlex.

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 RM in the IMSplex, so an RM client must registered to all RMs. A SCI Notify exit is driven when a new RM becomes active in the IMSplex and notifies the client with information about the new RM. The client can then register to the new RM. 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 RM client must be able to receive RM directives sent from any RM 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 RM.
  3. Issue the CSLSCQRY request to SCI to determine which instances of RM are active in the IMSplex.
    Before registering with the RMs for the first time, the client must manually identify all active RMs with this request. Once registered, the SCI Notify exit automatically informs the client when new RMs become active.
  4. Issue the CSLRMREG request to all RMs in the IMSplex that are reachable and ready to accept registration requests.
    To manage global resources, register the resource type and associated name type.