DFHFC0151    date time applid termid tranid An attempt to retain locks for unit of work X'uowid' failed. VSAM return code X'rrrr' reason code X'cccc'.

Explanation

Unit of work uowid for transaction tranid has gone indoubt because it has lost contact with its coordinating system. Consequently CICS has attempted to convert all RLS locks owned by this unit of work into retained locks. This attempt has failed because VSAM has detected an error.

The IDARETLK macro response is rrrr and the reason code is cccc.

termid identifies the terminal running this transaction.

System action

CICS continues shunting this unit of work. It is possible that some locks may remain as active locks (which cause other transactions to wait until their timeout value is reached) rather than as retained locks (which cause other transactions to encounter LOCKED responses.)

Message DFHME0116, which contains the symptom string for this problem, is produced.

User response

Use the VSAM codes to determine the cause of the problem. For the meaning of the VSAM codes, see z/OS DFSMS Macro Instructions for Data Sets. The most likely reason for the failure to convert locks into retained locks is that the SMSVSAM server was not available. Other VSAM codes may indicate a more severe error.

Normally no other action should be necessary. When contact is reestablished, the coordinating system instructs this system to commit or backout. At the end of commit or backout, all retained and active locks are released.

A problem that you may encounter is that some locks may have been left as active locks. This may cause slow response (and eventual failures) from transactions that wait for these locks and have to wait for their full timeout interval.

In this case, you can use the CEMT SET UOW command to force the unit of work to commit or backout, or to make a decision to commit or backout according to the ACTION attribute in the transaction definition. Alternatively, you can use the CEMT SET DSNAME command which will force all in-doubt units of work which had updated the specified data set. However, you should not normally use these commands because they can cause this CICS to become out of step with its coordinating system with consequent loss of data integrity.

If you cannot resolve the problem or the problem recurs, there may be a more severe error. In this case, you will need assistance from IBM. See IBM problem support for guidance on how to proceed.

Module

DFHFCCA

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. termid
  5. tranid
  6. X'uowid'
  7. X'rrrr'
  8. X'cccc'

Destination

CSFL and Console



DFHFC0151.html | Timestamp icon Last updated: Sunday, 4 June 2017