Application Process Overview (PD_APS)
- Organization of this page
Function
The Application Process Overview (PD_APS) record stores performance data that shows the state of a process at a given point in time. One record is created per existing process ID in the system. This record is a multi-instance record.
- Notes:
-
-
This record can be used for real-time reports only.
-
Each process represents a program that is being executed during data collection.
-
If the process does not have a terminal name, ?? is displayed in the Terminal (TERMINAL_NAME) field.
-
In AIX and Solaris, only data for the fields shown below is acquired for <defunct> processes (0 or n/a is displayed for all other fields):
Child Process List, Command Line, Flags, Group, Group ID, Parent PID, Parent Process List, PID, Process Group ID, Program Name, Program/PID, Real Group, Real Group ID, Real User, Real User ID, Record Time, Record Type, Scheduler Class, Snapshot Time, Start Time, State, Terminal, User, User ID, Virtual Env ID (Solaris or AIX)
-
An error (KAVJS5001-I) results if you attempt to display a historical report of this record.
-
Any character in the source information that is not in the ASCII character set range of 0x20 to 0x7E will be converted to a hash mark (#: 0x23) before it is stored in the Program Name (PROGRAM_NAME) field or Command Line (COMMAND_LINE) field. Note that multi-byte characters are processed in single-byte units during conversion. For example, the multi-byte (full-width) letter is converted as follows:
Source information
Post-conversion information
Character encoding
Binary
Binary
Character string
Shift-JIS
8260
2360
#`
EUC
A3C1
2323
##
UTF-8
EFBCA1
232323
###
-
If the target process of an instance is a zombie process, the following are displayed for the Group, Group ID, Real Group, Real Group ID, User, and User ID fields in AIX and HP-UX:
OS
Field
Content displayed
AIX
Group
Name of group with ID of 0
Real Group
Group ID
0
Real Group ID
HP-UX
Group
N/A gid = -3
Real Group
User
N/A uid = -3
Group ID
-3
Real Group ID
User ID
-
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Log |
No |
No |
LOGIF |
Blank |
Yes |
Over 10 Sec Collection Time |
No |
No |
Sync Collection With |
Detail Records, APP2 |
No |
Realtime Report Data Collection Mode |
Reschedule |
Yes |
ODBC key field
-
PD_APS_START_TIME
-
PD_APS_PID
Lifetime
From the time the process executes until it terminates.
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 6,421 bytes
Fields
PFM-View name (PFM-Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd in |
Data source |
---|---|---|---|---|---|---|
Avg I/O Kbytes (AVG_IO_KBYTES) |
Average transfer size in I/O operations (kilobytes) |
-- |
float |
No |
HP-UX, AIX, Linux |
TOTAL_IO_KBYTES ÷ TOTAL_IO_OPS |
CPU % (CPU_PERCENT_USED) |
Average obtained by dividing the process's CPU usage by the processor count (%) |
-- |
float |
No |
-- |
(((USER_CPU_TIME + SYSTEM_CPU_TIME) ÷ ELAPSED_TIME) ÷ processors-count) × 100 |
CPU % Each (CPU_PERCENT_EACH) |
CPU usage of the process (%) |
-- |
float |
No |
-- |
((USER_CPU_TIME + SYSTEM_CPU_TIME) ÷ ELAPSED_TIME) × 100 |
CPU Limit (CPU_LIMIT) |
Process CPU limit. This value is defined by the RLIMIT_CPU parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Child Process List (CHILD_PROCESS_LIST) |
List of child processes created. Child processes are delimited by a space. If more than 128 bytes, the final character is a right angle bracket (>). |
-- |
string(128) |
No |
-- |
Searches for child chain on process list. |
Command Line (COMMAND_LINE) |
Command line |
-- |
string(4097) |
No |
-- |
-- |
Context Switches (CONTEXT_SWITCHES) |
Number of context switch operations |
-- |
ulong |
Yes |
HP-UX, Linux |
-- |
Core Size Limit (CORE_SIZE_LIMIT) |
Maximum size of a core file that can be created by the process (bytes). This value is defined by the RLIMIT_CORE parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Data Size Limit (DATA_SIZE_LIMIT) |
Process data size limit (bytes). This value is defined by the RLIMIT_DATA parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Elapsed Time (ELAPSED_TIME) |
Time elapsed since the process started |
-- |
utime |
No |
-- |
- If process is running, RECORD_TIME - START_TIME - If process is not running, -- |
Executable Data Kbytes (EXECUTABLE_DATA_KBYTES) |
Size of the data being used (kilobytes). For Solaris to collect this field, the SAUNIXPMAP environment variable must have been set in advance. Execute the following commands from the command line: # SAUNIXPMAP=1 # export SAUNIXPMAP |
-- |
ulong |
No |
Linux |
-- |
Executable Text Kbytes (EXECUTABLE_TEXT_KBYTES) |
Size of the text being used (kilobytes). For Solaris to collect this field, the SAUNIXPMAP environment variable must have been set in advance. Execute the following commands from the command line: # SAUNIXPMAP=1 # export SAUNIXPMAP |
-- |
ulong |
No |
Linux |
-- |
File Size Limit (FILE_SIZE_LIMIT) |
Process file size limit (bytes). This value is defined by the RLIMIT_FSIZE parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Flags (FLAGS) |
Program flag list. If more than 120 bytes, the final character is a right angle bracket (>). |
-- |
string(120) |
No |
Linux |
-- |
Group (GROUP) |
Effective group name of the process |
-- |
string(256) |
No |
-- |
-- |
Group ID (GROUP_ID) |
Effective group ID of the process |
-- |
long |
No |
-- |
-- |
Hard CPU Limit (HARD_CPU_LIMIT) |
Process hard CPU limit (Hcpulimit) |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Hard Core Size Limit (HARD_CORE_SIZE_LIMIT) |
Process hard core size limit (bytes) (Hcorelimit) |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Hard Data Size Limit (HARD_DATA_SIZE_LIMIT) |
Process hard data size limit (bytes) (Hdatalimit). |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Hard File Size Limit (HARD_FILE_SIZE_LIMIT) |
Process hard file size limit (bytes) (Hfilesizelimit) |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Hard Stack Size Limit (HARD_STACK_SIZE_LIMIT) |
Process hard stack size limit (bytes) (Hstacklimit) |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Hard Virtual Mem Size Limit (HARD_VIRTUAL_MEMORY_SIZE_LIMIT) |
Process hard virtual memory size limit (bytes) (Hrsslimit) |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Heap Kbytes (HEAP_KBYTES) |
Heap size used (kilobytes) |
-- |
ulong |
No |
HP-UX, AIX, Linux |
-- |
Interval (INTERVAL) |
Interval at which the Application Process Overview (PD_APS) record was stored (seconds) |
-- |
ulong |
Yes |
HP-UX, Solaris, AIX, Linux |
-- |
Major Faults (MAJOR_FAULTS) |
Number of page faults that cause physical I/Os |
-- |
ulong |
Yes |
-- |
-- |
Minor Faults (MINOR_FAULTS) |
Number of page faults that do not cause physical I/Os |
-- |
ulong |
Yes |
-- |
-- |
Niceness (NICENESS) |
Process niceness. The scheduler class assigned to the process affects the value. For example, if a task is assigned to scheduler class RT, its niceness value is 0. |
-- |
long |
No |
-- |
-- |
PID (PID) |
Process ID |
-- |
long |
No |
-- |
-- |
Parent PID (PARENT_PID) |
Process ID of the parent process |
-- |
long |
No |
-- |
-- |
Parent Process List (PARENT_PROCESS_LIST) |
List of parent processes. For example, 3867 < 1 < 0 means that process 0 created process 1, and process 1 created process 3867. If more than 128 bytes, the final character is a right angle bracket (>). |
-- |
string(128) |
No |
-- |
Searches for parent chain on the list of processes. |
Priority (PRIORITY) |
Process priority |
-- |
long |
No |
-- |
-- |
Process Group ID (PROCESS_GROUP_ID) |
Process group ID |
-- |
long |
No |
-- |
-- |
Program Name (PROGRAM_NAME) |
Program name |
-- |
string(257) |
No |
-- |
-- |
Program/PID (PROGRAM_PID) |
Name of the program executed and a process ID |
-- |
string(280) |
No |
-- |
-- |
Reads (READ_OPS) |
In AIX, the number of RAW read operations that occurred. In Solaris, the number of Block read operations that occurred. |
-- |
ulong |
Yes |
HP-UX, Linux |
-- |
Reads/sec (READ_OPS_PER_SECOND) |
Frequency of read operations (operations per sec) |
-- |
float |
Yes |
HP-UX, Linux |
READ_OPS ÷ ELAPSED_TIME |
Real Group (REAL_GROUP) |
Real group name of the process |
-- |
string(256) |
No |
-- |
-- |
Real Group ID (REAL_GROUP_ID) |
Real group ID of the process |
-- |
long |
No |
-- |
-- |
Real Mem Kbytes (REAL_MEMORY_KBYTES) |
Physical memory size used (kilobytes) |
-- |
ulong |
No |
-- |
-- |
Real User (REAL_USER) |
Real user name of the process |
-- |
string(256) |
No |
-- |
-- |
Real User ID (REAL_USER_ID) |
Real user ID of the process |
-- |
long |
No |
-- |
-- |
Record Time (RECORD_TIME) |
Time at which the record was created (Greenwich Mean Time) |
-- |
time_t |
No |
-- |
-- |
Record Type (INPUT_RECORD_TYPE) |
Record type. Always APS. |
-- |
char(8) |
No |
-- |
-- |
Scheduler Class (SCHEDULER_CLASS) |
Scheduler class name. One of the following values is set: TS, IA, FX, FSS, RT, SYS |
-- |
string(12) |
No |
HP-UX, AIX, Linux |
-- |
Shared Mem Kbytes (SHARED_MEMORY_KBYTES) |
Size of the shared memory used (kilobytes) |
-- |
ulong |
No |
Solaris, AIX |
-- |
Signals Rcvd (NUMBER_OF_SIGNALS_RECEIVED) |
Number of signals received |
-- |
ulong |
Yes |
Linux |
-- |
Snapshot Time (LAST_SNAPSHOT_TIME) |
Time at which the last process table information was acquired. Shows the record time if the process table contains no information. |
-- |
time_t |
No |
-- |
-- |
Stack Kbytes (STACK_KBYTES) |
Size of the stack being used by the process (kilobytes) |
-- |
ulong |
No |
AIX |
-- |
Stack Size Limit (STACK_SIZE_LIMIT) |
Process stack size limit (bytes). This value is defined by the RLIMIT_STACK parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Start Time (START_TIME) |
Start time of the process |
-- |
time_t |
No |
-- |
-- |
State (STATE) |
Process state. One of the following values is set: - For AIX: IDLE, ZOMBIE, STOP, RUN, SWAP, NONE - For HP-UX: IDLE, OTHER, RUN, SLEEP, STOP, ZOMBIE, NONE - For Solaris: IDLE, ONCPU, RUN, SLEEP, STOP, ZOMBIE, NONE - For Linux: IDLE, RUN, SLEEP, SWAP, STOP, ZOMBIE, NONE |
-- |
string(10) |
No |
-- |
-- |
Swaps (SWAPS) |
Number of times swapping occurred |
-- |
ulong |
Yes |
Linux |
-- |
System CPU (SYSTEM_CPU_TIME) |
Time running in kernel mode (sec) |
-- |
utime |
Yes |
-- |
-- |
Terminal (TERMINAL_NAME) |
Name of the executing terminal. If the process does not have a terminal name, ?? is displayed. |
-- |
string(40) |
No |
-- |
-- |
Throughput/sec (IO_KBYTES_PER_SECOND) |
I/O operation speed (kilobytes/sec) |
-- |
float |
Yes |
AIX, Linux |
TOTAL_IO_KBYTES ÷ ELAPSED_TIME |
Total I/O Kbytes (TOTAL_IO_KBYTES) |
Total size transferred in I/O operations (kilobytes) |
-- |
float |
Yes |
AIX, Linux |
-- |
Total I/O Ops (TOTAL_IO_OPS) |
Total number of I/O operations |
-- |
ulong |
Yes |
HP-UX, AIX, Linux |
READ_OPS + WRITE_OPS |
Total I/O Ops/sec (TOTAL_IO_OPS_PER_SECOND) |
Frequency of I/O operations (operations per sec) |
-- |
float |
Yes |
HP-UX, AIX, Linux |
TOTAL_IO_OPS ÷ ELAPSED_TIME |
Total Process Kbytes (TOTAL_PROCESS_KBYTES) |
Process size (kilobytes). In AIX, this field is the same as the value displayed in the SZ column obtained with the ps -l command. In HP-UX and Solaris, this value is the same as the value displayed in the SZ column obtained with the ps -l command multiplied by the page size. In Linux, this value is the same as the value displayed in the SIZE column obtained with the top command. |
-- |
ulong |
No |
-- |
-- |
User CPU (USER_CPU_TIME) |
Time running in user mode (sec) |
-- |
utime |
Yes |
-- |
-- |
User (USER) |
Effective user name of the process |
-- |
string(256) |
No |
-- |
-- |
User ID (USER_ID) |
Effective user ID of the process |
-- |
long |
No |
-- |
-- |
Virtual Env ID (VIRTUAL_ENV_ID) |
ID of the virtualized environment created by the virtualized system provided by the OS |
-- |
string(65) |
No |
HP-UX |
-- |
Virtual Mem Kbytes (VIRTUAL_MEMORY_KBYTES) |
Size of the virtual memory used (kilobytes) |
-- |
ulong |
No |
Solaris |
-- |
Virtual Mem Size Limit (VIRTUAL_MEMORY_SIZE_LIMIT) |
Size limit of the process virtual memory (bytes) (rsslimit). This value is defined by the RLIMIT_VMEM parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
Writes (WRITE_OPS) |
In AIX, the number of RAW write operations that occurred. In Solaris, the number of Block write operations that occurred. |
-- |
ulong |
Yes |
HP-UX, Linux |
-- |
Writes/sec (WRITE_OPS_PER_SECOND) |
Frequency of write operations (operations per sec) |
-- |
float |
Yes |
HP-UX, Linux |
WRITE_OPS ÷ ELAPSED_TIME |