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
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
-
Fixed part: 1,034 bytes
-
Variable part: 4,500 bytes
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: 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.