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 Interval (PD_APSI)

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 10 and later or AIX 6.1 and later)
  • 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 [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 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
Sync Collection With Detail Records, APP2 No
Log No Yes
LOGIF Blank Yes

ODBC key field

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

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 [Figure] 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) [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) 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. 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 -- --
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 [Figure] 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: 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 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(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'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 [Figure] ELAPSED_TIME

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