Entering Search Criteria

Before you can view information about completed PMUs, you need to enter criteria so that you can locate the appropriate completed PMUs.

Use the Advanced Search link to expose all search criteria.

The maximum rows that are returned by the search depends on the value in the Search Row Limit field on the Global Administration page.

See Setting Global System Options.

Field or Control Description

System ID

Identifies each monitored system. PeopleSoft automatically generates this value incrementally. System definitions are created automatically when the first agent of a monitored system registers with the monitoring system.

Database Name

The name of the PeopleSoft application database running on the monitored system. The monitoring system automatically inserts this value when it recognizes and creates a monitored system.

User ID

If you want information for a particular user, enter the user ID of the user for which you want to track completed PMUs.

This field prompts against the PSPMOPRDEFN table.

Process ID

Enables you to search completed PMUs by the process ID.

Performance Trace Name

If a user has launched a performance trace in the Performance Trace Console, the system labels every PMU that is generated in a business process with a performance trace name. Select the appropriate trace name to view its results.

The Performance Trace Name field prompts against the PSPMPERFTRACE table, which the Lookup program (PSPM_LOOKUP) populates.

Component

If you want information for a particular component, enter the name of the component for which you want to track completed PMUs.

This field prompts against the PSPMPNLGRPDEFN table.

Note: Searching on a component is equivalent to searching on Context 1 for application server PMUs.

Market

Enter the market that is associated with the component.

PMU Definition Set

Indicates the set to which the PMU definition belongs. A PMU definition set is similar to a message set.

This is required if you want to generate metric and duration charts.

PMU Identifier

Identifies the PMU definition within a PMU definition set.

This is required if you want to generate metric and duration charts.

Context 1, 2, 3

PMU metrics contain data that is specific to that PMU. Context values, on the other hand, are common to the entire user request or a specific tier. For example, the component name is stored in a context. The system uses contexts to "flatten" a PMU tree. For example, you do not have to navigate up from a SQL PMU to an ICPanel PMU to see what component generated that SQL statement. In some cases, PMU types are shared across different user request types. In such cases, the label for the PMU will be generic. Use the Context Help button to view the context definitions for a PMU set ID and ID that you've entered.

PMU Status

Displays the PMU status.

See Completed PMU Status.

Top Instance

Each PMU that is reported by an agent has a unique instance ID. The instance identifier of the first PMU generated by a particular user request is the top instance. The value of the top instance is then stored with every child PMU within a request. The top instance is the associating value for all PMUs that are generated by the same user request.

Statement Number

This search field applies only when you are searching for PeopleCode SQL PMUs, which are PMU 406 (PeopleCode SQL Execute) and PMU 407 (PeopleCode Built-in SQL Execute). The Context 2 field contains the PeopleCode program name andMetric 2 contains the statement number in the PeopleCode where the SQL was executed.

To search by statement number, you must enter the following search criteria: PMU Definition Set = 1, PMU ID = 406 or 407, and Context 2 must have the name of a PeopleCode program.

From Date/Time To Date/Time

Specify a range of time in which the system should search for completed PMUs.

The system searches on the monitor date and time, not the agent date and time.

Duration

Specify criteria that is related to the duration of a PMU in milliseconds.

Domain Name

Select the application server domain to generate the PMUs.

Domain Host/Port

Select the name and port number of the server machine on which the domain that generated the PMU resides.

Agent Identifier

Identify the specific agent that monitored a PMU.

Agent Type

Identify the type of agent that monitored a PMU.

Search

The Search button performs a search based on the search criteria that is defined on the page. If you want to view the most current information, use theRefresh button after running the initial search. If you clickSearch repeatedly, the system returns the same results from the same time range for each search.

Refresh

Updates the value in the To Time field to equal the current time and performs a search. This enables you to view the most current results of a search.