Workgroup Summary (PI_WGRP)
- Organization of this page
Function
The Workgroup Summary (PI_WGRP) record stores the performance data that summarizes the records stored in the Process Detail (PD) record, by workgroups at a given point in time.
One record is stored for each workgroup. This is a multi-instance record.
To store all process records that do not belong to any of the defined workgroups, a workgroup named Other is automatically created.
- Notes:
-
-
You must specify workgroup information by using the collection data addition utility. For details about workgroup information and the collection data addition utility, see 6. User-Defined Record Collection.
-
If the value of the Program (INSTANCE) field is _Total and the value of the PID (ID_PROCESS) field is 0 in the Process Detail (PD) record, its data expresses a total or average, and thus the record is not collected.
-
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.
-
This record does not support collection in a logical host environment. Collect this record in a physical host environment.
-
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Log |
No |
Yes |
LOGIF |
Blank |
Yes |
Over 10 Sec Collection Time |
Yes |
No |
Sync Collection With |
Detail Records, PD |
No |
Realtime Report Data Collection Mode |
Reschedule |
Yes |
ODBC key fields
-
PI_WGRP_WORKGROUP_NAME
-
PI_WGRP_CONDITION
Lifetime
From the time a record is added by the collection data addition utility until the record is deleted.
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 608 bytes
Fields
PFM-View name (PFM - Manager name name) |
Description |
Smry |
Format |
Delta |
Not sprtd on |
Data source |
---|---|---|---|---|---|---|
CPU % (PCT_PROCESSOR_TIME) |
Percentage of the elapsed processor time used by workgroups (%). In a multi-processor environment, usage is displayed, with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
% |
double |
No |
-- |
PD record PCT_PROCESSOR_TIME field |
Condition (CONDITION) |
Workgroup collection condition. The following values are available: - AND: Collects process whose Groups, Users, and Programs fields all match the conditions. - OR: Collects process whose Groups, Users, or Programs field matches the conditions. |
COPY |
string (4) |
No |
-- |
Workgroup name of the collection data addition utility |
Groups (GROUPS) |
Defined group name. If the group name is longer than 35 bytes, the first 35 bytes are saved and the last character becomes [>]. |
COPY |
string (36) |
No |
-- |
Group name of the collection data addition utility |
Handle Count (HANDLE_COUNT) |
Number of handles kept open by workgroups. |
HILO |
double |
No |
-- |
PD record HANDLE_COUNT field |
IO Data Bytes/sec (IO_DATA_BYTES_PER_SEC) |
Rate at which data was read or written in all I/O operations generated by workgroups (bytes/second). |
AVG |
double |
No |
-- |
PD record IO_DATA_BYTES_PER_SEC field |
IO Data Operations/sec (IO_DATA_OPERATIONS_PER_SEC) |
Number of read and write operations in all I/O operations generated by workgroups (operations/second). |
AVG |
double |
No |
-- |
PD record IO_DATA_OPERATIONS_PER_SEC field |
IO Other Bytes/sec (IO_OTHER_BYTES_PER_SEC) |
Rate at which data was manipulated by operations other than read or write operations (control functions, for example) in all I/O operations generated by workgroups (bytes/second). |
AVG |
double |
No |
-- |
PD record IO_OTHER_BYTES_PER_SEC field |
IO Other Operations/sec (IO_OTHER_OPERATIONS_PER_SEC) |
Number of operations other than read or write operations (control functions, for example) in all I/O operations generated by workgroups (operations/second). |
AVG |
double |
No |
-- |
PD record IO_OTHER_OPERATIONS_PER_SEC field |
IO Read Bytes/sec (IO_READ_BYTES_PER_SEC) |
Rate at which data was read in all I/O operations generated by workgroups (bytes/second). |
AVG |
double |
No |
-- |
PD record IO_READ_BYTES_PER_SEC field |
IO Read Operations/sec (IO_READ_OPERATIONS_PER_SEC) |
Number of read operations in all I/O operations generated by workgroups (operations/second). |
AVG |
double |
No |
-- |
PD record IO_READ_OPERATIONS_PER_SEC field |
IO Write Bytes/sec (IO_WRITE_BYTES_PER_SEC) |
Rate at which data was written in all I/O operations generated by workgroups (bytes/second). |
AVG |
double |
No |
-- |
PD record IO_WRITE_BYTES_PER_SEC field |
IO Write Operations/sec (IO_WRITE_OPERATIONS_PER_SEC) |
Number of write operations in all I/O operations generated by workgroups (operations/second). |
AVG |
double |
No |
-- |
PD record IO_WRITE_OPERATIONS_PER_SEC field |
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) |
Page Faults/sec (PAGE_FAULTS_PER_SEC) |
Rate at which page faults occurred inside workgroups (faults/second). |
AVG |
double |
No |
-- |
PD record PAGE_FAULTS_PER_SEC field |
Page File Kbytes (PAGE_FILE_BYTES) |
Size of the virtual memory area used by workgroups in paging files (KB). |
AVG |
double |
No |
-- |
PD record PAGE_FILE_BYTES field |
Pool Nonpaged Kbytes (POOL_NONPAGED_BYTES) |
Size of non-pageable memory used by workgroups (KB). |
AVG |
double |
No |
-- |
PD record POOL_NONPAGED_BYTES field |
Pool Paged Kbytes (POOL_PAGED_BYTES) |
Size of pageable memory used by workgroups (KB). |
AVG |
double |
No |
-- |
PD record POOL_PAGED_BYTES field |
Private Kbytes (PRIVATE_BYTES) |
Size of the memory that was allocated to a workgroup and could not be shared with other processes (KB). |
AVG |
double |
No |
-- |
PD record PRIVATE_BYTES field |
Privileged CPU % (PCT_PRIVILEGED_TIME) |
Percentage of the elapsed time the workgroup used the processor in the privileged mode (%). In a multi-processor environment, usage is displayed with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
% |
double |
No |
-- |
PD record PCT_PRIVILEGED_TIME field |
Process Count (PROCESS_COUNT) |
Number of processes executed by workgroups. |
HILO |
ulong |
No |
-- |
-- |
Programs (PROGRAMS) |
Defined program name. If the group name is longer than 35 bytes, the first 35 bytes are saved and the last character becomes [>]. |
COPY |
string (36) |
No |
-- |
Program name of the collection data addition utility |
Record Time (RECORD_TIME) |
Time at which the record was created. |
COPY |
time_t |
No |
-- |
-- |
Record Type (INPUT_RECORD_TYPE) |
Record name. Always WGRP. |
COPY |
char (8) |
No |
-- |
-- |
Thread Count (THREAD_COUNT) |
Number of threads (unit for executing instructions) inside a workgroup. When a workgroup is executed, at least one thread is started. |
HILO |
double |
No |
-- |
PD record THREAD_COUNT field |
User CPU % (PCT_USER_TIME) |
Amount of processor time used by workgroups in the user mode (%). In a multi-processor environment, usage is displayed with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
% |
double |
No |
-- |
PD record PCT_USER_TIME field |
Users (USERS) |
Defined user name. If the group name is longer than 35 bytes, the first 35 bytes are saved and the last character becomes [>]. |
COPY |
string (36) |
No |
-- |
User name of the collection data addition utility |
Virtual Kbytes (VIRTUAL_BYTES) |
Size of the virtual address space being used by workgroups (KB). |
AVG |
double |
No |
-- |
PD record VIRTUAL_BYTES field |
Workgroup (WORKGROUP_NAME) |
Defined workgroup name. |
COPY |
string (36) |
No |
-- |
Workgroup name of the collection data addition utility |
Working Set Kbytes (WORKING_SET) |
Amount of memory used by workgroups (this memory is called a working set, and indicates either the total memory size or the amount of memory that can be referenced without page faults) (KB). |
AVG |
double |
No |
-- |
PD record WORKING_SET field |