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 Service Overview (PD_ASVC)

Function

The Application Service Overview (PD_ASVC) record stores performance data that shows for a given point in time the state of an application service, such as Win32 processes, that is registered in the Service Control Manager (SCM). This record is a multi-instance record.

Notes:
  • This record can be used for real-time reports only.
  • 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 Service Name (SERVICE_NAME) field or Display Name (DISPLAY_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 Service Name (SERVICE_NAME) field corresponds to the value shown in Service Name when you open the Services property in the Service Control Manager (SCM).
  • The value of the Display Name (DISPLAY_NAME) field corresponds to the value shown in Display Name when you open the Services property in the Service Control Manager (SCM).
  • If the value of the State (STATE) field is not RUNNING, the value of the PID (ID_PROCESS) field will be 0.

Default values and values that can be specified

Item Default value Modifiable
Sync Collection With Detail Records, APP2 No
Log No No
LOGIF Blank Yes

ODBC key fields

Lifetime

From the time the service is installed until it is uninstalled.

Record size

Fields

PFM-View name
(PFM - Manager name)
Description Smry Format Delta Not sprtd on Data source
Accepted Controls (ACCEPTED_CONTROLS) Control codes received by the service.
The values in this field are all or some of the following:
PAUSE_CONTINUE: The stop is temporary, and a restart is possible.
SHUTDOWN: An OS shutdown is reported to the service.
STOP: Stopping is possible.
The following values are listed in data model version 4.1 or later:
PARAMCHANGE: The beginning parameter can be reread without a restart.
NETBINDCHANGE: The bind change can be accepted without restarting from the network.
HARDWAREPROFILECHANGE: The service is notified when the hardware profile is changed.
POWEREVENT: The service is notified when the state of the OS power supply is changed.
SESSIONCHANGE: The service is notified when the state of the OS session is changed.
-- string (128) No -- --
Checkpoint (CHECKPOINT) Checkpoint progress counter (based on an incremental method) used by the service to report progress as each step (start, stop, or continuation) is completed. If there is no such processing step, the value in this field is 0. -- long No -- --
Display Name (DISPLAY_NAME) Name used by the user interface program to identify the service -- string (257) No -- --
Image Path (IMAGE_PATH) Fully qualified path to the service's binary file -- string (4,097) No -- --
Interval (INTERVAL) Always 0 -- ulong No -- --
PID (ID_PROCESS) Process ID -- ulong No -- --
Record Time (RECORD_TIME) Time at which the record was created -- time_t No -- --
Record Type (INPUT_RECORD_TYPE) Record name. Always ASVC. -- char (8) No -- --
Service Exit Code (SERVICE_EXIT_CODE) Exit code unique to the service -- long No -- --
Service Name (SERVICE_NAME) Service name used by the service control manager database -- string (257) No -- --
Service Type (TYPE) One of the following service types:
WIN32_OWN_PROCESS: The service application runs in a process that is exclusively for the application.
WIN32_SHARE_PROCESS: The service application shares a single process with other services.
To indicate that the service process is interactive with the desktop, the following type is also listed:
  • INTERACTIVE_PROCESS
-- string (64) No -- --
State (STATE) Service state during data collection. One of the following values is used for this field:
CONTINUE_PENDING:
Starting state with the Resume button after pausing
PAUSE_PENDING:
Pausing state
PAUSED:
Paused state
RUNNING:
Running state
START_PENDING:
Starting state
STOP_PENDING:
Stopping state
STOPPED:
Stopped state
-- string (31) No -- --
Wait Hint (WAIT_HINT) Time expected to be used by the service to process the pending start, stop, or continuation processes before the service updates its state or checkpoint (milliseconds) -- ulong No -- --
Win32 Exit Code (WIN32_EXIT_CODE) Win32 exit code -- long No -- --

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