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

Usage Notes
Each volume log has a unique name. The file name and file type have the following
format:
aabbcvvv hhmmsstt
aa is the month the SPXTAPE command is issued.
bb is the day the SPXTAPE commmad is issued.
c is the first letter of the SPXTAPE operation: D = DUMP, L = LOAD, S = SCAN.
vvv
are the three least significant digits of the virtual device number of the tape
drive.
hh is the hour the SPXTAPE command is issued.
mm
is the minute the SPXTAPE command is issued.
ss is the second the SPXTAPE command is issued.
tt are the two least significant digits of the volume sequence number, which is the
number of this volume in the sequence of volumes processed so far on this
device for this command.
The volume log contains a header (response 1) for the command that creates the
log. If the command that creates the log is issued with the APPEND operand, a
header is also written in the log for each appended command. Each header is
followed by the file information (response 2 entries) for the files selected by the
command identified in the header.
1. SPXTAPE cannot load or scan files dumped by the SPTAPE command, which
is no longer supported. See the z/VM: Migration Guide.
2. SPXTAPE supports all tape drives fully supported by z/VM. For a list of
supported devices, see the z/VM: General Information book.
SPXTAPE
3. On tapes that have standard tape labels, SPXTAPE skips over the header
label group. If the header label group was written on a drive with a format that
is incompatible with the drive where the tape is currently mounted, SPXTAPE
DUMP cannot read the label and will write over it.
4. SET IMSG OFF suppresses the display of SPXTAPE informational messages,
error message HCP1909E, and response 9. However, SET IMSG OFF does
not suppress the request to mount a new tape when the current one is full.
Message HCP1916I is written in the command summary log only and not
displayed, even if IMSG is set ON.
5. Specifying a range of one virtual device number on an SPXTAPE command is
the same as specifying just one device. For example, spxtape dump 181-181 is
the same as spxtape dump 181.
6. When an SPXTAPE command is issued with a device number range, the
command begins processing if a supported tape drive is attached to at least
one device number in the range. Unsupported devices and device numbers
where no device is attached are ignored and are reported only if there is no
valid device in the range. On SPXTAPE DUMP, tape devices attached
read-only are ignored and are reported only if no device is attached
write-enabled.
If the range includes any device already active for a matching SPXTAPE
DUMP, LOAD, or SCAN command, the active command range is expanded to
include the drives covered by the expanded range. This capability can be used
Chapter 2. CP Commands 1465