Description

An UNLOCK_CO_NAME request allows you to release a single cast-out lock for a data item named in the storage area specified by CUNBAREA. You can also use the request to update the user data in the directory entry for the data item named. The user data, as well as a changed indicator and a parity value, is supplied in the CUNBAREA storage area. (CUNBAREA is mapped by the macro IXLYCUNB.) REQUEST=UNLOCK_CO_NAME is valid only for cache structures allocated in a coupling facility with CFLEVEL=4 or higher.

Once the cast-out lock is released for the data item, the data item might or might not remain associated with its cast-out class:

If the data entry contains unchanged data, the data item is disassociated from any previously specified cast-out class.
If the data entry contains changed data (the entry could have had changed data written to it while the cast-out lock was held), the data item is left associated with the last specified cast-out class.

You can specify that a currently unchanged data item remain associated with its cast-out class by overriding its changed indicator in the directory entry for the data item.

Use the UNLOCK_CO_NAME request type to reset a single cast-out lock; use the UNLOCK_CASTOUT request type to reset multiple cast-out locks with a single request.