Thresholds

Thresholds can be used to select only those summary lines (and related detail information) that contain a statistic variable matching a numerical threshold. Thresholds can only be specified for numerical statistic variables.

RACF example

In the following example, only those summary and detail lines for qualifiers with more than 10 data set profiles are printed:

    newlist type=racf
     define profcnt count
     select class=dataset segment=base
     sortlist key proftype
     summary qual profcnt(>10)

ACF2 example

In the following example, only those summary and detail lines for departments (where DEPT is a site-defined field) with more than 10 logonids are printed:

NewList Type=ACF2_LID
   Define DeptCount count
   SortList LID UID
   Summary Dept   DeptCount(>10)

The SUMMARY statement supports the use of multiple thresholds simultaneously. The following sample code reports occurrences where an assigned z/OS® UNIX System Services Home directory name is shared between z/OS UNIX root (UID=0) and regular z/OS UNIX (UID<>0) users:

RACF example

newlist type=racf, 
  title='USS HOME directory sharing between ROOT and other USS users'
  define ROOT_id(7) count where uid=0
  define USS_id(6) count where uid<>0
  select class=user segment=omvs home<>' ' uid>=0
  summary home(20) ROOT_id(>0) USS_id(>0)

ACF2 example

newlist type=acf2_info residence_type=pusr,                          
  title="USS HOME directory sharing between ROOT and other USS users"
  define   ROOT_id(7) count where uid=0                              
  define   USS_id(6) count where uid<>0                              
  select division=omvs residence_type=pusr home<>' ' uid>=0          
  summary  home ROOT_id(>0) USS_id(>0)

Note that a threshold does not change the value of the statistic variables, sums and counts; it merely hides those summary lines (and underlying summary levels or detail information) that do not match the threshold.

The following types of thresholds might be specified: >, <, >=, and <=. Per summary level, each statistic might have only one threshold; however, you might specify several summary variables with thresholds per summary level.

Warning. By default, a threshold propagates with the statistic variable to higher summary levels. This means the same numerical threshold is also applied to the higher summary levels. For the < and <= thresholds, this may lead to unexpected results, since statistic variables like COUNT and MAX tend to be larger at the higher levels. If you do not want to apply the threshold at higher summary levels, specify the NOPROP output modifier, or specify the same variable, with a different threshold, on the higher summary level.