Request mount presettings for disks and tapes
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | STD-PROCESSING |
Routing code: | E |
Function
The following specifications may be made in regard to the mounting and dismounting of private volumes.
Handling of mount requests for private disks (DISK-MOUNT)
The following values can be specified for DISK-MOUNT:YES:
Default value; mount requests are displayed on the console
NO:
Mount requests are rejected by the system. REMOUNT and INOP messages are displayed as before.
Handling of mount requests for tapes (TAPE-MOUNT)
The following values can be specified for TAPE-MOUNT:YES:
Default value; mount requests are displayed on the console
NO:
Mount requests are rejected by the system. REMOUNT and INOP messages are displayed as before.
Automatic allocation of tapes already mounted (ALLOCATE-TAPE)The following values can be specified for ALLOCATE-TAPE:
YES:
Default value; tapes already mounted are allocated by the system (without MOUNT, PREMOUNT or REMOUNT request).
NO:
Tapes already mounted are allocated by the operator (MOUNT, PREMOUNT or REMOUNT message on console).
Handling of released tapes (UNLOAD-RELEASED-TAPE)
The following values can be specified for UNLOAD-RELEASED-TAPE:ACCORDING-TO-USER-REQ:
Default value; tape and MTC devices are only unloaded on being released if this is requested by the user.
REGARDLESS-OF-USER-REQ(ALL):
Tape and MTC devices are unloaded automatically on being released, regardless of any user requests.
REGARDLESS-OF-USER-REQ(MBK):
MTC devices are unloaded automatically on being released, regardless of any user requests. Tape devices are only unloaded if this is requested by the user.
IGNORE-USER-REQ:
The user request for unloading is ignored for tape devices. For MTC devices, the request for unloading is ignored if the device is being operated in MANUAL mode, otherwise the device is unloaded on request by the user.
Selection of suitable free tape devices or MTCs (TAPE-SELECT)
The following values can be specified for TAPE-SELECT:BEST-GENERATED:
Default value; selects the first suitable free device from the list of generated devices.
LEAST-RECENTLY:
Selection from the set of all suitable free devices, where the device with the least period of use is selected (balanced device loading).
BY-CONTROLLER:
Selection from the set of all suitable free devices, where the device connected to the controller which has the lowest utilization is selected.
Control of PREMOUNT message output (PREMOUNT-MSG)
The following values can be specified for PREMOUNT-MSG:ACCORDING-TO-USER-REQ
Default value; output compatible with BS2000/OSD-BC V2.0.
IGNORE-USER-REQ
No PREMOUNT messages are output.
PROCESS-USER-REQ-ASYNCH
Output of PREMOUNT messages which do not require a response.
The command supports structured output in S variables (see "Output in S variables").
Format
SHOW-MOUNT-PARAMETER |
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NKD0005 | Warning: information incomplete |
1 | NKD0001 | Syntax error in the input, correction of the command parameters recovers the error | |
32 | CMD2009 | Error during S variable output (e.g. subsystem not available) | |
64 | NKD0002 | No information available | |
64 | NKD0006 | Internal error during initialization of the command server | |
130 | NKD0010 | Disk or tape monitor is temporarily not available; the command was not executed | |
130 | OPS0001 | SDF-P reporting space problems (possible response: FREE-VARIABLE and repeat command) |
Output format
The following two header lines are displayed, each accompanied by a values line.
Header line 1:
% DISK-MOUNT TAPE-MOUNT ALLOCATE-TAPE UNLOAD-RELEASED-TAPE
Header line 2:
% TAPE-SELECT PREMOUNT-MSG
If settings which differ from the global settings exist for a location, 2 header lines, each accompanied by a values line, are also displayed for this location:
Header line 1:
% LOCATION TAPE-MOUNT ALLOCATE-TAPE UNLOAD-RELEASED-TAPE
Header line 2:
% TAPE-SELECT PREMOUNT-MSG
See also section "Information services of device management: Meanings of the output values of SHOW commands".
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Allocation of tapes which are already mounted | var(*LIST).ALLOC-TAPE | S | *NO | |
Show mount requests for private disks | var(*LIST).DISK-MOUNT | S | *NO | |
Name of the location for which the settings apply | var(*LIST).LOCATION | S | <location> | |
Output PREMOUNT messages for tapes | var(*LIST).PREMOUNT | S | *ACCORDING-TO-USER-REQ | |
Show mount requests for tapes | var(*LIST).TAPE-MOUNT | S | *NO | |
Free tape selection | var(*LIST).TAPE-SEL | S | *BEST-GENERATED | |
Handling of released tapes | var(*LIST).UNLOAD | S | *ACCORDING-TO-USER-REQ |
Example
/show-mount-par
% DISK-MOUNT TAPE-MOUNT ALLOCATE-TAPE UNLOAD-RELEASED-TAPE % YES YES YES ACCORDING-TO-USER-REQ % TAPE-SELECT PREMOUNT-MSG % BEST-GENERATED ACCORDING-TO-USER-REQ % % LOCATION TAPE-MOUNT ALLOCATE-TAPE UNLOAD-RELEASED-TAPE % ROBOT1 YES YES ACCORDING-TO-USER-REQ % TAPE-SELECT PREMOUNT-MSG % BY-CONTROLLER ACCORDING-TO-USER-REQ