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

Workgroup Summary (PI_WGRP)

Function

The Workgroup Summary (PI_WGRP) record stores the Performance data in which the data stored in the Process Detail (PD) record is summarized as the state for each workgroup at a given point in time. A record is created for each workgroup. For details about how to collect workgroup information, see 4. User-Defined Record Collection.

A workgroup named Other is automatically created for all process records that do not belong to any of the defined workgroups.

This is a multi-instance record.

Note that even if the Process Detail (PD) record is not collected, performance data is stored in the Workgroup Summary (PI_WGRP) record.

Notes:

When there are many objects to be collected because, for example, there are many processes on the machine, increased throughput results in a heavier processing load.

To change a workgroup definition, you need to restart PFM - Agent for Platform.

Group names are based on actual group names, and not on effective group names.

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

Item	Default value	Modifiable
Collection Interval	60	Yes
Collection Offset	0	Yes
Log	No	Yes
LOGIF	Blank	Yes

ODBC key fields

PI_WGRP_WORKGROUP_NAME

Lifetime

None

Record size

Fixed portion: 681 bytes

Variable portion: 278 bytes

Fields

PFM-View name
(PFM-Manager name) Description Summary Format Delta Not Supported versions Data source

Argument Lists(ARGUMENT_LISTS) Process argument list.
If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the arguments_02 parameter of the wgfile file. COPY string(30) No -- --

Avg I/O Kbytes(AVG_IO_KBYTES) Average transfer size in I/O operations (KB) COPY float No HP-UX,
AIX,
Linux TOTAL_IO_KBYTES / (READ_OPS + WRITE_OPS)

CPU %(CPU_PERCENT_USED) Average value obtained by dividing CPU usage by the number of processors (%) COPY float No -- --

CPU % Each(CPU_PERCENT_USED_EACH) CPU usage by workgroups COPY float No -- ((USER_CPU_TIME + SYSTEM_CPU_TIME) / INTERVAL) x 100

Context Switches(CONTEXT_SWITCHES) Number of times context switching was executed COPY ulong Yes HP-UX,
Linux --

Groups(GROUPS) Group name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the groups parameter of the wgfile file.
This field shows the character string specified in the groups or groups_02 parameter of the wgfile file in version 08-00 or later. COPY string(30) No -- PFM - Agent for Platform adds the process group name to this field for each process the workgroup executes.

Interval(INTERVAL) Interval at which the Workgroup Summary (PI_WGRP) record was stored (seconds) COPY ulong Yes -- When the delta value is not collected, total of the operating time of each process. When the delta value is collected, RECORD_TIME - previous record time

Major Faults(MAJOR_FAULTS) Number of page faults that cause physical I/O operations COPY ulong Yes -- --

Process Count(PROCESS_COUNT) Number of processes executed by workgroups COPY ulong No -- Number of processes in the process table that have user properties, group properties, or program properties that match the workgroup definition

Programs(PROGRAMS) Program name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the programs parameter of the wgfile file.
This field shows the character string specified in the programs or programs_02 parameter of the wgfile file in version 08-00 or later. COPY string(30) No -- PFM - Agent for Platform adds the process program name to this field for each process the workgroup executes.

Reads(READ_OPS) In AIX, this field shows the number of times RAW read operations occurred.
In Solaris, this field shows the number of times Block read operation occurred. COPY ulong Yes HP-UX,
Linux --

Reads/sec(READ_OPS_PER_SECOND) Frequency at which read operations occurred (number of operations per second) R float Yes HP-UX,
Linux READ_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup

Real Mem Kbytes(REAL_MEMORY_KBYTES) Physical memory size used (KB) COPY ulong No -- --

Record Time(RECORD_TIME) Time at which the record was created (Greenwich Mean Time) COPY time_t No -- --

Record Type(INPUT_RECORD_TYPE) Record type. Always WGRP. COPY char(8) No -- --

Swaps(SWAPS) Number of times swapping occurred COPY ulong Yes Linux --

System CPU(SYSTEM_CPU_TIME) Time during which the system ran in the kernel mode (seconds) COPY utime Yes -- --

Throughput/sec(IO_KBYTES_PER_SECOND) I/O operation speed (KB per second) R float Yes AIX,
Linux TOTAL_IO_KBYTES / total-elapsed-time-of-all-processes-executed-by-workgroup

Total I/O Kbytes(TOTAL_IO_KBYTES) Total size transferred in I/O operations (KB) COPY double Yes AIX,
Linux --

Total I/O Ops(TOTAL_IO_OPS) Number of I/O operations that occurred COPY ulong Yes HP-UX,
AIX,
Linux READ_OPS + WRITE_OPS

Total I/O Ops/sec(TOTAL_IO_OPS_PER_SECOND) Frequency at which I/O operations occurred (number of operations per second) R float Yes HP-UX,
AIX,
Linux TOTAL_IO_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup

User CPU(USER_CPU_TIME) Time during which the CPU ran in the user mode (seconds) COPY utime Yes -- --

Users(USERS) User name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the users parameter of the wgfile file.
This field shows the character string specified in the users or users_02 parameter of the wgfile file in version 08-00 or later. COPY string(30) No -- PFM - Agent for Platform adds the process user name to this field for each process the workgroup executes.

Virtual Mem Kbytes(VIRTUAL_MEMORY_KBYTES) Size of the virtual memory used (KB) COPY ulong No Solaris --

Workgroup(WORKGROUP_NAME) Workgroup name. Other is displayed if a process does not belong to any of the defined workgroups.
This field shows the character string specified in the workgroup parameter of the wgfile file. COPY string(30) No -- --

Writes(WRITE_OPS) In AIX, this field shows the number of times RAW write operations occurred.
In Solaris, this field shows the number of times Block write operation occurred. COPY ulong Yes HP-UX,
Linux --

Writes/sec(WRITE_OPS_PER_SECOND) Frequency at which write operations occurred (number of operations per second) R float Yes HP-UX,
Linux WRITE_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup

PFM-View name (PFM-Manager name)	Description	Summary	Format	Delta	Not Supported versions	Data source
Argument Lists(ARGUMENT_LISTS)	Process argument list. If the value exceeds 30 bytes, the character becomes >. This field shows the character string specified in the arguments_02 parameter of the wgfile file.	COPY	string(30)	No	--	--
Avg I/O Kbytes(AVG_IO_KBYTES)	Average transfer size in I/O operations (KB)	COPY	float	No	HP-UX, AIX, Linux	TOTAL_IO_KBYTES / (READ_OPS + WRITE_OPS)
CPU %(CPU_PERCENT_USED)	Average value obtained by dividing CPU usage by the number of processors (%)	COPY	float	No	--	--
CPU % Each(CPU_PERCENT_USED_EACH)	CPU usage by workgroups	COPY	float	No	--	((USER_CPU_TIME + SYSTEM_CPU_TIME) / INTERVAL) x 100
Context Switches(CONTEXT_SWITCHES)	Number of times context switching was executed	COPY	ulong	Yes	HP-UX, Linux	--
Groups(GROUPS)	Group name list. If the value exceeds 30 bytes, the character becomes >. This field shows the character string specified in the groups parameter of the wgfile file. This field shows the character string specified in the groups or groups_02 parameter of the wgfile file in version 08-00 or later.	COPY	string(30)	No	--	PFM - Agent for Platform adds the process group name to this field for each process the workgroup executes.
Interval(INTERVAL)	Interval at which the Workgroup Summary (PI_WGRP) record was stored (seconds)	COPY	ulong	Yes	--	When the delta value is not collected, total of the operating time of each process. When the delta value is collected, RECORD_TIME - previous record time
Major Faults(MAJOR_FAULTS)	Number of page faults that cause physical I/O operations	COPY	ulong	Yes	--	--
Process Count(PROCESS_COUNT)	Number of processes executed by workgroups	COPY	ulong	No	--	Number of processes in the process table that have user properties, group properties, or program properties that match the workgroup definition
Programs(PROGRAMS)	Program name list. If the value exceeds 30 bytes, the character becomes >. This field shows the character string specified in the programs parameter of the wgfile file. This field shows the character string specified in the programs or programs_02 parameter of the wgfile file in version 08-00 or later.	COPY	string(30)	No	--	PFM - Agent for Platform adds the process program name to this field for each process the workgroup executes.
Reads(READ_OPS)	In AIX, this field shows the number of times RAW read operations occurred. In Solaris, this field shows the number of times Block read operation occurred.	COPY	ulong	Yes	HP-UX, Linux	--
Reads/sec(READ_OPS_PER_SECOND)	Frequency at which read operations occurred (number of operations per second)	R	float	Yes	HP-UX, Linux	READ_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup
Real Mem Kbytes(REAL_MEMORY_KBYTES)	Physical memory size used (KB)	COPY	ulong	No	--	--
Record Time(RECORD_TIME)	Time at which the record was created (Greenwich Mean Time)	COPY	time_t	No	--	--
Record Type(INPUT_RECORD_TYPE)	Record type. Always WGRP.	COPY	char(8)	No	--	--
Swaps(SWAPS)	Number of times swapping occurred	COPY	ulong	Yes	Linux	--
System CPU(SYSTEM_CPU_TIME)	Time during which the system ran in the kernel mode (seconds)	COPY	utime	Yes	--	--
Throughput/sec(IO_KBYTES_PER_SECOND)	I/O operation speed (KB per second)	R	float	Yes	AIX, Linux	TOTAL_IO_KBYTES / total-elapsed-time-of-all-processes-executed-by-workgroup
Total I/O Kbytes(TOTAL_IO_KBYTES)	Total size transferred in I/O operations (KB)	COPY	double	Yes	AIX, Linux	--
Total I/O Ops(TOTAL_IO_OPS)	Number of I/O operations that occurred	COPY	ulong	Yes	HP-UX, AIX, Linux	READ_OPS + WRITE_OPS
Total I/O Ops/sec(TOTAL_IO_OPS_PER_SECOND)	Frequency at which I/O operations occurred (number of operations per second)	R	float	Yes	HP-UX, AIX, Linux	TOTAL_IO_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup
User CPU(USER_CPU_TIME)	Time during which the CPU ran in the user mode (seconds)	COPY	utime	Yes	--	--
Users(USERS)	User name list. If the value exceeds 30 bytes, the character becomes >. This field shows the character string specified in the users parameter of the wgfile file. This field shows the character string specified in the users or users_02 parameter of the wgfile file in version 08-00 or later.	COPY	string(30)	No	--	PFM - Agent for Platform adds the process user name to this field for each process the workgroup executes.
Virtual Mem Kbytes(VIRTUAL_MEMORY_KBYTES)	Size of the virtual memory used (KB)	COPY	ulong	No	Solaris	--
Workgroup(WORKGROUP_NAME)	Workgroup name. Other is displayed if a process does not belong to any of the defined workgroups. This field shows the character string specified in the workgroup parameter of the wgfile file.	COPY	string(30)	No	--	--
Writes(WRITE_OPS)	In AIX, this field shows the number of times RAW write operations occurred. In Solaris, this field shows the number of times Block write operation occurred.	COPY	ulong	Yes	HP-UX, Linux	--
Writes/sec(WRITE_OPS_PER_SECOND)	Frequency at which write operations occurred (number of operations per second)	R	float	Yes	HP-UX, Linux	WRITE_OPS / total-elapsed-time-of-all-processes-executed-by-workgroup

[Contents][Back][Next]

[Trademarks]