Presenting data
In many cases, you can control the way that data is presented, changed, and selected on views.
- Display-only fields
- Data can be presented as a display-only field that cannot be changed.
- Entry fields
- Entry boxes allow the user to enter an attribute or parameter value.
- Selection lists
- Selection lists contain all the values available to the user for a given attribute or parameter, on this view. Where the user is asked to enter a value, you can create a selection list of appropriate values. Creating selection lists can make a view easier to use and provides an additional level of confirmation of the data by offering a choice of acceptable values to the user.
- Graphical presentations
- Depending on the type of attribute, you can choose to display your data graphically either as warning lights or as bar gauges.
Warning lights
You can use different colored warning lights to indicate the value of an attribute. You can set presentation thresholds (a single value or, for numeric attributes only, a range of values), and have a different color for each one. You can also have a flashing warning light as an extra alert for the user. Optionally, you can also display the value of the attribute next to the warning light.For example, you could indicate the severity of system availability monitoring events in your CICS® regions by using flashing red for Very High Severe (VHS) and High Severe (HS), orange for High Warning (HW) and Low Warning (LW) , and yellow for the lowest levels of severity, Low Severe (LS) and Very Low Severe (VLS). For an example of how to do this, see Using warning lights.
Bar gauges
Only attributes with numeric data types can use bar gauges. A bar gauge is a horizontal bar that represents the value of the attribute. You can also display the numerical value of the attribute, or the size of the bar gauge as a percentage of the full range, or both.You specify values for the upper and lower limits of the range, which may be either a specified fixed value or the value of the numeric attribute in the same managed object (resource table). For example, you can display the load in a CICS region as a bar gauge, by comparing current task with maximum tasks.
Within the limits, you can specify threshold values and allocate display colors in the same way as for warning lights.
Numeric data types
You can determine an attribute's data type by consulting the CICSPlex® SM Resource Tables Reference.
The resource tables reference data types shown in the following table are considered numeric and are displayed as a decimal value to one or three decimal places, using the decimal separator configured for the server:
| 1-decimal names | 3-decimal names | Description |
|---|---|---|
| AVG | AVG3 | Average |
| PCT | PCT3 | Percentage |
| RATE | RATE3 | Consumption rate |
| SUM | SUM3 | Sum of values |
- BIN
- Binary value
- CODEBIN
- CICS coded binary value
- DEC
- Decimal value
- SCLOCK and SCLOCK12 ("Count" format only)
- CMF interval store clock, 8 byte and 12 byte. These data types are only considered numeric if the "Count" formatting option is selected for the attribute. When one of the time formatting options is used, as is usually the case, the data type is not considered numeric.
- DEC
- Decimal value