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

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.

When changing the Collection Offset value, specify a value that takes into account the impact of the collection processing load.

PI_WGRP_WORKGROUP_NAME

None

• Fixed portion: 681 bytes
• Variable portion: 278 bytes

PFM-View name (PFM-Manager name)	Description	Smry	Format	Delta	Not sprtd in	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	--	(((USER_CPU_TIME + SYSTEM_CPU_TIME) INTERVAL) processors-count) 100
CPU % Each(CPU_PERCENT_USED_EACH)	CPU usage by workgroups	COPY	float	No	--	((USER_CPU_TIME + SYSTEM_CPU_TIME) INTERVAL) 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