Generic Data Interval64 (PI_GI64)

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.

To Page Top

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.

To Page Top

ODBC key fields

• PI_GI64_INSTANCE

• PI_GI64_COUNTER_NAME

• PI_GI64_OBJECT_NAME

To Page Top

Lifetime

After the record is added by the collection data addition utility until the record is deleted.

To Page Top

Record size

• Fixed portion: 681 bytes

• Variable portion: 1,084 bytes

To Page Top

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	--	--

To Page Top