z/OS MVS Programming: Resource Recovery
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Protecting distributed resources

z/OS MVS Programming: Resource Recovery
SA23-1395-00

Using the peer-to-peer (DSRM) model for distributed resource recovery, an application's work request across distributed systems is connected by Systems Network Architecture (SNA) LU 6.2 conversations handled by a communications manager such as APPC/MVS. Each work request has a logical unit of work identifier (LUWID).

When the first protected conversation is allocated for a work request, RRS generates an LUWID for it. The resource manager handling the outbound protected conversation uses a call to the Retrieve_Work_Identifier service to obtain the LUWID and passes the LUWID in the conversation. When the application accepts an inbound protected conversation, the resource manager handling it uses a call to the Set_Work_Identifier service to set the LUWID.

A resource manager can also use a call to the Set_Work_Identifier service to set the next LUWID for transaction chaining. In this case, RRS generates the LUWID for the next UR based on the current and next LUWIDs for the current UR. RRS generates the LUWID before returning control to the application program following a commit or backout call and before invoking any COMPLETION exit routines.

Resource managers in distributed processing need the following services:

Callable service Description
Set_Syncpoint_Controls Define the resource manager's role in supporting a distributed environment for protected resources. This call is usually issued in the resource manager's STATE_CHECK or PREPARE exit routine.
Set_Side_Information Set the side information for an interest in a UR.
Retrieve_Side_Information Retrieve the side information for an interest in a UR.
Set_Work_Identifier Set the unit of work identifier (UWID), which is an LU 6.2 logical unit of work identifier (LUWID) or an Enterprise identifier (EID).
Retrieve_Work_Identifier Retrieve the unit of work identifier (UWID), which is an LU 6.2 logical unit of work identifier (LUWID) or an Enterprise identifier (EID).

For more information, see Callable resource recovery services.

A resource manager that has taken the server distributed syncpoint resource manager (SDSRM) role for an interest in a UR additionally needs the following calls:

Callable service Description
Prepare_Agent_UR Start the prepare phase of a syncpoint operation for a unit of recovery
Backout_Agent_UR backout a unit of recovery
Commit_Agent_UR Commit a unit of recovery
Forget_Agent_UR_Interest Forget a unit of recovery

For information on the calls, see Callable resource recovery services.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014