Hitachi

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


Application Service Overview (PD_ASVC)

Organization of this page

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.

  • If the startup type of the Windows Management Instrumentation service (service name: Winmgmt) that provides system management information for the OS is set to Disabled, the PID field cannot be collected correctly.

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