Hitachi

JP1 Version 12 for UNIX Systems JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference


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 [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

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

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 ÷ 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

Legend:

Smry: Summary

Not sprtd in: Not supported in