Clear system allocation log
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | D |
Function
This command causes the system allocation log (list of systems occupying disk space in the standard volume label) of a disk to be cleared of catalog IDs no longer working with the disk. For both private disks and pubsets any file locks of the catalog ID still existing are reset. The command can also be executed for all a pubset’s disks (UNIT=*PUBSET-DEVICES). The operator is responsible for ensuring that no system is removed which is still working with the disk.
Important note on shared pubset operation
You must not issue the command without first making sure that the pubset in question has not been imported by the sharer or sharers (see Notes).
Format
UNLOCK-DISK | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT =
Specifies the disks whose system allocation log is to be cleared.
UNIT = *VOLUME(...)
Specifies the volume serial numbers of disks whose system allocation log is to be cleared.
VOLUME = list-poss(10): <vsn 1..6>
Specifies the volume serial numbers (VSN, up to 6 characters) of one or more disks whose system allocation log is to be cleared. A maximum of 10 disks may be specified.
UNIT = *BY-PUBSET-DEVICES(...)
Specifies that the system allocation log is to be cleared for a pubset’s disks. Since the mnemonic device names (MNs) of the associated disks are administered in the SVL of the system disk, the latter must be entered in the MRS catalog. The entry is made by means of /ADD-MASTER-CATALOG-ENTRY PUBRES-UNIT=<mn> and whenever the pubset is imported or exported and whenever its composition is changed (see MODIFY-PUBSET-PROCESSING).
PUBSET =
Designates the pubset for whose disks the system allocation log is to be cleared. The pubset can be specified via its catalog ID or the device code of its system disk.
PUBSET = <cat-id 1..4>
Catalog ID of the pubset for whose disks the system allocation log is to be cleared. There must be a corresponding entry in the MRS catalog. If there is no such entry then the command can only be executed if the system disk is specified (see PUBSET=*BY-PUBRES-DEVICE).
PUBSET = *BY-PUBRES-DEVICE(...)
Specifies the pubset’s system disk (pubres).
UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device code (MN) of the pubres.
UNIT = list-poss(10): <alphanum-name 2..2>(...) / <alphanum-name 4..4>(...)
Specifies the mnemonic device names (2 or 4 alphanumeric characters; see notes) of one or more disks whose system allocation log is to be cleared.
A maximum of 10 disks may be specified.
FORCE =
Specifies whether the option of terminating processing is available.
FORCE = *NO
Before the command is executed message NKVD072 is issued offering the operator the option of terminating processing.
FORCE = *YES
Message NKVD072 is suppressed if the VSN of the mounted disk is specified in the CHECK-VSN operand.
CHECK-VSN =
Determines whether, in addition to the entry of the mnemonic device name that was specified in the UNIT operand, NDM is to check whether a particular disk specified by means of its VSN is mounted on the device.
CHECK-VSN = *NO
The VSN of the disk is not to be checked.
CHECK-VSN = <vsn 1..6>
If the disk whose VSN is specified here is mounted on the device, message NKVD072 is suppressed. In this case, since the disk device and VSN are identified uniquely, the operator can no longer prevent the command from being executed.
SYSTEM-IDENTIFIER =
Specifies the systems for which the UNLOCK operation is to be performed.
SYSTEM-IDENTIFIER = *ALL
All foreign systems occupying disk space are removed from the SVL. In addition, all file locks still maintained by foreign systems are reset; this also applies to systems that are not stored in the SVL.
SYSTEM-IDENTIFIER = *UNKNOWN
Resets all file locks of systems which are not entered to the SVL of the disk. This function is required if, for example, tasks of a system were not able to reset their file locks due to their abortion via FORCE-JOB-CANCEL and the disk was subsequently released by the system.
SYSTEM-IDENTIFIER = list-poss(16): <integer 0..255> / <name 1..1>
Resets the allocation for the specified system in the SVL of the disk and cancels all its existing file locks. A maximum of 16 catalog IDs can be specified.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NKV0001 | Syntax error | |
64 | NKV0004 | Command partially processed | |
64 | NKV0005 | Command not processed for an object | |
64 | NKV0006 | Command not processed | |
130 | NKVD002 | Disk monitor unavailable |
Notes
When the UNLOCK job is processed the operator is prompted to re-enter the VSN of the disk as confirmation of the job. This is a precautionary measure to prevent an UNLOCK operation being executed for a system that is still active. As soon as the system in question recognizes the unauthorized UNLOCK attempt, it initiates a CANCEL operation for the disk.
If the UNLOCK-DISK command is issued for an imported shared pubset on one or all sharers, the sharer systems will be deleted from the SVL of one volume. This will make the NDM administration data inconsistent among the volumes of the shared pubset. If a system whose SYSID is no longer present in the sharer list now accesses the SVL of one of these volumes, that volume will be canceled by the disk monitor on the accessing system and will thus no longer be accessible in the current BS2000 session.
Example
The system allocation log is to be cleared for devices A1 with disk WK0001 and A2 with disk WK0002. If the specified disks are mounted then the command is to be executed without any query.
/unlock-disk unit=(a1(force=*yes,check-vsn=wk0001),
a2(force=*yes,check=wk0002)), sys-id=*all