Caché Monitoring Guide - InterSystems Documentation

Scheduling the ^pButtons Utility with Task Manager
__.html, where is the hostname of the system on which the instance of Caché
is running; is the name of the instance for which performance data has been collected; and is the
unique identifier specified when the ^pButtons utility was run.
Note:
For descriptions of the platform-specific information displayed in the performance report, see Performance Reports
Created by ^pButtons Utility in this chapter.
For All Runs
To generate a readable (HTML) performance report for all profiles that have finished running:
1. Enter the following command, which is case-sensitive and must be run in the %SYS namespace, in the Caché Terminal:
%SYS> do Collect^pButtons()
2. Open the HTML reports in any supported browser.
For Specific Runs
To generate a readable (HTML) performance report for a specific :
1. Enter the following command, which is case-sensitive and must be run in the %SYS namespace, in the Caché Terminal:
%SYS> do Collect^pButtons()
where identifies the id of the files created by the profile you ran. For example, to produce a report for a run
whose is 20101013_1113_2mins, enter the following command: do
Collect^pButtons("20101013_1113_2mins").
2. Open the HTML report in any supported browser.
8.3 Scheduling the ^pButtons Utility with Task Manager
This section provides examples using the Task Manager (see [System] > [Task Manager]) in the System Management Portal
to schedule ^pButtons and Collect^pButtons to run.
Note:
The examples describe only the fields that are required. You can edit other fields as desired.
Example 1: Weekly 24-Hour Run
In this example, a task is created to schedule the ^pButtons utility to run a profile named day (which collects performance
data for 24 hours) every Thursday at 09:00, and Collect^pButtons to run every Friday at 11:00. To schedule these tasks
use the procedure described in Schedule Task Manager in the “Managing Caché” chapter of Caché System Administration
Guide.
In this example, first create the task to run ^pButtons:
1. From the [System] > [Task Manager] page of the System Management Portal, choose the Schedule New Task option to
start the Task Scheduler Wizard. Then enter the following information in the specified fields:
• Task name — enter 24HourRun.
• Description — enter Start 24-hour ^pButtons Run.
• Namespace to run task in — select %SYS from the drop-down list.
• Task type — select RunLegacyTask from the drop-down list.
In the ExecuteCode textbox, enter the following code:
Caché Monitoring Guide 69