Application Process Overview (PD_APS)

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 10 or later or AIX 6.1 or later)
  • 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 [Figure] is converted as follows:
    Source informationPost-conversion information
    Character encodingBinaryBinaryCharacter string
    Shift-JIS82602360#`
    EUCA3C12323##
    UTF-8EFBCA1232323###
  • 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:
    OSFieldContent displayed
    AIXGroupName of group with ID of 0
    Real Group
    Group ID0
    Real Group ID
    HP-UXGroupN/A gid = -3
    Real Group
    UserN/A uid = -3
    Group ID-3
    Real Group ID
    User ID

Default values and values that can be specified

ItemDefault valueModifiable
Sync Collection WithDetail Records, APP2No
LogNoNo
LOGIFBlankYes

ODBC key field

Lifetime

From the time the process executes until it terminates.

Record size

Fields

PFM-View name
(PFM-Manager name)
DescriptionSmryFormatDeltaNot sprtd inData source
Avg I/O Kbytes (AVG_IO_KBYTES)Average transfer size in I/O operations (kilobytes)--floatNoHP-UX,
AIX,
Linux
TOTAL_IO_KBYTES [Figure] TOTAL_IO_OPS
CPU % (CPU_PERCENT_USED)Average obtained by dividing the process's CPU usage by the processor count (%)--floatNo--(((USER_CPU_TIME + SYSTEM_CPU_TIME) [Figure] ELAPSED_TIME) [Figure] processors-count) [Figure] 100
CPU % Each (CPU_PERCENT_EACH)CPU usage of the process (%)--floatNo--((USER_CPU_TIME + SYSTEM_CPU_TIME) [Figure] ELAPSED_TIME) [Figure] 100
CPU Limit (CPU_LIMIT)Process CPU limit. This value is defined by the RLIMIT_CPU parameter of the setrlimit system call.--doubleNoHP-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--ulongYesHP-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.--doubleNoHP-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.--doubleNoHP-UX,
Solaris,
Linux
--
Elapsed Time (ELAPSED_TIME)Time elapsed since the process started--utimeNo--- 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
--ulongNoLinux--
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
--ulongNoLinux--
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.--doubleNoHP-UX,
Solaris,
Linux
--
Flags (FLAGS)Program flag list. If more than 120 bytes, the final character is a right angle bracket (>).--string(120)NoLinux--
Group (GROUP)Effective group name of the process--string(256)No----
Group ID (GROUP_ID)Effective group ID of the process--longNo----
Hard CPU Limit (HARD_CPU_LIMIT)Process hard CPU limit (Hcpulimit)--doubleNoHP-UX,
Solaris,
Linux
--
Hard Core Size Limit (HARD_CORE_SIZE_LIMIT)Process hard core size limit (bytes) (Hcorelimit)--doubleNoHP-UX,
Solaris,
Linux
--
Hard Data Size Limit (HARD_DATA_SIZE_LIMIT)Process hard data size limit (bytes) (Hdatalimit).--doubleNoHP-UX,
Solaris,
Linux
--
Hard File Size Limit (HARD_FILE_SIZE_LIMIT)Process hard file size limit (bytes) (Hfilesizelimit)--doubleNoHP-UX,
Solaris,
Linux
--
Hard Stack Size Limit (HARD_STACK_SIZE_LIMIT)Process hard stack size limit (bytes) (Hstacklimit)--doubleNoHP-UX,
Solaris,
Linux
--
Hard Virtual Mem Size Limit (HARD_VIRTUAL_MEMORY_SIZE_LIMIT)Process hard virtual memory size limit (bytes) (Hrsslimit)--doubleNoHP-UX,
Solaris,
Linux
--
Heap Kbytes (HEAP_KBYTES)Heap size used (kilobytes)--ulongNoHP-UX,
AIX,
Linux
--
Interval (INTERVAL)Interval at which the Application Process Overview (PD_APS) record was stored (seconds)--ulongYesHP-UX,
Solaris,
AIX,
Linux
--
Major Faults (MAJOR_FAULTS)Number of page faults that cause physical I/Os--ulongYes----
Minor Faults (MINOR_FAULTS)Number of page faults that do not cause physical I/Os--ulongYes----
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.--longNo----
PID (PID)Process ID--longNo----
Parent PID (PARENT_PID)Process ID of the parent process--longNo----
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. If the process ID of a process in the AIX 32-bit environment is 0, 0 is set.--longNo----
Process Group ID (PROCESS_GROUP_ID)Process group ID--longNo----
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.--ulongYesHP-UX,
Linux
--
Reads/sec (READ_OPS_PER_SECOND)Frequency of read operations (operations per sec)--floatYesHP-UX,
Linux
READ_OPS [Figure] 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--longNo----
Real Mem Kbytes (REAL_MEMORY_KBYTES)Physical memory size used (kilobytes)--ulongNo----
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--longNo----
Record Time (RECORD_TIME)Time at which the record was created (Greenwich Mean Time)--time_tNo----
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)NoHP-UX,
AIX,
Linux
--
Shared Mem Kbytes (SHARED_MEMORY_KBYTES)Size of the shared memory used (kilobytes)--ulongNoSolaris,
AIX
--
Signals Rcvd (NUMBER_OF_SIGNALS_RECEIVED)Number of signals received--ulongYesLinux--
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_tNo----
Stack Kbytes (STACK_KBYTES)Size of the stack being used by the process (kilobytes)--ulongNoAIX--
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.--doubleNoHP-UX,
Solaris,
Linux
--
Start Time (START_TIME)Start time of the process--time_tNo----
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: RUN, SLEEP, SWAP, STOP, ZOMBIE, NONE
--string(10)No----
Swaps (SWAPS)Number of times swapping occurred--ulongYesLinux--
System CPU (SYSTEM_CPU_TIME)Time running in kernel mode (sec)--utimeYes----
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)--floatYesAIX,
Linux
TOTAL_IO_KBYTES [Figure] ELAPSED_TIME
Total I/O Kbytes (TOTAL_IO_KBYTES)Total size transferred in I/O operations (kilobytes)--floatYesAIX,
Linux
--
Total I/O Ops (TOTAL_IO_OPS)Total number of I/O operations--ulongYesHP-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)--floatYesHP-UX,
AIX,
Linux
TOTAL_IO_OPS [Figure] 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.--ulongNo----
User CPU (USER_CPU_TIME)Time running in user mode (sec)--utimeYes----
User (USER)Effective user name of the process--string(256)No----
User ID (USER_ID)Effective user ID of the process--longNo----
Virtual Env ID (VIRTUAL_ENV_ID)ID of the virtualized environment created by the virtualized system provided by the OS--string(16)NoHP-UX,
AIX(32) 5.2,
Linux
--
Virtual Mem Kbytes (VIRTUAL_MEMORY_KBYTES)Size of the virtual memory used (kilobytes)--ulongNoSolaris--
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.--doubleNoHP-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.--ulongYesHP-UX,
Linux
--
Writes/sec (WRITE_OPS_PER_SECOND)Frequency of write operations (operations per sec)--floatYesHP-UX,
Linux
WRITE_OPS [Figure] ELAPSED_TIME
Legend:
Smry: Summary
Not sprtd in: Not supported in