|
- Description:
- Reports on log streams that have encountered structure
entry threshold conditions. This means that the structure had 90%
of the entries in use at one time. When the entries reach 100%,
write operations to all of the log streams in the structure fail
until the full condition is resolved. Applications using the affected
log streams might experience a slow down or possibly an outage
if the condition is not resolved in a timely fashion. SMF must be
active for system logger to report on entry threshold reached conditions
when log streams reamin connected.
Because this
check may flag valid log stream configurations as exceptions, it has
been set to inactive by default. In order to use this check you must
activate it.
- Reason for check:
- IBM® suggests that
tuning actions be taken to avoid future entry full conditions. For
more details see message description for IXGH009E.
After conditions
are sufficiently corrected before a certain time, set that as a
TIME(mm/dd/yyyy hh:mm:ss) parameter in an UPDATE statement. This
will suppress conditions older than that time. You can cut and
paste the time from the report output.
After updating to
TIME(mm/dd/yyyy hh:mm:ss), if you want to see counts for the log
stream values, you'll either have to switch to the ALL parameter,
or review the information from a SMF report.
We recommend
that check output be saved for historical purposes, especially
if you perform parameter updates. See the following information
for using HZSPRINT to record check output to a data set or log
stream:
Note that because records used to report on this condition
are typically filled in at the time of the system logger SMF
reporting interval, conditions that occur between the time of
the last SMF interval and the time the check is run may be missed.
When ALL is specified, these conditions will appear when the report
is run after the next system logger SMF reporting interval. If
you update to a TIME(mm/dd/yyyy hh:mm:ss), parameter after the
most recent SMF reporting interval, some conditions may never be
reported on. You can either accept this loss, set a TIME(mm/dd/yyyy
hh:mm:ss) before the most recent SMF interval, or use the ALL
parameter to view these conditions when they become available.
- z/OS® releases the check
applies to:
- z/OS V1R7 and later.
- Parameters accepted:
- Yes, the check accepts the following parameters to control
the time this check reports conditions from:
- PARM('ALL')
- The default parameter, ALL, specifies that the check display conditions
that happened since system logger was initialized, up to the
most recent 16 log streams that have conditions. For each condition,
the report lists the log stream name, corresponding structure
name, time of last occurrence, and count of occurrences since
logger started for each log stream that has a condition.
- PARM('TIME(mm/dd/yyyy hh:mm:ss)')
- This parameter specified that the check display exceptions happened
since the requested time. For each exception condition, the report
lists the log stream name, corresponding structure name, and time
of last occurrence. Counts will not be shown when this parameter
is active. The input time, must be a valid GMT, in the requested
format, and can not be a time in the future.
Message IXGH009E or IXGH006I indicates the time
the check is reporting from. If the inputted parameters are in
an incorrect format message IXGH004I will be shown and the check
will be stopped.
- User override of IBM values:
- The following shows keywords you can use to override check values
on either the HZSPRMxx parmlib member or on a MODIFY command. This
statement may be copied and modified to override the check defaults:
UPDATE CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD) PARM('ALL')
SEVERITY(LOW) INTERVAL(4:00) DATE(20071106)
REASON('Logger entry threshold reached conditions
should be investigated to determine if applications
performance is being impacted')
Use the MODIFY
command with the UPDATE parameter to change the IXGLOGR_ENTRYTHRESHOLD
check parameters, as follows: F HZSPROC,UPDATE,CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD)
,PARM('ALL')
F HZSPROC,UPDATE,CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD)
,PARM('TIME(10/10/2007 19:45:00)')
You can
also use system symbols in an HZSPRMxx member to modify a check
to the current time. The following example shows how to update the
check to only report on current log streams conditions: - Update HZSPRMxx to put system symbols in the parameter for IXLOGR_ENTRYTHRESHOLD.,
as the following example shows:
UPDATE CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD)
PARM('TIME(&MON/&DAY/&YR4 &HR:&MIN:&SEC)')
- Using the following console command to add the updated HZSPRMxx
parmlib members to the list of members that IBM Health Checker for z/OS is using:
F HZSPROC,ADD,PARMLIB=xx
- Reference:
- For more information, see z/OS MVS Setting Up a Sysplex.
- Messages:
- This check issues the following exception messages:
See the IXGH messages in z/OS MVS System Messages, Vol 10 (IXC-IZP).
- SECLABEL recommended for MLS users:
- SYSLOW
Output: The following shows output from IXGLOGR_ENTRYTHRESHOLD: - Output for the no exceptions case:
CHECK(IBMIXGLOGR,IXGLOGR_ ENTRYTHRESHOLD)
START TIME: 10/10/2007 13:29:58.588368
CHECK DATE: 20060615 CHECK SEVERITY: LOW
CHECK PARM: ALL
IXGH006I This system has not encountered any structure entry threshold
conditions since 10/10/2007 13:25:30 (GMT).
END TIME: 10/10/2007 13:29:58.648301 STATUS: SUCCESSFUL
- Output for the check running with PARM(ALL) and some exceptions
found:
CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD)
START TIME: 10/10/2007 16:08:40.099953
CHECK DATE: 20060615 CHECK SEVERITY: LOW
CHECK PARM: ALL
* Low Severity Exception *
IXGH009E One of more log streams encountered a structure entry
threshold condition since 10/10/2007 13:25:30 (GMT).
…
Time of Last
Log Stream Structure Count Condition (GMT)
TESTLOG1.HCHECK1.S1 LIST01 1 10/10/2007 19:42:16
TESTLOG1.HCHECK1.S3 LIST02 1 10/10/2007 19:43:02
TESTLOG1.HCHECK1.S2 LIST01 2 10/10/2007 19:43:49
TESTLOG1.HCHECK1.S5 LIST02 1 10/10/2007 19:44:35
TESTLOG1.HCHECK1.S7 LIST01 1 10/10/2007 19:45:22
TESTLOG1.HCHECK1.S6 LIST03 2 10/10/2007 19:46:08
TESTLOG1.HCHECK1.S4 LIST03 1 10/10/2007 19:46:55
TESTLOG1.HCHECK1.S8 LIST03 1 10/10/2007 19:47:41
END TIME: 10/10/2007 16:08:40.102732 STATUS: EXCEPTION-LOW
- Output for the check after it is updated to PARM(‘TIME(10/10/2007
19:45:00)’) and run again. The check now only shows exceptions occurring
after the time specified:
CHECK(IBMIXGLOGR,IXGLOGR_ENTRYTHRESHOLD)
START TIME: 10/10/2007 16:13:05.884363
CHECK DATE: 20060615 CHECK SEVERITY: LOW
CHECK PARM: TIME(10/10/2007 19:45:00)
* Low Severity Exception *
IXGH009E One of more log streams encountered a structure entry
threshold condition since 10/10/2007 19:45:00 (GMT).
…
Time of Last
Log Stream Structure Count Condition (GMT)
TESTLOG1.HCHECK1.S7 LIST01 1 10/10/2007 19:45:22
TESTLOG1.HCHECK1.S6 LIST03 2 10/10/2007 19:46:08
TESTLOG1.HCHECK1.S4 LIST03 1 10/10/2007 19:46:55
TESTLOG1.HCHECK1.S8 LIST03 1 10/10/2007 19:47:41
END TIME: 10/10/2007 16:13:05.885974 STATUS: EXCEPTION-LOW
3.3.12.3 IXGLOGR_STRUCTUREFULL
|