Releases exclusive control on a record.

Sintaxe:

Notas:

1. DATASET is also accepted, but FILE is preferred.
2. DSIDERR is equivalent to FILENOTFOUND.

Descrição:

UNLOCK releases the exclusive control that was established in response to a READ command with the UPDATE option.
You use the UNLOCK command if you retrieve a record for update, then decide that you do not want to update the record.
For a recoverable file, however, the resource remains locked until either a SYNCPOINT command is executed or the task is terminated.
The record can be in a file on a local or a remote system.

This command is also used to terminate a WRITE MASSINSERT operation.
However, because the MASSINSERT option is not supported by CICS, an UNLOCK that is paired with a WRITE MASSINSERT has no effect.
No condition occurs, and the program continues to run.

Opções:

FILE(name)
• Specifies the name of the CICS file that is holding the record that is to be released.
• The name must be alphanumeric, up to eight characters long, and must have an entry in the File Definitions (FD) (unless the SYSID option specifies a remote system).
• If a remote SYSID is specified, the underlying file is assumed to reside on a remote system irrespective of whether the name exists in the local FD.
• Otherwise, the FD entry is used to determine whether the underlying file is on a local or a remote system.

SYSID(name)
• Specifies on which CICS region the UNLOCK is to run.
• The SYSID name has one through four characters.
• For a full description of the SYSID option, refer to SYSID.
• If the SYSID option is not specified, it defaults to the value that is in the RemoteSysId attribute of the FD entry for the file that is requested in the FILE option.

Condições:

DISABLED
• Occurs if a file is disabled.
• A file might be disabled because:
  • It was initially defined as disabled and has not since been enabled.
  • It has been disabled by an EXEC CICS SET FILE command or by the CEMT transaction.
• This condition cannot occur when the UNLOCK follows a successful READ UPDATE or is related to a WRITE MASSINSERT command.
• Ação pré-definida: Terminates the task abnormally.

FILENOTFOUND
• Occurs if the name that is specified in the FILE option cannot be found in the FD.
• Ação pré-definida: Terminates the task abnormally.

ILLOGIC
• Occurs if an error occurs that does not fall within one of the other CICS response categories.
• Further information is available in the EIBRCODE field; see Appendix A, EXEC interface block (EIB) fields for details.
• Ação pré-definida: Terminates the task abnormally.

IOERR
• Occurs if an I/O error occurs during the file control operation.
• An I/O error is any unusual event that is not covered by a CICS condition.
• Further information is available in the EIBRCODE field; see Appendix A, EXEC interface block (EIB) fields for details.
• See Processing the IOERR condition for information about handling the IOERR condition.
• Ação pré-definida: Terminates the task abnormally.

ISCINVREQ
• Occurs if the remote system indicates a failure that does not correspond to a known condition.
• Ação pré-definida: Terminates the task abnormally.

NOTAUTH
• Occurs for the following conditions:
  • When a resource security check is unsuccessful on FILE(name)
  • When SYSID is specified by a transaction that is defined with the RSLCheck attribute set to either internal or external
• Ação pré-definida: Terminates the task abnormally.

NOTOPEN
• Occurs for the following conditions:
  • The requested file is CLOSED and UNENABLED.
  • The CLOSED, UNENABLED state is reached after a CLOSE request has been received against an OPEN ENABLED file, and the file is no longer in use.
  • The requested file is OPEN and in use by other transactions, but a CLOSE request against the file has been received.
  • Current activity is allowed to complete, but no new activity is allowed to start.
• This condition does not occur if the request is made to either a CLOSED, ENABLED file or a CLOSED, DISABLED file.
• In the first case, the file is opened as part of executing the request.
• In the second case, the DISABLED condition occurs.
• It also cannot occur when the UNLOCK follows a successful READ UPDATE or is related to a WRITE MASSINSERT command.
• Ação pré-definida: Terminates the task abnormally.

SYSIDERR
• Occurs if a problem with the communications configuration prevents the UNLOCK from proceeding.
  For example:
  • The connection that is named in the SYSID option is not the name of a Communications Definition (CD) entry.
  • The SYSID option references a CD entry that is incorrectly configured.
  • The SYSID option references a CD entry that is marked as out of service.
• It can also occur if the connection to the remote system is closed.
• This could be because the remote system is not available.
• Ação pré-definida: Terminates the task abnormally.

Informações relacionadas:

• Processing the IOERR condition
• READ
• SET FILE DISABLED
• SYNCPOINT
• WRITE
• Appendix A, EXEC interface block (EIB) fields
• TXSeries for Multiplatforms Administration Reference
• TXSeries for Multiplatforms Intercommunication Guide