Job Management Partner 1 Version 10, Job Management Partner 1/Performance Management - Agent Option for Platform Description, User's Guide and Reference

[Contents][Glossary][Index][Back][Next]

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:

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 in a Windows Server 2003 (x64) environment, a 64-bit Windows Server 2008 environment, or a Windows Server 2012 environment, 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.

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

#
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

Lifetime

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

Record size

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

Legend:
Smry: Summary
Not sprtd on: Not supported on