Define assignment of tape device to depot
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | T |
This command is available only in conjunction with the MAREN product; the MAREN subsystem must be loaded.
Function
The ADD-DEVICE-DEPOT command is used to notify the device management facility (NDM) of the assignment of physical tape devices (using their mnemonics) to “depots”.
This command cannot be processed successfully unless the following conditions are satisfied:
there is no allocation to the type of device specified in the command
there are no allocations to a device type in an existing depot
the MAREN subsystem is listed in the subsystem catalog
If the first two conditions are not satisfied, message NKG0006 is issued to the operator; if the third is not satisfied, message NKG0007 is issued.
If the MAREN subsystem is in the subsystem catalog, but is not available at command runtime, any tape devices specified in the command will be permanently inaccessible. Consequently, you should not use the command unless the MAREN subsystem is loaded. The system administration must ensure that the depots defined in the MAREN catalog match the depots specified in this command. If this is the case, BS2000 device management in conjunction with MAREN can arrive at a suitable selection of devices for a tape mounting request to be issued to the operator or to a robot-supported cartridge archive system. The definition of depots permits the reservation of devices from a specific device set, e.g. during robot operation (see also the command SECURE-RESOURCE-ALLOCATION, operand DEVICE=(...,LOCATION=...)).
Devices of the same device type assigned to exactly the same depots are administered in “device pools” within NDM. Devices that are not assigned to any depot are classified as “RESTPOOL devices”. The procedure for obtaining depot information is described under “Device management” in the “Introduction to System Administration” [14].
Format
ADD-DEVICE-DEPOT |
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4> ,LOCATION = <alphanum-name 1..8>(...) ,ROUTING-CODE = *UNCHANGED / <name 1..1> |
Operands
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Mnemonic names of one or more devices to be assigned to a depot. A maximum of 10 devices can be specified per command.
LOCATION = <alphanum-name 1..8>
Name of the depot. Up to 1024 devices can be assigned to a depot.
Note
The depot (LOCATION) is determined by means of MAREN for scratch tape requests. If MAREN is not available, an attempt is made to select a tape device from the RESTPOOL (tape devices which have not been allocated to a depot).
ROUTING-CODE =
Controls message output. If a routing code for which no console is defined in the system is specified, messages are output at the main console.
ROUTING-CODE = *UNCHANGED
The preset value for the routing code remains unchanged.
ROUTING-CODE = <name 1..1>
A defined routing code is specified. This enables the messages necessary for the devices assigned to this depot to be output to a specific console. The preset routing code is T.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | 0 | NKG0008 | MAREN subsystem not available |
2 | 0 | NKG0007 | MAREN subsystem not in subsystem catalog |
64 | NKV0004 | Command partially processed | |
64 | NKV0005 | Command not processed for an object | |
64 | NKV0006 | Command not processed | |
130 | NKVT002 | Tape monitor unavailable |