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

SPXTAPE SCAN
Usage Notes
Tape Disposition Operands:
RUN
rewinds and unloads the tape after the scan completes. This is the default.
Upon detecting the logical end-of-tape (the end of the tape file written by
SPXTAPE DUMP on that volume), SPXTAPE SCAN issues response 5, rewinds
and unloads the tape, and waits for another volume to be mounted (the drive
becomes “mount pending”). You must use the SPXTAPE END or SPXTAPE
CANCEL command to cause SPXTAPE SCAN with the RUN disposition to
complete.
LEAVE
leaves the tape positioned to do another SPXTAPE operation.
REWind
rewinds the tape after the scan completes but does not unload.
APPEND
appends the selection criteria specified on this command to the criteria specified
on one or more successive SPXTAPE SCAN commands within one logical
SPXTAPE SCAN operation. All commands in the append sequence must
address the same tape devices and all except the last must be specified with
the APPEND disposition. For more information, see Usage Note 2 on page
1509.
Control Operands:
1508 z/VM: CP Commands and Utilities Reference
NODUP
prevents the scanning of any file that would duplicate a file that already exists
on the spooling system queue where the file would be loaded. For more
information, see Usage Note 3 on page 1509.
PROGress_interval 15 SEC
PROGress_interval progint SEC
PROGress_interval progint MIN
allows the time interval between the progress reports to be changed from the
default of 15 seconds. (See “Response 7” on page 1474.) The interval can be
specified as a decimal number from 0 to 9999. Requesting an interval of 0
causes the progress reports to be suppressed.
If a logical SPXTAPE command is being created through the use of the
APPEND option, the last explicitly requested interval will be used.
1. When using the FN or FT file attribute selection operand, you can use two
special characters, * (asterisk) and % (percent), as wild cards in the file name or
file type pattern. These special characters have the following meaning:
* is a placeholding character that represents any number of characters
from zero to eight, depending on how many other characters are
specified in the pattern. You can use as many asterisks as necessary
anywhere in the pattern as long as the total number of characters,
including the asterisks, does not exceed eight. For example, a pattern of
d* means any string that begins with the character “D”. However, a
pattern of *d* means any string that contains a “D”, whether it is at the
beginning, in the middle, or at the end. A pattern containing a single
asterisk and no other characters means all strings regardless of length
or character content (including the string that contains only blanks).