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 a new record corresponding to the Program Name (PROGRAM_NAME) field is generated during a collection interval, 0 is displayed as the first value for the following fields, because their values are computed from the information collected during the preceding collection interval:
    [Figure] CPU % (PCT_PROCESSOR_TIME)
    [Figure] IO Data Bytes/sec (IO_DATA_BYTES_PER_SEC)
    [Figure] IO Data Operations/sec (IO_DATA_OPERATIONS_PER_SEC)
    [Figure] IO Other Bytes/sec (IO_OTHER_BYTES_PER_SEC)
    [Figure] IO Other Operations/sec (IO_OTHER_OPERATIONS_PER_SEC)
    [Figure] IO Read Bytes/sec (IO_READ_BYTES_PER_SEC)
    [Figure] IO Read Operations/sec (IO_READ_OPERATIONS_PER_SEC)
    [Figure] IO Write Bytes/sec (IO_WRITE_BYTES_PER_SEC)
    [Figure] IO Write Operations/sec (IO_WRITE_OPERATIONS_PER_SEC)
    [Figure] Privileged CPU % (PCT_PRIVILEGED_TIME)
    [Figure] User CPU % (PCT_USER_TIME)
    [Figure] Page Faults/sec (PAGE_FAULTS_PER_SEC)
  • If the value in the Program Name (PROGRAM_NAME) field of this record is System or System Idle Process, the data for the Elapsed Time (ELAPSED_TIME) field may not be collected correctly. In such a case, the value for the Elapsed Time (ELAPSED_TIME) field is close to the value for the System Up Time (SYSTEM_UP_TIME) field of the System Overview (PI) record, so utilize this value.
  • 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 ###
  • The value of the Program Name (PROGRAM_NAME) field corresponds to the value shown in the Image Name column when you open the Processes tab in Windows Task Manager.

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 fields

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 on Data source
Application Name (APPLICATION_NAME) The name specified in the process monitoring settings -- string (64) No -- --
CPU % (PCT_PROCESSOR_TIME) Percentage of the elapsed processor time used by the process (%). In a multi-processor environment, usage is displayed with number of processors [Figure] 100% as the maximum value. -- double No -- --
Creating Process ID (PROCESS_ID) Process ID of the process that activated this process# -- ulong No -- --
Elapsed Time (ELAPSED_TIME) Total elapsed time for process execution (seconds)# -- utime No -- --
Group (GROUP_NAME) Name of the group to which the user who executed the process belongs. The group name is a domain name or a name pre-defined by the local system (NT AUTHORITY, computer-name, for example). If no group name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing group name cannot be acquired from the process ID, Unknown is stored. -- string (36) No -- --
Handle Count (HANDLE_COUNT) Number of handles kept open by the process# -- ulong No -- --
IO Data Bytes/sec (IO_DATA_BYTES_PER_SEC) Rate at which data was read or written in all I/O operations generated by the process (bytes/second) -- double No -- --
IO Data Operations/sec (IO_DATA_OPERATIONS_PER_SEC) Number of read and write operations in all I/O operations generated by the process (operations/second) -- double No -- --
IO Other Bytes/sec (IO_OTHER_BYTES_PER_SEC) Rate at which data was manipulated by operations other than read or write operations (control functions, for example) in all I/O operations generated by the process (bytes/second) -- double No -- --
IO Other Operations/sec (IO_OTHER_OPERATIONS_PER_SEC) Number of operations other than read or write operations (control functions, for example) in all I/O operations generated by the process (operations/second) -- double No -- --
IO Read Bytes/sec (IO_READ_BYTES_PER_SEC) Rate at which data was read in all I/O operations generated by the process (bytes/second) -- double No -- --
IO Read Operations/sec (IO_READ_OPERATIONS_PER_SEC) Number of read operations in all I/O operations generated by the process (operations/second) -- double No -- --
IO Write Bytes/sec (IO_WRITE_BYTES_PER_SEC) Rate at which data was written in all I/O operations generated by the process (bytes/second) -- double No -- --
IO Write Operations/sec (IO_WRITE_OPERATIONS_PER_SEC) Number of write operations in all I/O operations generated by the process (operations/second) -- double No -- --
Interval (INTERVAL) Always 0 -- ulong No -- --
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 -- --
PID (ID_PROCESS) Process ID. Unique identifier of the executing process -- ulong No -- --
Page Faults/sec (PAGE_FAULTS_PER_SEC) Rate at which page faults occurred in the process (faults/second) -- double No -- --
Page File Kbytes (PAGE_FILE_BYTES) Size of the virtual memory area used by the process as paging files (KB)# -- double No -- --
Page File Kbytes Peak (PAGE_FILE_BYTES_PEAK) Maximum size of the virtual memory area used by the process as paging files (KB)# -- double No -- --
Pool Nonpaged Kbytes (POOL_NONPAGED_BYTES) Size of the memory that was used by the process and that cannot be paged (KB)# -- double No -- --
Pool Paged Kbytes (POOL_PAGED_BYTES) Size of the memory that was used by the process and that can be paged (KB)# -- double No -- --
Priority Base (PRIORITY_BASE) Process base priority. The greater the value, the higher the priority. The following values are available:
[Figure] 24: Real-time
[Figure] 13: High
[Figure] 10: Higher than normal
[Figure] 8: Normal
[Figure] 6: Lower than normal
[Figure] 4: Low
-- ulong No -- --
Private Kbytes (PRIVATE_BYTES) Size of the memory that was allocated to the process and that cannot be shared with other processes (KB)# -- double No -- --
Privileged CPU % (PCT_PRIVILEGED_TIME) Percentage of the elapsed time the process used the processor in the privileged mode (%). In a multi-processor environment, usage is displayed with number of processors [Figure] 100% as the maximum value. -- double No -- --
Program Name (INSTANCE) Executing program name -- string (257) No -- --
Record Time (RECORD_TIME) Time at which the record was created -- time_t No -- --
Record Type (INPUT_RECORD_TYPE) Record name. Always APSI. -- char (8) No -- --
Start time (START_TIME) Start time of the process -- time_t No -- --
Thread Count (THREAD_COUNT) Number of threads (unit for executing an instruction) in the process. When a process is executed, at least one thread is started.# -- ulong No -- --
User (USER_NAME) Executing user name for the process.
If no user name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing user name cannot be acquired from the process ID, Unknown is stored.
-- string (36) No -- --
User CPU % (PCT_USER_TIME) Amount of processor time used by the process in the user mode (%). In a multi-processor environment, usage is displayed with number of processors [Figure] 100% as the maximum value. -- double No -- --
Virtual Kbytes (VIRTUAL_BYTES) Size of the virtual address space used by the process (KB)# -- double No -- --
Virtual Kbytes Peak (VIRTUAL_BYTES_PEAK) Maximum size of the virtual address space used by the process (KB)# -- double No -- --
Working Set Kbytes (WORKING_SET) Size of the memory used by the process (which is called a working set and indicates either the total memory size or the amount of memory that can be referenced without page faults) (KB)# -- double No -- --
Working Set Kbytes Peak (WORKING_SET_PEAK) Maximum size of the memory used by the process (which is called a working set and indicates either the total memory size or the amount of memory that can be referenced without page faults) (KB)# -- double No -- --

Legend:
Smry: Summary
Not sprtd on: Not supported on