Sequence of RM client requests

If you want to use RM to manage global resources in an IMSplex for your own product or service, you have to write one or more RM clients. An RM client uses RM requests issued in a particular sequence to communicate with RM.

To write an RM client, you can use the set of client requests provided by RM. These requests allow a client to access RM or resources on a resource structure, or to coordinate an IMSplex-wide process. One example of an RM client is IMS. You can write an RM client in assembler language.

An RM client uses RM requests to make use of RM services and resources. A client issues SCI and RM requests to request RM services. Some of the requests must follow a particular sequence. Other requests can be issued multiple times, in any order, based on the processing requirements of the client.

Before an RM client can issue RM requests, it must register:

To SCI
To each active RM in the IMSplex, so any RM can process an RM request
Its own resource types and associated name types to RM

The following table lists the sequence of requests issued by an RM client. The request is listed with its purpose.

Table 1. Sequence of requests for an RM client
Request	Purpose
CSLSCREG	Registers to SCI, which enables the client to send RM requests to RM through SCI.
CSLSCRDY	Readies the RM client to SCI, which routes messages to the client by client type.
CSLRMREG	Registers client to RM to enable communication with RM. The client should register to each active RM in the IMSplex, so any RM can process an RM request. The client can also register its own resource types and associated name types to RM.
CSLRMxxx	Issues RM resource requests such as CSLRMUPD, CSLRMDEL, CSLRMQRY to manipulate resources on a resource structure.
CSLRMPxx	Issues RM process requests such as CSLRMPRI, CSLRMPRS, CSLRMPRR, and CSLRMPRT to participate in an IMSplex-wide process.
CSLSCBFR	Releases the output buffer returned by the request, if any.
CSLRMDRG	Deregisters client from RM to end communications with RM.
CSLSCDRG	Deregisters from SCI.

The following table lists the sequence of requests issued by an RM client that is participating in IMSplex-wide processes. The request is listed with its purpose.

Table 2. Sequence of requests for an RM client participating in IMSplex-wide process
Request	Purpose
CSLRMPRI	Initiate an IMSplex-wide process.
CSLRMPRS	Process a step in an IMSplex-wide process. A process can have zero, one, or more process steps. The client that initiates the process step is the master of the step.
CSLRMPRR	Respond to a process step.
CSLRMPRT	Terminate an IMSplex-wide process.