Display locks for catalog entries
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The SHOW-CE-LOCK command determines whether a lock (CE lock) exists for the catalog entry of a file or job variable. If a lock exists the TID (task ID) of the lock holder and the SYSID (system identification) of the system in which the task is running are output to SYSOUT.
The catalog entry cannot be modified while it is locked. Systems support staff can reset a CE lock that is hung, e.g. due to an error in systems communication (see REMOVE-CE-LOCK command).
For a shared pubset, this command can be entered from any system in the network.
The command supports structured output in S variables (see "Output in S variables").
Format
Operands
FILE-NAME = <filename 1..54>
Name of the file or job variable whose catalog entry is to be examined for CE locks. A file generation may not be specified relatively.
OBJECT = *FILE / *JV
Specifies whether the catalog entry of a file or of a job variable is to be examined.
Return code
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | DMS1342 | No CE lock |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal error | |
32 | CMD2009 | Error during output to S variable (e.g. subsystem not available) | |
64 | CMD0501 | Catalog not available | |
64 | DMS0505 | Error during systems communication | |
64 | DMS0512 | Catalog unknown in the system | |
64 | DMS1343 | Master change underway for the pubset | |
64 | OPS0001 | SDF-P reports insufficient storage (poss. reaction: FREE-VARIABLE and repeat command) |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Name of the file or JV | var(*LIST).NAME | S | <filename 1..54> | |
Sysid of the system in which the lockholder operates | var(*LIST).SYSID | S | <sys-id> | |
Task identifier (TID) of the lockholder | var(*LIST).TID | S | <x-text 4..4> |