Hitachi

JP1 Version 12 JP1/Performance Management - Remote Monitor 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 indicating the status of a process of the monitored host at a given point in time. This record is a multi-instance record.

Notes

  • Information cannot be collected if connection to the monitored host fails.

  • Each process indicates a program being executed during collection.

  • This record can be used in real-time reports only. If you try to display this record in a historical report, the error KAVJS5001-I occurs.

  • Any character in the information to be acquired 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), Command Line (COMMAND_LINE), and Virtual Env ID (VIRTUAL_ENV_ID) fields. 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:

    Information to be acquired

    Information after conversion

    Character encoding

    Binary

    Binary

    Character string

    Shift-JIS

    8260

    2360

    #`

    EUC

    A3C1

    2323

    ##

    UTF-8

    EFBCA1

    232323

    ###

  • The value in the Command Line (COMMAND_LINE) field might end in a space. Therefore, when defining a conditional expression for alarms or specifying the collection of process operation status information, note whether the value ends in a space.

  • When the OS of the monitored host is Windows, the value in the Program Name (PROGRAM_NAME) field corresponds to the value displayed in the Image Name column when the Processes tab of Windows Task Manager is clicked.

  • When the OS of the monitored host is Windows, the entire value in the Command Line (COMMAND_LINE) field might be enclosed in double quotation marks ("). When using the value in the Command Line (COMMAND_LINE) field to define a conditional expression for alarm, you must replace the double quotation marks (") with single-byte asterisks (*). For details about how to define a conditional expression for alarms, see the chapter that describes operation monitoring using an alarm in the JP1/Performance Management User's Guide.

  • When the OS of the monitored host is a UNIX environment, the values in the Program Name (PROGRAM_NAME) and Command Line (COMMAND_LINE) fields correspond to the values displayed in the COMMAND column when the following ps command is executed with C specified in the LANG environment variable:

    • In AIX: ps -A -X -o comm,args

    • In HP-UX: UNIX95=1 ps -A -o comm,args

    • In Linux: ps -e -o comm,args

    • In Solaris: ps -e -o fname,args

    The first COMMAND column is stored in the Program Name (PROGRAM_NAME) field and the second COMMAND column is stored in the Command Line (COMMAND_LINE) field. Note that the value displayed in COMMAND column differs depending on the OS.

  • When the OS of the monitored host is a UNIX environment, the value in the Terminal (TERMINAL) field corresponds to the value displayed in the TTY (TT) column when the ps command is executed. The displayed value differs depending on the OS.

  • When the OS of the monitored host is a UNIX environment, the Virtual Env ID (VIRTUAL_ENV_ID) field displays a value only if the OS of the monitored host is AIX6.1 or later or Solaris10 or later. Nothing is displayed for other OSs.

  • When the OS of the monitored host is a UNIX environment, n/a is displayed in the Terminal (TERMINAL) field for zombie processes.

  • When the OS of the monitored host is the Workload Partition (WPAR) environment of AIX V6.1 or later, the Virtual Env ID (VIRTUAL_ENV_ID) field displays Global or global.

  • Information is not collected if TargetType is set to icmp in the monitoring target settings.

Default and changeable values

Item

Default value

Changeable

Sync Collection With

Detail Records , APP2

N

Log

No

N

LOGIF

(Blank)

Y

Over 10 Sec Collection Time

No

N

Realtime Report Data Collection Mode

Reschedule

Y

Legend:

Y: Changeable

N: Not changeable

ODBC key field

PD_APS_PID

PD_APS_PROGRAM_NAME

Lifetime

From process execution to termination

Record size

Fields

PFM - View name

(PFM - Manager name)

Description

Smry rule

Grpg rule

Format

Delta

Not sprtd on

Record Type (INPUT_RECORD_TYPE)

Record name. Always APS

--

COPY

char (8)

No

--

Record Time (RECORD_TIME)

Time when the record was created

--

COPY

time_t

No

--

Interval (INTERVAL)

Always 0

--

FIXED

ulong

No

--

VA DeviceID (VADEVICEID)

Device ID of the monitored host

--

COPY

string (256)

No

--

Target Host (TARGET_HOST)

Monitored host name

--

FIXED

string (33)

No

--

Polling Time (POLLING_TIME)

Time the performance information was collected on the PFM - RM host

--

FIXED

string (32)

No

--

Target Host Time (TARGET_HOST_TIME)

Time the performance information was collected on the monitored host

--

FIXED

string (32)

No

--

PID (PID)

Process ID

--

COPY

ulong

No

--

Program Name (PROGRAM_NAME)

Program name

--

COPY

string (257)

No

--

Parent PID (PARENT_PID)

Process ID of a parent process

--

FIXED

ulong

No

--

Command Line (COMMAND_LINE)

Command line

--

FIXED

string (4097)

No

--

Terminal (TERMINAL)

Name of the terminal on which the process was executed

--

FIXED

string (40)

No

Windows

Elapsed Time (ELAPSED_TIME)

Time elapsed since the process started

--

FIXED

utime

No

--

State (STATE)

Program status. One of the following values is set:

In AIX:

IDLE, ZOMBIE, STOP, RUN, SWAP, or NONE

In HP-UX:

IDLE, OTHER, RUN, SLEEP, STOP, ZOMBIE, or NONE

In Solaris:

ONCPU, RUN, SLEEP, STOP, ZOMBIE, or NONE

In Linux:

IDLE, RUN, SLEEP, SWAP, STOP, ZOMBIE, or NONE

--

FIXED

string (10)

No

Windows

Virtual Env ID (VIRTUAL_ENV_ID)

Identifier of the virtualization environment created by the OS's virtualization system

--

FIXED

string (64)

No

Windows, HP-UX, Linux

Ext1 (EXT1)#

Extension field 1

--

AVG

double

No

All

Ext2 (EXT2)#

Extension field 2

--

AVG

double

No

All

Legend:

--: Supported on all OSs of the monitored hosts (or there is no applicable summary rule).

All: Not supported on any OS of the monitored hosts.

Smry rule: Summary rule

Grpg rule: Grouping rule

Not sprtd on: Not supported on

#

This field is not used for operations.