Explanation: OUTDATASET, SYSOUT, and TERMINAL
are mutually exclusive, optional parameters specifying the output
location for the list.
- OUTDATASET(dsname)
- specifies the name of the data set where DFSMShsm is to write
the output data. For dsname, substitute the fully qualified
name of the data set to receive the LIST command output.
If the
data set does not exist, DFSMShsm dynamically allocates and catalogs
an output data set with the following characteristics:
- Data set name specified (dsname)
- Record format of fixed-blocked with ANSI control characters (FBA)
- Logical record length of 121
- Data set is system reblockable
- Primary allocation of 20 tracks (see third note)
- Secondary allocation of 50 tracks (see third note)
- Unit of SYSALLDA (see third note)
If the data set already exists, DFSMShsm will use the
data set. The data set must have the following characteristics:
- The data set must be cataloged and on DASD.
- The data set record format must be FBA, and the logical record
length must be 121.
- The data set must be system reblockable.
- The user chooses the primary space allocation.
- DFSMShsm uses a secondary space allocation of 50 tracks, if DFSMShsm
needs additional extents after the primary space allocation. (See
third note.)
- If the data set does not contain data, DFSMShsm starts writing
output data at the beginning of the data set.
- If the data set contains data, DFSMShsm writes the output data
after the existing data.
- SYSOUT(class)
- specifies that the list is printed to the specified system output
class. For class, substitute the alphanumeric character for
the system output class you want.
- TERMINAL
- specifies that the list is printed at your terminal.
Defaults: The default is SYSOUT, and
class defaults
to the class specified with the SETSYS SYSOUT command. If you did
not specify the type of class with the SETSYS command, the default
is class A.
Note: - DFSMShsm does not handle partitioned data set members individually.
If you specify a partitioned data set with a member name as the output
data set, the list can be written over existing data.
- If you specify an output data set that does not have the required
characteristics, I/O errors can occur in your output data set.
- If you select the OUTDATASET option, you can use the PATCH command
to change the unit name, primary allocation, and secondary allocation.
If you select the SYSOUT option, you can use the PATCH command to
change whether, and how, DFSMShsm limits the lines of SYSOUT output.
See z/OS DFSMShsm Implementation and Customization Guide for a description
of the PATCH commands available.