The CEDA UNLOCK command

Use the CEDA UNLOCK command to remove the lock from a group or a list of definitions.

Syntax

Description

The UNLOCK command is the only RDO command that can remove a lock on a list or group put there by use of the RDO LOCK command.

You can UNLOCK a nonexistent group or list.

You must specify either the GROUP or the LIST option, even if you are unlocking the current group or list, because the UNLOCK command can be used with both.

Locking and unlocking resources

The LOCK and UNLOCK commands enable you to control update access to a group or list so that only operators with the same operator identifier can make changes.

The lock is held on the CSD file and remains in effect across restarts of CICS®. The lock is owned by the user, who is identified by a combination of the CICS generic applid (specified by the APPLID system initialization parameter), and the user's operator identifier (OPIDENT).

The OPIDENT is the one associated with the user when he or she signs on to the terminal used for RDO. For further information on OPIDENT, see The CICS segment. Any user who is not signed on or who has a different OPIDENT is not allowed to perform any operation that would change the locked group. However, any user is allowed to do the following things to a locked group:

CHECK
COPY
DISPLAY
INSTALL
VIEW

The lock can be removed, using the UNLOCK command, only by a user on the same system and with the same operator identifier.

Options

Group(groupname): specifies the group to be unlocked. A generic group name is not accepted.
List(listname): specifies the list to be unlocked. A generic list name is not accepted.

Examples

To unlock a group G1:
```
UNLOCK GROUP(G1)
```
To unlock a LIST L1:
```
UNLOCK LIST(L1)
```