z/VM: CP Commands and Utilities Reference - z/VM - IBM

SPXTAPE END
►►
SPXtape
Authorization
Purpose
Operands
END
Usage Notes
vdev
vdev1-vdev2
Privilege Class: D, E, G
SPXTAPE END
Use SPXTAPE END to end SPXTAPE DUMP, LOAD, or SCAN processing at the
completion of the current file.
vdev
vdev1-vdev2
is the virtual device number of the tape drive, or the range of virtual device
numbers, on which the SPXTAPE operation is ended. If you specify a range,
and all active tape drives in the range are operating for a single SPXTAPE
command, they are ended.
1. Only the user who entered the SPXTAPE DUMP, LOAD, or SCAN command
can enter SPXTAPE END to end the operation.
2. If the specified range of virtual device numbers does not include all the tape
drives associated with a single SPXTAPE command, only the selected drives
are ended. The original command continues to operate on the remaining drives.
If the range includes tape drives that are active for different SPXTAPE
commands, none of the tapes are ended. You must use separate SPXTAPE
END commands. For example, if device 181 is active for one command and
device 182 is active for another command, you cannot use a range of 181-182
to end them both at the same time.
3. You can use either SPXTAPE END or SPXTAPE CANCEL to remove failing
drives or to make drives available for other work. END does it gracefully, at the
completion of the current file; CANCEL does it immediately, even in the middle
of a file.
4. The tape is positioned as specified by the disposition operand on the SPXTAPE
command that initiated the activity being ended.
For LOAD or SCAN with the LEAVE disposition, the tape is positioned at an
indeterminate record on the volume. To process another tape file on the same
tape, enter TAPE FSF.
For DUMP with the APPEND disposition, if no other drives are active, the dump
of the current file is completed and the DUMP command completes. This could
leave many selected files not dumped. Therefore, you should not select all
drives with SPXTAPE END unless the drives are in the “WAITING” status. If
your intent is to have all the appended files complete, use SPXTAPE DUMP
with REWIND, RUN, or LEAVE. This causes the command to complete when all
the appended files have been dumped.
►◄
Chapter 2. CP Commands 1491