Application Process Interval (PD_APSI)
- Organization of this page
Function
The Application Process Interval (PD_APSI) record stores performance data that shows the state at a given point in time of a process that has been set for process monitoring. This record is a multi-instance record.
- Notes:
-
-
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):
Application Name, Group ID, Monitoring Field, Monitoring Label, Monitoring Number, Parent PID, PID, Process Group ID, Program Name, Real Group ID, Real User ID, Record Time, Record Type, Snapshot Time, Start Time, State, Terminal, User ID, Virtual Env ID (Solaris or AIX)
-
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. 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 ID, Real Group ID, and User ID fields in AIX and HP-UX:
OS
Field
Content displayed
AIX
Group ID
0
Real Group ID
HP-UX
Group ID
-3
Real Group ID
User ID
-
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Log |
No |
Yes |
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_APSI_START_TIME
-
PD_APSI_PID
-
PD_APSI_APPLICATION_NAME
-
PD_APSI_MONITORING_NUMBER
Lifetime
From the time of execution of the process for which the application definition was set until the process terminates or the application definition is deleted.
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 746 bytes
Fields
PFM-View name (PFM-Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd in |
Data source |
---|---|---|---|---|---|---|
Application Name (APPLICATION_NAME) |
The name specified in the process monitoring settings |
-- |
string(64) |
No |
-- |
-- |
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 he 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) |
CPU limit for the process. This value is defined by the RLIMIT_CPU parameter of the setrlimit system call. |
-- |
double |
No |
HP-UX, Solaris, Linux |
-- |
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 |
-- |
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 Interval (PD_APSI) 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 |
-- |
-- |
Monitoring Field (MONITORING_FIELD) |
Field to be monitored |
-- |
string(16) |
No |
-- |
-- |
Monitoring Label (MONITORING_LABEL) |
Name used to identify the monitoring condition |
-- |
string(32) |
No |
-- |
-- |
Monitoring Number (MONITORING_NUMBER) |
The monitoring condition number |
-- |
word |
No |
-- |
-- |
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 |
-- |
-- |
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 |
-- |
-- |
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 second) |
-- |
float |
Yes |
HP-UX, Linux |
READ_OPS ÷ ELAPSED_TIME |
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 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 APSI. |
-- |
char(8) |
No |
-- |
-- |
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 value 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 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's 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 |