RANGE entries are utility entries that
store range definitions. Range definitions are used in conjunction
with FRAME entries to control traffic lighting for Text Entry objects
and Critical Success Factor objects. You use the BUILD procedure's
RANGE window to edit the range definition in a RANGE entry.
A range definition can
consist of up to 24 segments. Each segment defines the range of values
that match that segment, as well as the color and highlighting attributes
that are applied to values that match the segment. For each segment,
you can define the following attributes:
Lower value
specifies a numeric
minimum value for the range segment. This value can be omitted for
the first segment, implying that all values lower than or equal to
the Upper value match the first segment.
If a statistic has
been defined for the segment, you cannot modify the Lower value attribute.
If the Lower value
of the current segment is the same as the Upper value of the preceding
segment, then the segments are contiguous, and the specified Lower
value is not inclusive in the current segment. That is, a value must
be greater than the Lower value in order to match the current segment.
Values that are equal to the Lower value match the preceding segment.
If the Lower value of the current segment is not the same as the Upper
value of the preceding segment, then the segments are noncontiguous.
In this case, values that are equal to the Lower value do match the
current segment.
Upper value
specifies a numeric
maximum value for the range segment. This value can be omitted for
the last segment in the range definition, implying that all values
greater than the Lower value (and equal to the Lower value, if the
segment is noncontiguous) match the last segment.
If a statistic has
been defined for the segment, you cannot modify the Upper value attribute.
Color
specifies the color
for the segment. In the RANGE window, you can select the down arrow
control in the Color field to obtain a list
of valid colors, or select the right arrow control to define a custom
color. You must specify a color for each segment that has range values.
The RANGE window includes a Color scale bar
that shows which colors have been selected for the defined segments.
Attribute
specifies a highlighting
attribute for the segment. In the RANGE window, you can select the
down arrow control in the Attribute field
to obtain a list of valid display attributes. The default is NONE.
Statistics data set
specifies a data set
and variable to be used in computing the statistics for the lower
and upper values of the range segment, as an alternative to specifying
range values for the Lower value and Upper value attributes.
By default, the statistics
are computed and stored when the RANGE entry is built. However, you
can choose to refresh the statistics when the RANGE entry is used.
Formats
specifies an informat
and a format for the range segment. The informat is used to convert
character values to numeric values for comparison purposes. The format
is used to display values in Critical Success Factor (CSF) objects.