Generic Data Interval (PI_GENI)

Function

The Generic Data Interval (PI_GENI) is a user record that stores user-defined performance data per unit 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 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 Generic Data Detail (PD_GENI) 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 the information collected during the previous collection interval.

• When a user record is specified, objects that do not support WOW64 are not displayed in the PI_GENI-PD_GEND Record Settings dialog box of the collection data addition utility.

• To collect 64-bit performance data, use the Generic Data Interval64 (PI_GI64) record.

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

• PI_GENI_COUNTER_NAME

• PI_GENI_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,092 bytes

To Page Top

Fields

PFM-View name (PFM - Manager name 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	--	--
Float (FLOAT_DATA)	Always 0.	AVG	float	No	--	--
Instance (INSTANCE)	Instance name. Left blank for a single-instance object.	COPY	string (256)	No	--	Instance name of Performance Console
Integer (INTEGER_DATA)	Always 0.	AVG	ulong	No	--	--
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 stored value 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 GENI.	COPY	char (8)	No	--	--
String Data (STRING_DATA)	Integer-type value is displayed as a character string in the hexadecimal (0x) format.	COPY	string (256)	No	--	--

To Page Top