ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual—426801-001
6-36
Status Items
Z-VALUE-FOR-100
This is the value used to compute the percentage for counter-type values when
Z-USE-MAXIMUM is FALSE. If the server allows Z-USE-MAXIMUM to be
FALSE for an item, it should require that this field have a reasonable value when
performing CHECK-ITEM for the item. If Z-USE-MAXIMUM is TRUE or if this
is a busy-timer item, this field is ignored.
Z-USE-MAXIMUM
If this value is TRUE (“Y”) and this is a counter-value item, ViewPoint uses the
Z-MAXIMUM-VALUE field in the SAMPLE-ITEM response to compute a
percentage. If this value is FALSE (“N”), then ViewPoint uses Z-VALUE-FOR-
100. If the item is a busy-timer item, this value is ignored.
Z-REVERSE-SIGNIFY
This value indicates “Y” for inverted or “N” for not inverted for the status display.
You can use this value to convert an objects-up display into an objects-down display.
Z-SCALE
This value indicates the number of digits assumed to the right of a decimal point in
status values. The value can be 0, 1, or 2. This value cannot be changed by
configuration; the server should set it in the response to the CHECK-ITEM
command. For most counters, Z-SCALE should be 0. If the item is a busy-timer
item, this value is ignored.
Z-LOW-THRESHOLD and Z-HIGH-THRESHOLD
These values are percentage values (0-100). They are used as thresholds to trigger
highlighting of the display item on the status display. These values are ignored if
the respective ENABLED flags are FALSE.
Z-LOW-ENABLED and Z-HIGH-ENABLED
These are flags (“Y” or “N”) that indicate whether or not the respective thresholds
are enforced. “Y” means they are enforced.
Z-VALUE-TYPE
This is a flag (“CV” or “BT”) that indicates the basic type of the status item:
counter-value or busy-timer. This flag cannot be changed by configuration. The
server should set it in the response to the CHECK-ITEM command.
Your status server should provide default values for the fields in the STATUS-ITEM
structure when it returns the structure in response to the SCAN-ITEM and NEXT-ITEM
commands. The operator can change these values from the Status Item Configuration
screen; the server should check the changed values in response to the CHECK-ITEM
command.
The SAMPLE-ITEM command must return status values; it returns the values in 64-bit
binary entities. The two basic types of status values are busy timers and counters. The
value sampled from a busy timer is the number of microseconds that the object was