|
The HZSPRINT utility allows you to look at check output. HZSPRINT
writes the message buffer for the target checks to SYSOUT for one
check, multiple checks, or all checks.
The following information assumes that you have already set up
security for HZSPRINT - see Setting up security for the HZSPRINT utility.
The SYS1.SAMPLIB JCL for the HZSPRINT utility is as follows: //HZSPRINT JOB
//*... */
//HZSPRINT EXEC PGM=HZSPRNT,TIME=1440,REGION=0M,PARMDD=SYSIN
//SYSIN DD *,DLM='@@'
CHECK(*,*)
,EXCEPTIONS
@@
//SYSOUT DD SYSOUT=A,DCB=(LRECL=256)
HZSPRINT parameters can be
passed: - via the JCL PARM string which is limited to 100 characters, or
- via a JCL PARMDD, which is limited to 256 "effective" characters,
for HZSPRINT, at this time. Trailing blanks per line do not count
though. Do not include any other extra blanks, in particular at the
beginning of any line.
Parameters should be separated from each other by a comma. The
following parameters are supported by HZSPRINT: - CHECK(check_owner,check_name)
- check_owner must be between 1-16 characters
and check_name must be between 1-32 characters.
To find the check owner and check name, use either the SDSF CK option
or use the following MODIFY command:
F hzsproc,DISPLAY,CHECKS
You
can also use wildcard characters '*' and '?' in both the check owner
and check name fields to get output from multiple checks. For example,
to see the output of all the checks on the system, you could use the
following:// PARM='CHECK(*,*)'
An asterisk
(*) represents any string having a length of zero or more characters.
A question mark (?) represents a position which contains any single
character. The system converts any lowercase letters to uppercase. CHECK(*,*)
is the default setting for HZSPRINT. If you do not specify CHECK,
you will get CHECK(*,*) to see the output of all checks. Note
that using CHECK(*,*) will only work if you have access to all the
checks. See Setting up security for the HZSPRINT utility.
- EXCEPTIONS
- Optional parameter EXCEPTIONS lets you limit the output in SYSOUT
to messages from checks that wrote at least one check exception message.
For example, to see the output of all checks that found exceptions,
use the following:
// PARM='CHECK(*,*),EXCEPTIONS'
Deleted checks will not be reported on.
- LOGSTREAM(log_stream_name)
- Optional parameter LOGSTREAM specifies that
you want to print the specified log stream, instead of querying the
current Health Checker instance. The log_stream_name has
to start with HZS.
- SYSNAME(system_name)
- Optional parameter SYSNAME lets you limit the output in SYSOUT
to output from checks running on the specified system, sysname.
You can specify the SYSNAME parameter only with LOGSTREAM.
You
can use wildcard characters '*' and '?' in the system_name field
to specify that you want check output from multiple systems.
The
default for SYSNAME is SYSNAME(*), which will give you output for
specified checks from all the systems in the sysplex.
- TIMERANGE(12-char-start,12-char-stop)
- Optional parameter TIMERANGE lets you limit the
data in SYSOUT to entries in the specified time range. Data will
only reported for check iterations with a start time within the TIMERANGE.
Specifying TIMERANGE will let HZSPRINT look beyond the most current
iteration of a check as far as data for previous check iterations
is available. While this is the default behavior for when LOGSTREAM
is specified, without TIMERANGE and without LOGSTREAM, only the most
current check iteration will be reported on for a check. Specify the
12-char-start and 12-char-stop as YYYYMMDDHHMM. All 12 characters
must be valid decimal digits and must represent a valid year, month
(01-12), day (01-31 depending on the month), hour (00-23), and minute
(00-59) specification.
When TIMERANGE is specified with a LOGSTREAM,
the time range applies to entries in the logstream.
When TIMERANGE
is specified without a LOGSTREAM, it applies to entries available
in the currently running instance of IBM® Health
Checker for z/OS®.
If you want to allocate a data set for HZSPRINT
output:
|