Remove catalog entry lock
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | TSOS |
Function
The systems support staff can remove the catalog entry lock of a file or job variable using the REMOVE-CE-LOCK command.
The system determines whether a lock exists for the catalog entry (CE lock) of a file or a job variable, and if so, the lock holder’s task is determined. If the task no longer exists or if it is pending indefinitely, the CE lock is hung up and cannot be released. This can be caused, for instance, by an error in system communication, in which case the CE lock is removed.
If the lock holder’s task is in another state, the CE lock cannot be removed and the command is rejected. Systems staff will then have to check whether the task can be terminated (e.g. using CANCEL-JOB). The task’s TID and the sysid of the system on which the task is processing can be obtained using the SHOW-CE-LOCK command.
For shared pubsets, the command can be issued from any system within the network.
Format
Operands
FILE-NAME = <filename 1..54>
Name of the file or job variable for which a CE lock is to be removed. The path name has to be specified completely, i.e. including the catalog and the user ID. Specification of a file generation must not be relative.
OBJECT = *FILE / *JV
Specifies whether the command is to be executed for the catalog entry of a file or of a job variable.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | DMS1342 | No catalog entry lock |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal error | |
64 | CMD0216 | No authorization | |
64 | CMD0501 | Catalog not available | |
64 | DMS0505 | Communication error | |
64 | DMS0512 | Catalog unknown in system | |
64 | DMS1343 | Master change underway for pubset | |
64 | DMS1344 | Lock holder’s task still active |