Class UnlockDO

java.lang.Object
com.softwaremining.vendors.cics.dto.CicsDO
com.softwaremining.vendors.cics.dto.UnlockDO

public class UnlockDO extends CicsDO
UNLOCK releases the exclusive control established in response to a read command with the UPDATE option. You use it if you retrieve a record for update, and then decide that you do not want to update the record after all. However, for a recoverable file (other than one that refers to a coupling facility data table), the resource remains locked until either a syncpoint command is executed or the task is terminated. The record can be in a data set, or in a CICS or user-maintained data table, on a local or a remote system. If the UNLOCK command refers to a record in a recoverable coupling facility data table the record lock is released immediately provided that the task has not made any previous change to the same record (or added it as a new record) within the current unit of work. If changes have been made to the record, or it is a new record added to the table, it remains locked until either a syncpoint command is executed or the task is terminated. If an UNLOCK command does not have a token, an attempt is made to match it to either a read with the UPDATE option that also does not have a token, or to a WRITE MASSINSERT. If neither of these is found, no action is taken and a NORMAL response is returned. Use this command to terminate a VSAM WRITE MASSINSERT operation against a VSAM file. Releasing locks when updating in browse The UNLOCK command does not release locks held against records locked in response to READNEXT or READPREV commands that specify the update option. It only invalidates the TOKEN value so that it cannot be used to complete an update. For more information please see:
  • Constructor Details

    • UnlockDO

      public UnlockDO()
  • Method Details