Task-related user exit resynchronization
Task-related user exit resynchronization enables a resource manager to ask CICS for the resolution of UOWs about which it is indoubt.
Task-related user exit resynchronization is called as a result of an EXEC CICS RESYNC command to restore the CICS end of the thread that was interrupted by the failure of the connection with the resource manager.
- rmi entryname (8 bytes). The name of the TRUE to be called for resynchronization.
- rmi qualifier (8 bytes). The qualifier to the name of the TRUE to be called for resynchronization.
- uowid (8 bytes). The id of the UOW to be resynchronized.
- resync type (1 byte). A flag that indicates whether the resynchronization is a result of an EXEC CICS RESYNC command or because of a Recovery manager domain unshunt.
DFHRMSY calls the named TRUE with a resync call giving the resolution of the named UOW. The resolution can be commit or backout. It should not be indoubt or lost to initial start. (Lost to initial start means that a START=INITIAL has been performed subsequent to the indoubt UOW being created. Initial start clears the log and the catalog meaning that Recovery manager has no knowledge of the UOW.)
To find the outcome of the UOW, DFHRMSY issues a INITIATE_RECOVERY call to Recovery manager domain for the named UOW, which returns the UOW status. DFHRMSY then builds the resync plist to pass to the TRUE, and calls the TRUE using a DFHRMCAL macro.
On return from the TRUE, if the TRUE returns an OK response indicating that it has successfully resynced with its resource manager, DFHRMSY issues a TERMINATE_RECOVERY call to RECOVERY manager domain specifying FORGET(YES). This tells RM domain it can remove this TRUE's involvement in the UOW. If no other components or TRUEs are waiting resync for the UOW, RM domain deletes its knowledge of the UOW. If the TRUE does not return with an OK response, FORGET(NO) is specified on the TERMINATE_RECOVERY call, and RM domain retains this UOW for this TRUE. A subsequent resync will be required.