HSM

The HSM command controls the Hot Spot Monitor performance monitoring tool. This command is not available on the PDA version of QM.

Format

The Hot Spot Monitor records the number of times each program module is called and the processor time in seconds spent in that module.

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.

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

     1       0.000  !SCREEN

    13       0.060  $CPROC

    18       0.000  !PARSER

     1       0.000  PRINT.DEFERED

     4       0.010  $SETPTR

     1       0.000  CHARGE.TOTAL

    19       0.034  CALC.INVOICE.VALUE

    24       0.000  ADD.MONTH

     3       0.000  REVERSE

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

     6      17.040  C:\QM\BP.OUT\FINANCE

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

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

     1       0.000  $HSM

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