Explanation: OUTDATASET(dsname), SYSOUT,
and TERMINAL are mutually exclusive, optional parameters that
specify the output location for the report you are requesting.
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 audit report. These parameters are not applicable
with AUDIT COMMONQUEUE.
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 second note)
- Secondary allocation of 50 tracks (see second note)
- Unit of SYSALLDA (see second 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 is system reblockable.
- The user can choose the primary space allocation.
- 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
report is to go to the specified output class. For (class),
substitute one alphanumeric character for the class you want.
TERMINAL specifies that the report is to
be printed at the same terminal where the command was issued, and
is to be printed to SYSOUT using only the output class specified with
the SYSOUT parameter of the SETSYS command or the DFSMShsm default
for SYSOUT.
Defaults: The default is SYSOUT, and the
default for (class) is the value specified with the SETSYS
command. If you do not use the SYSOUT parameter of the SETSYS command
to specify the output location, 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 audit report could be written over existing data.
- 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.
Refer to the z/OS DFSMShsm Implementation and Customization Guide for the PATCH command.