IXGLOGR_STRUCTUREFULL

Description:

Reports on log streams that have encountered structure element full conditions. This means that the log stream used all of the elements in its portion of the structure. Additional log streams writes to the structure fail until the full condition is relieved. Applications using the affected log streams may 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 structure element full conditions when log streams remain connected.

Reason for check:

IBM® suggests that tuning actions be taken to avoid structure element full conditions. For more details see message description for IXGH007E.

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 reportingINTERVAL, 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, this check accepts the following parameters to control the time this check reports exceptions from:

PARM('ALL'): The default parameter, ALL, specifies that the check display exceptions occuring since system logger was initialized, up to the most recent 16 log streams that have conditions. For each exception 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 that 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.

In the check output, message IXGH007E or IXGH004I indicates the time the check is reporting from. If the inputted parameters are in an incorrect format, the system issues message IXGH004I and stops the check.

User override of IBM values:

The following sample shows the defaults for customizable values for this check. Use this sample to make permanent check customizations in an HZSPRMxx parmlib member used at IBM Health Checker for z/OS startup. If you just want a one-time only update to the check defaults, omit the first line (ADDREPLACE POLICY) and use the UPDATE statement on a MODIFY hzsproc command. Note that using non-POLICY UPDATEs in HZSPRMxx can lead to unexpected results and is therefore not recommended. End of change

ADDREPLACE POLICY[(policyname)] [STATEMENT(name)]
UPDATE
CHECK(IBMIXGLOGR,IXGLOGR_STRUCTUREFULL PARM('ALL')
SEVERITY(LOW) INTERVAL(4:00) DATE('date_of_the_change')
REASON('Your reason for making the update.')

Use the MODIFY command with the UPDATE parameter to change the IXGLOGR_ENTRYTHRESHOLD check parameters, as follows:

F HZSPROC,UPDATE,CHECK(IBMIXGLOGR,IXGLOGR_STRUCTUREFULL),PARM('ALL')

F HZSPROC,UPDATE,CHECK(IBMIXGLOGR,IXGLOGR_STRUCTUREFULL),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_STRUCTUREFULL)
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:

IXGH007E

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_STRUCTUREFULL:

Output for the no exceptions case:

CHECK(IBMIXGLOGR,IXGLOGR_STRUCTUREFULL)                          
START TIME: 10/10/2007 13:29:57.788349                           
CHECK DATE: 20060615CHECKSEVERITY: LOW                        
CHECK PARM: ALL                                                  
                                                                                                                                  
IXGH004I This system has not encountered any log stream structure
element full conditions since 10/10/2007 13:25:30 (GMT).

Output for the check running with PARM(ALL) and some exceptions found:

CHECK(IBMIXGLOGR,IXGLOGR_STRUCTUREFULL)                              
START TIME: 10/10/2007 16:10:49.286937                               
CHECK DATE: 20060615CHECKSEVERITY: LOW                            
CHECK PARM: ALL                                                      
                                                                     
* LowSEVERITY Exception *                                           
                                                                     
IXGH007E One or more log streams encountered a structure element full
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:10:49.288364  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_STRUCTUREFULL)                              
START TIME: 10/10/2007 16:12:49.140899                               
CHECK DATE: 20060615CHECKSEVERITY: LOW                            
CHECK PARM: TIME(10/10/2007 19:45:00)                                
                                                                                                                                          
* LowSEVERITY Exception *                                           
                                                                     
IXGH007E One or more log streams encountered a structure element full
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:12:49.142517  STATUS: EXCEPTION-LOW