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

Usage Notes
NOHold
selects files that are not held. If you specify NOHOLD but not SYSHOLD or
USERHOLD, only files that are not held are loaded. If you do not specify
NOHOLD, SYSHOLD, or USERHOLD, files are loaded regardless of hold
status.
Tape Disposition Operands:
RUN
rewinds and unloads the tape after the load 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 LOAD 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 LOAD with the RUN disposition to
complete.
LEAVE
leaves the tape positioned to do another SPXTAPE operation.
REWind
rewinds the tape after the load completes but does not unload.
APPEND
appends the selection criteria specified on this command to the criteria specified
on one or more successive SPXTAPE LOAD commands within one logical
SPXTAPE LOAD 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 additional information, see usage note 3 on page
1498.
Control Operands:
SPXTAPE LOAD
NODUP
prevents the loading of any file that would duplicate a file that already exists on
the target spooling system queue. For additional information, see usage note 4
on page 1498.
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. Using SPXTAPE LOAD at off-peak hours on the system will have less impact
on users due to I/O contention to the spool DASD.
2. 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
Chapter 2. CP Commands 1497