CSD LOCK

Restrict update and delete access for a group or list to a single operator identifier.

CSD LOCK

Read syntax diagramSkip visual syntax diagramCSDLOCKLIST( data-value)GROUP( data-value)

Conditions: CSDERR, DUPRES, INVREQ, LOCKED, NOTAUTH

Description

When you lock a group or list, other users can view or copy it but they are restricted from changing or deleting it. You can lock a nonexistent group or list to reserve the named group or list for your own future use. The only command that releases a lock is the UNLOCK command. No other RDO commands can unlock a group or list. For example, if you delete all the resources in a group, or all the groups in a list, the lock remains.

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

Users who are not signed on or who have a different operator identifier (OPIDENT) are not allowed to perform any operation that changes the locked list or group. However, any user is allowed to perform the following operations on a locked group or list:
  • CHECK (CEDA)
  • COPY
  • DISPLAY (CEDA)
  • INQUIRE/BROWSE
  • INSTALL
  • VIEW (CEDA)

Only a user on the same system and with the same operator identifier can remove the lock, using the UNLOCK command.

A syncpoint is implicit in CSD LOCK processing, except when an exception condition is detected early in processing the command. Uncommitted changes to recoverable resources made up to that point in the task are committed if the command is successful, and rolled back if not.

Options

GROUP(data-value)
Specifies the 8-character name of the group to be locked.
LIST(data-value)
Specifies the 8-character name of the list to be locked.

Conditions

CSDERR
RESP2 values:
1
The CSD cannot be read.
2
The CSD is read only.
3
The CSD is full.
4
The CSD is being used by another CICS system and is not configured for sharing.
5
Insufficient VSAM strings (CSDSTRNO system initialization parameter value) are available to run the EXEC CICS CSD command.
DUPRES
RESP2 values:
2
The name specified in GROUP exists in the CSD as a list.
3
The name specified in LIST exists in the CSD as a group.
INVREQ
RESP2 values:
2
The GROUP option contains one or more characters that are not valid.
3
The LIST option contains one or more characters that are not valid.
200
The command was run in a program defined with an EXECUTIONSET value of DPLSUBSET or in a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
LOCKED
RESP2 values:
1
The group or list is already locked to another user.
2
The group or list is IBM-protected.
NOTAUTH
RESP2 value:
100
The user associated with the issuing task is not authorized to use this command.