Caché Monitoring Guide - InterSystems Documentation

Invoking the Line-by-line Monitoring Routine
Enter the number of your choice: 5
Enter metrics item number (press 'Enter' to terminate, for list)
Metric#:
1.) GloRef: global refs
2.) GloSet: global sets
.
.
.
34.) RtnLine: lines of Cache Object Script
.
.
.
51.) Time: elapsed time on wall clock
52.) TotalTime: total time used (including sub-routines)
Metric#:
This example does not show the full list; it is best for you to retrieve the current list when you run the routine. See
the Line-by-line Monitor Programming Interface section for a method of retrieving the list.
Note:
For all collections, the number of routine lines and time (minimal metrics) are always collected.
3. Select Processes to monitor – Enter the number of your choice as it appears in the menu. The default is 1
for all processes.
Select Processes to monitor
1.) Monitor All Processes
2.) Monitor Current Process Only
3.) Enter list of PIDs
Enter the number of your choice:
^%SYS.MONLBL does not currently provide a list or a way to select PIDs; however, you can use the ^%SS utility
or the [System] > [Processes] page of the Management Portal to find specific process ID numbers.
Enter the number of your choice: 3
Enter PID (press 'Enter' to terminate)
PID: 1640
PID: 2452
PID:
Press Enter twice after entering the last process ID to end the list.
Once you provide the necessary information, ^%SYS.MONLBL allocates a special section of shared memory for counters
for each line per routine, and notifies the selected processes that monitoring is activated.
Monitor started.
Press RETURN to continue ...
After starting the line-by-line monitor, the routine displays a more extensive menu. The Line-by-line Monitoring Options
section describes each option on this extended menu.
7.1.2 Estimate Memory Requirements
Before starting the monitoring process you can use this utility to estimate how much memory a collection requires. Typically,
there is sufficient shared memory available for monitoring a few routines. However, if you want to monitor hundreds or
more routines, use this option to help determine memory needs.
Caché Monitoring Guide 59