HSM

The HSM command controls the Hot Spot Monitor performance monitoring tool.

Format

The Hot Spot Monitor records the number of times each program module is called, the processor time in seconds spent in that module and i/o counters for opens, reads, writes and deletes.

The HSM ON command clears any old data and starts monitoring.

The HSM OFF command terminates monitoring.

The HSM DISPLAY command displays the collected data. It may be used while monitoring is active or after it has been switched off. The DISPLAY keyword can be omitted. If the LPTR keyword is present, the report is sent to print unit u, defaulting to printer 0 if the unit number is omitted.

The USER n option causes the command to affect the specified user and is useful in monitoring processes that do not display a command prompt.

Note that although QM maintains processor timings internally to microsecond precision and reports the figures to millisecond precision, some platforms do not provide the raw data to this level. For example, some Linux systems only report processor usage in units of one hundredth of a second.

Example

HSM ON

... processing ...

HSM DISPLAY

Calls    CP time   Opens   Reads  Writes Deletes Program

    1       0.000     0       0       0       0  !SCREEN

   13       0.060     2       7       0       0  $CPROC

   18       0.000     0      49       0       0  !PARSER

    1       0.000     1      61       0       1  PRINT.DEFERED

    4       0.010     0       0       0       0  $SETPTR

    1       0.000     6       8       2       0  CHARGE.TOTAL

   19       0.034    38      58       0       0  CALC.INVOICE.VALUE

   24       0.000     0       0       0       0  ADD.MONTH

    3       0.000     0       3       0       0  REVERSE

    1       0.000     1       2       0       0  C:\QM\BP.OUT\PROC

    6      17.040    31     141       0       0  C:\QM\BP.OUT\FINANCE

   19      14.010    19      19      19       0  C:\QM\BP.OUT\INVOICE

    1       0.800     1       1       0       0  C:\QM\BP.OUT\CHECK_EX

    1       0.000     0       0       0       0  $HSM

Program names beginning with a $ sign are internal components of QM. For example, $CPROC included in the report above is the command processor.