Change mount state of tape
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | T |
Function
This command changes the mount state of a tape (initiates the remounting of a tape).
Format
CHANGE-TAPE-MOUNT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT =
Specifies one or more tapes to be remounted.
UNIT = *VOLUME(...)
Specifies the volume serial numbers (VSN, up to 6 characters) of one or more tapes whose mount state is to be changed. A maximum of 10 tapes may be specified.
VOLUME = list-poss(10): <vsn 1..6>
Specifies the VSN.
UNIT = *EXCHANGE-PAIR(...)
A used tape for which no device is available is to be exchanged for a used tape which is allocated a device. A maximum of 10 pairs may be specified.
EXCHANGE-PAIR = list-poss(10): *PARAMETER(...)
Specifies up to 10 pairs of used tapes. In each pair, one tape is to be exchanged for the other.
DISMOUNT-VOLUME = <vsn 1..6>
This used tape, which is allocated a device (PHASE IN-USE, ACTION neither NO DEVICE nor CANCELLED), is to be dismounted. Processing of this tape is interrupted but not terminated.
REMOUNT-VOLUME = <vsn 1..6>
This used tape, for which no device is available (PHASE=’IN-USE’ and ACTION not equal ’NO DEVICE’ or ACTION not equal ’CANCELLED’), is to be mounted instead of the tape to which a device is allocated. Interruption processing of this tape is terminated. All input/output requests for this tape are processed again.
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Lists up to 10 tapes to be remounted.
ACTION =
Specifies the way in which the mount state is to be changed.
ACTION = *EXCHANGE
In each of the tape pairs specified under UNIT in the *EXCHANGE-PAIR operand, one tape is to be exchanged for the other.
ACTION = *MOVE
The tape specified under UNIT in the *VOLUME operand or the tape on the device specified by means of its mnemonic name is to be remounted on another device. The system proposes a free device. For remounting the following requirements apply:
there must exist one free device which supports the recording density used;
the tape is in the PHASE=’IN-USE’ status and ACTION not equal ’NO DEVICE’ or ACTION not equal ’CANCELLED’,
the user must not have specified NO MOVE at reservation time
ACTION = *CANCEL
The allocated tape specified under UNIT in the *VOLUME operand is no longer to be available to the user. All further input/output requests are automatically rejected until the tape has been released by the user.
ACTION = *POSITION
The allocated tape specified under UNIT in the *VOLUME operand is to be repositioned. In this way the operator can correct any inadvertent intervention on the device.
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 | NKVT002 | Tape monitor not available |
Notes
Remounting (MOVE function) for a tape should always be announced with a command because if repositioning takes place without a command there is no guarantee that the tape on the backup device will remain repositionable.
The state PHASE=’IN-USE’ and ACTION=’NO DEVICE’ can only occur for a tape if the device on which the tape is mounted is immediately detached and no backup device is available (detachment by the operator with /
DETACH-DEVICE UNIT=mn,FORCE=YESor automatic detachment by the system).In the case of tapes without an STD label whose device is inoperable and for which no backup device is available, processing is stopped immediately. The display ACTION=’NO DEVICE’ is not possible for these tapes.