Set default values for mounting and dismounting
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | G |
Function
This command enables the operator to specify default values for mounting and dismounting tapes and disks.
The operator can use the SHOW-MOUNT-PARAMETER command to find out which values are currently set.
Format
MODIFY-MOUNT-PARAMETER | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
DISK-MOUNT =
Specifies whether the operator is ready to carry out disk mounting.
The system default is *YES.
DISK-MOUNT = *UNCHANGED
The value valid up to now (previous MOD-MOUNT-PAR or presetting) remains unchanged (default value).
DISK-MOUNT = *YES
The operator is ready to carry out disk mounting, i.e. allocation requests for unmounted private disks result in a MOUNT message.
DISK-MOUNT = *NO
The operator is not ready to carry out disk mounting. Allocation requests for private disks which are to be mounted are automatically rejected by the system. REMOUNT and INOP messages are still output and require appropriate responses.
TAPE-MOUNT =
Specifies whether the operator is ready to carry out tape mounting. The system default is *YES.
TAPE-MOUNT = *UNCHANGED
The value valid up to now (previous MOD-MOUNT-PAR or presetting) remains unchanged (default value).
TAPE-MOUNT = *YES
The operator is ready to carry out tape mounting, i.e. allocation requests for unmounted tapes result in a MOUNT message.
TAPE-MOUNT = *NO
The operator is not ready to carry out tape mounting. Allocation requests for tapes which are to be mounted are automatically rejected by the system. REMOUNT, INOP and WP-MISSING messages are still output and require appropriate responses.
ALLOCATE-TAPE =
Specifies whether the system can allocate tapes which are already online without operator support (without a MOUNT message). The system default is *YES.
ALLOCATE-TAPE = *UNCHANGED
The value valid up to now (previous MOD-MOUNT-PAR or presetting) remains unchanged (default value).
ALLOCATE-TAPE = *YES
The system responds automatically to PREMOUNT, MOUNT and REMOUNT messages if the tape is recognized as being online.
ALLOCATE-TAPE = *NO
The system does not respond to PREMOUNT, MOUNT and REMOUNT messages even if the appropriate tape is recognized as being online. The appropriate response must be entered by the operator.
UNLOAD-RELEASED-TAPE =
Specifies whether tapes are to be unloaded after their release if they have not already been unloaded by the user. The system default is *ACCORDING-TO-USER-REQUEST.
Note that tapes are unloaded only if they have actually been used (the value of VOLUME-PHASE was IN-USE).
UNLOAD-RELEASED-TAPE = *UNCHANGED
The value valid up to now (previous MOD-MOUNT-PAR or presetting) remains unchanged (default value).
UNLOAD-RELEASED-TAPE = *ACCORDING-TO-USER-REQUEST
When tapes are released, they are unloaded according to user request.
UNLOAD-RELEASED-TAPE = *REGARDLESS-OF-USER-REQUEST(...)
Tapes (streamer tapes and/or cartridges) are unloaded after their release if they were in use (PHASE = IN-USE).
TAPE-FAMILY = *ALL
All tapes (streamer tapes and cartridges) are unloaded after their release.
TAPE-FAMILY = *MBK
Only cartridges are unloaded after their release. Streamer tapes are unloaded after their release according to user request.
UNLOAD-RELEASED-TAPE = *IGNORE-USER-REQUEST
A request to unload a tape volume after its release is ignored. Unload requests for streamer tape devices are always ignored by NDM. Unload requests for tape cartridge devices are only ignored if the device is being used in the “manual” operating mode. This enables cartridges to be changed during unmanned operation if the stackers involved have a supply of cartridges for this purpose.
NEXT-TAPE-MOUNT =
Specifies the device selection mode to be used by NDM to select the free device during tape allocation.
The system default is *BEST-GENERATED-DEVICE.
NEXT-TAPE-MOUNT = *UNCHANGED
The device selection mode valid up to now remains unchanged.
NEXT-TAPE-MOUNT = *BEST-GENERATED-DEVICE
NDM searches through the device table from the beginning, i.e. in the order predefined at system generation, and selects the first suitable free device.
NEXT-TAPE-MOUNT = *LEAST-RECENTLY-USED-DEVICE
NDM searches through the device table and selects the least recently used device from the set of suitable free devices. This “wraparound” allocation enables tape devices to be used more evenly.
NEXT-TAPE-MOUNT = *BY-CONTROLLER
From the suitable free devices, NDM selects a device which is connected to a controller on which the fewest devices are in use. This ensures that the devices used are distributed evenly over the available controllers and channel paths. The device selection in NDM only takes the local device assignments into account. In conjunction with the DDAL function of the IORM subsystem (I/O Resource Manager, see the “Utility Routines” manual [9] (Related publications)), optimization is extended to all guest systems of a BS2000 server.
PREMOUNT-MSG =
Controls the output of PREMOUNT messages (NKVT012).
PREMOUNT-MSG = *UNCHANGED
The existing setting is left unchanged.
PREMOUNT-MSG = *ACCORDING-TO-USER-REQUEST
Output of PREMOUNT messages is as for versions up to and including
BS2000/OSD-BC V2.0.
PREMOUNT-MSG = *IGNORE-USER-REQUEST
PREMOUNT messages are suppressed.
PREMOUNT-MSG = *PROCESS-USER-REQUEST-ASYNCH
PREMOUNT messages are output as “normal” messages which do not require a response.
LOCATION =
Specifies whether the settings made or tapes are to depend on the storage location.
LOCATION = *ALL
The settings do not depend on the storage location.
LOCATION = *NONE
The settings only apply for devices which are not assigned to any storage location.
LOCATION = <alphanum-name 1..8>
The settings only apply for devices which are assigned to the specified storage location. The storage location must already be configured (see /ADD-DEVICE-DEPOT). After a storage location has been deleted, the storage-location-specific parameters are reset.
In the case of devices which are assigned to multiple storage locations with different parameters, the last specification made applies.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NKV0001 | Syntax error | |
130 | NKVD002 | Disk monitor not available | |
130 | NKVT002 | Tape monitor not available |
Note
If spoolout to tape is being used in the current session, UNLOAD-RELEASED-TAPE= *ACCORDING-TO-USER-REQUEST should always be set. This means that the spoolout tape will not be unloaded and have to be remounted every time a file is spooled out.