USS_KERNEL_PVTSTG_THRESHOLD

Description:
This check monitors the current usage of private below-the-bar storage of the UNIX System Services kernel against a suggested threshold.
Reason for check:
Start of changeExhausting the kernel private below-the-bar storage will cause unpredictable errors because resources can no longer be obtained, which could potentially bring down z/OS UNIX.End of change
z/OS® releases the check applies to:
z/OS V2R1 and later.
User override of IBM values:
Start of changeThe 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
Start of changeADDREPLACE POLICY[(policyname)] [STATEMENT(name)]End of change
UPDATE
CHECK(IBMUSS,USS_KERNEL_PVTSTG_THRESHOLD)
INTERVAL(00:02)
SEVERITY(HIGH)
PARM(’PVTSTG_HIGH(90%),PVTSTG_MED(85%),PVTSTG_LOW(80%)')
DATE('20131005')
Debug support:
No
Verbose support:
No
Start of changeParameters accepted:End of change
Start of changeYes, as follows:
  • When not using dynamicSEVERITY:
    • PVTSTG(pvtstg%) where an integer, 0-100, followed by a %, indicating the threshold percent for usage of kernel private storage below the bar that was available after kernel initialization. An exception message is displayed when system values are equal to or greater than pvtstg%. TheSEVERITY of the exception message depends on the system's % usage of kernel private storage that is below the bar.
      • A percentage of 80-84 is lowSEVERITY.
      • A percentage of 85-89 is mediumSEVERITY.
      • A percentage above 89 is highSEVERITY.
  • Start of changeWhen using user-specified dynamicSEVERITY, which is only valid with KERNELSTACKS(ABOVE):
    • PVTSTG_HIGH(pvtstg%)
    • PVTSTG_MED(pvtstg%)
    • PVTSTG_LOW(pvtstg%)
    • PVTSTG_NONE(pvtstg%)
    pvtsg%
    An integer, 0-100 followed by a %, indicating the threshold percent for usage of kernel private storage below the bar that was available after kernel initialization.

    When using dynamicSEVERITY, you can specify one or more thresholds. If a threshold value for a givenSEVERITY is not specified, no exception message is issued for that level. If PVTSTG is specified along with any PVTSTG_xxx values, the PVTSTG value is ignored and the exceptionSEVERITY coincides with the specified parameters.

    Default: PVTSTG(85%)
    End of change
You can use synonyms for these parameters as follows:
Parameter Synonyms
PVTSTG_HIGH PVTSTG_H or PVTSTG_HI
PVTSTG_MED PVTSTG_M
PVTSTG_LOW PVTSTG_L
PVTSTG_NONE Start of changePVTSTG_NO, PVTSTG_NO, or PVTSTG_NEnd of change
End of change
Reference:
None.
Messages:
This check issues the following exception message:
  • BPXH072E
See the BPXH messages in z/OS MVS System Messages, Vol 3 (ASB-BPX).
SECLABEL recommended for multilevel security users:
SYSLOW - see z/OS Planning for Multilevel Security and the Common Criteria for information about using security labels.
Parent topic: z/OS UNIX System Services checks (IBMUSS)