Generic Data Interval64 (PI_GI64)
- Organization of this page
Function
The Generic Data Interval64 (PI_GI64) record is a user record that stores user-defined 64-bit performance data per unit of time. Because this record can store only specified performance data rather than all performance data for the collection target object, its use can reduce overhead and disk usage.
Depending on the performance data type, data is stored in one of the following two fields:
-
Double (DOUBLE_DATA)
-
String Data (STRING_DATA)
This record is a multi-instance record.
- Notes:
-
-
If the collection target instance specified by the collection data addition utility does not exist, a record whose Data Type (DATA_TYPE) field value is blank and that contains no performance data is created.
-
This record is not suitable for collecting performance data for an instance when instances with the same name are created and disappear frequently. If instances that are specified as collection targets by the collection data addition utility and that have the same name are created and disappear frequently within the same data collection interval, these separate instances are treated as the same instance, and, as a result, correct performance data cannot be collected.
-
Do not specify instances with the same name that can exist concurrently as collection targets for the collection data addition utility. When multiple instances specified as collection targets by the collection data addition utility have the same name (#n is added to the Instance (INSTANCE) field of the PI_GI64 record), and one or more of these instances disappears, the performance data for the remaining active instances with the same name may become corrupted. Also, when an instance with a duplicative name is newly generated, the performance data for the existing active instances with the same name may become corrupted.
-
If collection records are added by the collection data addition utility during a collection interval, 0 is displayed for the initial performance value for a record for which a performance value is computed from information collected during the preceding collection interval.
-
When you set user-defined records, objects that are not supported for 64-bit operation are not displayed in the PI_GI64-PD_GD64 Record Settings dialog box in the collection data addition utility.
-
This record does not support collection in a logical host environment. Collect this record in a physical host environment.
-
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Collection Interval |
60 |
Yes |
Collection Offset# |
0 |
Yes |
Log |
No |
Yes |
LOGIF |
Blank |
Yes |
Over 10 Sec Collection Time |
Yes |
No |
Realtime Report Data Collection Mode |
Reschedule |
Yes |
- #
-
A value between 0 and 32,767 seconds can be specified (a value within the range specified for Collection Interval). Use this item to distribute the collection load, because executing data collection all at once results in concentration of the processing workload. Note that the data collection duration to be recorded is the same as the Collection Interval, regardless of the value specified for Collection Offset.
ODBC key fields
-
PI_GI64_INSTANCE
-
PI_GI64_COUNTER_NAME
-
PI_GI64_OBJECT_NAME
Lifetime
After the record is added by the collection data addition utility until the record is deleted.
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 1,084 bytes
Fields
PFM-View name (PFM - Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd on |
Data source |
---|---|---|---|---|---|---|
Counter Name (COUNTER_NAME) |
Counter name |
COPY |
string (256) |
No |
-- |
Counter name of Performance Console |
Data Type (DATA_TYPE) |
Type of data accumulated in the record. The following normal values are available: • DOUBLE • STRING |
COPY |
string (12) |
No |
-- |
-- |
Double (DOUBLE_DATA) |
Value displayed as a real or integer type |
AVG |
double |
No |
-- |
-- |
Instance (INSTANCE) |
Instance name. Left blank for a single-instance object. |
COPY |
string (256) |
No |
-- |
Instance name of Performance Console |
Interval (INTERVAL) |
Collection interval during which the record was stored (seconds). For a real-time report, the first value is 5. If records are summarized into a historical report, the last value stored is displayed. |
COPY |
ulong |
No |
-- |
RECORD_TIME (T1) - RECORD_TIME (T0) |
Interval2 (INTERVAL2) |
Collection interval during which the record was stored (seconds). For a real-time report, the first value is 5. If records are summarized into a historical report, the total of the summarized records is displayed. |
ADD |
ulong |
No |
-- |
RECORD_TIME (T1) - RECORD_TIME (T0) |
Object Name (OBJECT_NAME) |
Object name |
COPY |
string (256) |
No |
-- |
Object name of Performance Console |
Record Time (RECORD_TIME) |
Time at which the record was created |
COPY |
time_t |
No |
-- |
-- |
Record Type (INPUT_RECORD_TYPE) |
Record name. The default record name is GI64. |
COPY |
char (8) |
No |
-- |
-- |
String Data (STRING_DATA) |
Integer-type value displayed as a character string in hexadecimal (0x) |
COPY |
string (256) |
No |
-- |
-- |