ASAP 2.7 Extension Manual

Configuring the ASAP Extension
HP NonStop ASAP Extension Manual—425265-004
2-9
Configuring DataItems
are REAL numbers stored in scientific notation with a possible range up to
approximately 1.15792E78, accurate to approximately 17 digits.
The applications can update data in the DataItem structure by calling ASAP_UPDATE_
to update a single DataItem or ASAP_UPDATELIST_ to update many DataItems. The
procedures normally add the supplied value to the existing value in memory. The
replace function, which replaces the DataItem with the supplied value, is useful when
you deal with constant values such as states and alerts.
For an application to use any of the 12 DataItems, you must first define them to
ASAPX using the EDL DATAITEMS statement. The statement has two parameters
enclosed in quotes. The first parameter contains the item identifiers, 0 through 11. The
second parameter contains the base types of the data values:
Example: DATAITEMS EDL Property
ENTITY EXAMPLE
CI ASAP
Command “APP\*EXAMPLE,RAW,TAB,DETAIL,STATE,AGGREGATEONLY“
DataItems “0 I, 1 I, 2 U, 3 M, 4 S, 5 C“
Detail “APP ^,TAB,DETAIL,STATE,AGGREGATE,MINSTATE,COUNT 20“
Enabled Yes
ErrorState ErrorState
Help “EXAMPLE Application“
KeyForNode NodeName
KeyForObj Domain
KeyForRow “Dateymd Time“
MaxObjectives 100
SGPFile “$System.System.ASAPXSGP“
SGPManaged Yes
SGPSuffix H;
I Defines the DataItem as an integer value. The difference between samples is used
for metric calculations.
S Defines the DataItem as containing a count of seconds. The difference between
samples is used for metric calculations.
M Defines the DataItem as containing a count of milliseconds. The difference between
samples is used for metric calculations after first normalizing the value to seconds.
U Defines the DataItem as containing a count of microseconds. The difference
between samples is used for metric calculations after first normalizing the value to
seconds.
C Defines the DataItem as containing a constant value. The value itself is used for
metric calculations. Applications should use the replace function of the
ASAP_UPDATE_ procedure when updating constant values.
T Defines the DataItem as an 8-byte string of printable ASCII characters. Applications
should use the replace text function (math=2) when updating text DataItems.