CSD UNLOCK

Remove the lock from a group or list of definitions.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

CSD UNLOCK

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

Conditions: CSDERR, DUPRES, INVREQ, LOCKED, NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The UNLOCK command removes from a group or list a lock previously added by the LOCK command.

A syncpoint is implicit in CSD UNLOCK 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 unlocked.
LIST(data-value)
Specifies the 8-character name of the list to be unlocked.

Conditions

CSDERR
RESP2 values:
1
The CSD cannot be read.
2
The CSD is read only.
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 specified 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.