Reset pubset lock
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The REMOVE-PUBSET-LOCK command enables the system administrator to reset locks set by pubset management. The pubset concerned and an unambiguous description of the lock which is to be reset must be specified here. A lock is described unambiguously by the lock type, the system with the lock entry, the task ID and the sysid of the lock holder.
The command can be entered on any system in a shared pubset network (with BS2000/OSD >= V8.0). If the lock which is to be released is not on the system on which the command was issued, the command is sent to the system containing the lock entry. Only locks whose lock entry is contained on a system with BS2000/OSD >= V8.0 can be reset.
The command is rejected if the task which contains the lock still exists and is not in the “pended indefinitely” status.
Successful release of a lock is logged with the console message DMS13CD.
Information on existing locks can be obtained using the SHOW-PUBSET-LOCKS command.
Format
REMOVE-PUBSET-LOCK | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
Catalog ID of the pubset for which the specified lock is to be reset.
LOCK-IDENTIFICATION = *PUBSET-RECONFIGURATION(...) / *SHARED-EXCAT(...) / *SHARED-IMCAT(...) / *SHARED-MASTER-EXCAT(...)
Unambiguous description of the lock which is to be reset.
LOCK-IDENTIFICATION = *PUBSET-RECONFIGURATION(...)
The lock is of the type PUBSET-RECONFIGURATION. For this lock type the lock holder is contained on the system with the lock entry.
TID-OF-LOCKHOLDER = X'FFFFFFFF' / <x-string 1..8>
Task ID (TID) of the instance which holds the lock.
LOCATION-OF-LOCK = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system with the lock entry. The default is *OWN-SYSTEM, i.e. the local system.
LOCK-IDENTIFICATION = *SHARED-EXCAT(...)
The lock is of the type SHARED-EXCAT. The lock holder’s system can be specified for this lock type.
TID-OF-LOCKHOLDER = X'FFFFFFFF' / <x-string 1..8>
Task ID (TID) of the instance which holds the lock.
SYSTEM-OF-LOCKHOLDER = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system on which the lock holder resides. The default is *OWN-SYSTEM, i.e. the local system.
LOCATION-OF-LOCK = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system with the lock entry. The default is *OWN-SYSTEM, i.e. the local system.
LOCK-IDENTIFICATION = *SHARED-IMCAT(...)
The lock is of the type SHARED-IMCAT. The lock holder’s system can be specified for this lock type.
TID-OF-LOCKHOLDER = X'FFFFFFFF' / <x-string 1..8>
Task ID (TID) of the instance which holds the lock.
SYSTEM-OF-LOCKHOLDER = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system on which the lock holder resides. The default is *OWN-SYSTEM, i.e. the local system.
LOCATION-OF-LOCK = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system with the lock entry. The default is *OWN-SYSTEM, i.e. the local system.
LOCK-IDENTIFICATION = *SHARED-MASTER-EXCAT(...)
The lock is of the type SHARED-MASTER-EXCAT. For this lock type the lock holder is contained on the system with the lock entry.
TID-OF-LOCKHOLDER = X'FFFFFFFF' / <x-string 1..8>
Task ID (TID) of the instance which holds the lock.
LOCATION-OF-LOCK = *OWN-SYSTEM / <alphanum-name 1..3>
Sysid of the system with the lock entry. The default is *OWN-SYSTEM, i.e. the local system.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without errors | |
0 | DMS13CE | No reconfiguration lock exists | |
32 | CMD0221 | Internal error | |
32 | CMD2009 | Error creating the presentation variables | |
32 | DMS138A | Internal error with Serslog entry | |
64 | CMD0216 | Privileges error | |
64 | DMS138B | Pubset not found | |
64 | DMS138C | Pubset not accessible | |
64 | DMS1397 | Partner host with illegal version | |
128 | CMD0217 | Command not fully executed | |
128 | DMS1386 | Error in the memory request | |
128 | DMS1389 | Error in MSCF communication |