CSD LOCK
Restrict update and delete access for a group or list to a single operator identifier.
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.
- 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.