Job Management Partner 1 Version 10, Job Management Partner 1/Performance Management - Agent Option for Platform Description, User's Guide and Reference

[Contents][Glossary][Index][Back][Next]

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 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
Sync Collection With Detail Records, APP2 No
Log No No
LOGIF Blank Yes

ODBC key field

Lifetime

From the time the process executes until it terminates.

Record size

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 [Figure] 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) [Figure] ELAPSED_TIME) [Figure] processors-count) [Figure] 100
CPU % Each (CPU_PERCENT_EACH) CPU usage of the process (%) -- float No -- ((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. -- 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. If the process ID of a process in the AIX 32-bit environment is 0, 0 is set. -- 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 [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 -- 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: 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 [Figure] 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 [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. -- 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(16) No HP-UX,
AIX(32) 5.2,
Linux
--
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 [Figure] ELAPSED_TIME

Legend:
Smry: Summary
Not sprtd in: Not supported in