IXGLOGR_ENTRYTHRESHOLD

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:

IXGH009E

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