OA66312: NEW FUNCTION - New WLM_SCLASS_SYSSTC health check

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of z/OS 2.5 (HBB77D0) and above.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New function - New WLM_SCLASS_SYSSTC                         *
  * health check                                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  New function - New WLM_SCLASS_SYSSTC health check.
  
  Provide a dynamic severity check when the CPU consumption of
  address spaces in the system supplied WLM service class SYSSTC
  exceeds one of the specified threshold percentages. This check
  is inactive by default. To use this check, you must activate it.
  
  REASON FOR CHECK:
  Address spaces in the SYSSTC service class are kept at a very
  high dispatching priority. Not all work is appropriate for
  SYSSTC because, if the work is CPU intensive and uses a high
  amount of processor cycles, this could cause CPU delays for
  other important work in the system. Only trusted work that is
  not going to use a lot of CPU but requires fast CPU access and
  absolutely needs a higher dispatch priority than other work is
  appropriate for WLM service class SYSSTC.
  
  PARAMETERS ACCEPTED:
  
  - THRESHOLD_LOW(low%)
  - THRESHOLD_MED(med%)
  - THRESHOLD_HIGH(high%)
  
  At least one threshold parameter is required to indicate a
  threshold of CPU consumption in WLM service class SYSSTC.
  Specify the threshold value as percentage of total CPU time
  that all work can consume on the system. This check supports
  dynamic severity setting and threshold keywords to correspond
  with the severity levels. The severity of the exception is
  based on the provided corresponding thresholds.
  
  The variable for the parameters is as follows: An integer,
  1-100 followed by % indicating the warning threshold percent.
  
  Default:
  THRESHOLD_LOW(20%), THRESHOLD_MED(40%), THRESHOLD_HIGH(60%)
  
  Verbose support:
  If VERBOSE(YES) is specified on the check and one of the
  specified threshold percentages is exceeded, all address spaces
  in the SYSSTC service class which consume CPU will be displayed
  at the end of the check report. With VERBOSE(NO), only up to 10
  top CPU consuming address spaces in the SYSSTC service class
  will be displayed.
  
  
  THIS CHECK ISSUES THE FOLLOWING MESSAGES:
  
  IWMH103I CPU consumption in SYSSTC service class is actual%.
  The {low|medium|high} threshold of threshold% is not reached.
  No action is required.
  
  Explanation:
  CHECK(IBMWLM,WLM_SCLASS_SYSSTC) determined that the actual
  CPU consumption in service class SYSSTC is currently in the
  expected range. The level of CPU consumption is below all
  the threshold(s) being supplied.
  
  In the message text:
  
  actual%     CPU consumption in the SYSSTC service class as
              percentage of total amount of CPU time that all
              work can consume on the system
  
  threshold%  Lowest threshold value supplied in THRESHOLD_LOW,
              THRESHOLD_MEDIUM, or THRESHOLD_HIGH
  
  
  IWMH104I CPU consumption in SYSSTC service class is actual%.
  The {low|medium|high} threshold of threshold% is reached.
  
  Explanation:
  CHECK(IBMWLM,WLM_SCLASS_SYSSTC) determined that the CPU
  consumption in service class SYSSTC has reached one of the
  threshold levels supplied.
  Address spaces in the SYSSTC service class are kept at a very
  high dispatching priority. Not all work is appropriate for
  SYSSTC because, if the work is CPU intensive, it could use a
  high amount of processor cycles, which could cause CPU delays
  for other important work in the system. Only trusted work that
  is not going to use a lot of CPU but requires fast CPU access
  and absolutely needs a higher dispatch priority than other work
  is appropriate for WLM service class SYSSTC.
  
  
  In the message text:
  
  actual%     CPU consumption in the SYSSTC service class as
              percentage of total amount of CPU time that all
              work can consume on the system
  
  threshold%  Lowest threshold value supplied in THRESHOLD_LOW,
              THRESHOLD_MEDIUM, or THRESHOLD_HIGH
  
  
  See the IWMH messages in z/OS MVS System Messages,
  Vol 9 (IGF-IWM) for the complete description of the messages.
  
  See IBM Health Checker for z/OS User's Guide for the
  complete description of the new WLM health check,
  
  HCHECKER/K
  

Problem conclusion

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ96671 UJ96675

Modules/Macros

• IWMHCCHK IWMZ2VRY IWMHCADD IWMHCMSG IRARMSET IRARMMSG IRARMCT
  IWMZ2COR IWMA2SD1 IWMI2JST IRARMST3 IRARMWTO IRAPADRV IWMWLHEN
  IEAVNP10
  

Fix information

• Fixed component name

  WORK LOAD MANAG

• Fixed component ID

  5752SCWLM

Applicable component levels

• R7D0 PSY UJ96675

     UP25/02/26 P F502  

• R7E0 PSY UJ96671

     UP25/02/26 P F502  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.