UNLOCK-DEVICE

Cancel hardware reservations

Component:	BS2000
Functional area:	Device management
Domain:	DEVICE
Privileges:	OPERATING
Routing code:	G

Function

The UNLOCK-DEVICE command cancels a hardware reservation for one or more devices.

Before issuing the UNLOCK-DEVICE command, users should ensure that no other UNLOCK attempt is being made on the same device from a different system. Injudicious use of this command may result in the cancellation of a reservation for a different system.

Format

UNLOCK-DEVICE                                                                                                                                        

UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>

Operands

UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Specifies the mnemonic device name of the hardware unit for which a device reservation is to be canceled. Up to 10 units may be specified.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
12	64	NKR0...	Internal check negative
16	64	NKR0...	Caller error
20	64	NKR0...	Software error

If there is an error in command termination, the maincode contains the message code of the message output during command processing. 

Notes

• The UNLOCK-DEVICE command should be issued in the following cases:

  • The magnetic tape cartridge device is “detached” on all other systems and an ATTACH command was rejected with the messages

    NKR0044 DEVICE=mn ATTACHMENT REJECTED
NKR0111 DEVICE=mn ASSIGNED ELSEWHERE

  • It was not possible to release the hardware reservation after a DETACH/REMOVE command (message NKR0115).

• The UNLOCK-DEVICE command will be rejected if the tape device has the status “attached”, “attach pending”, “detached implicitly” or “detach pending implicitly”.

• The command may be required for disk devices if message EXC0857 is issued with the insert “... DEVICE/BUSY/RESERVED ...”. Before issuing it you should check that no other system is accessing the disk and that the reservation is authorized.

• The following messages signal successful execution of the command:

  NKR0102 DEVICE=mn UNLOCK-DEVICE PROCESSED
NKR0114 DEVICE=mn UNASSIGNED

Example

Cancel the hardware reservation for device CA

/UNLOCK-DEVICE UNIT=CA

or

/UNLOCK-DEVICE CA