INSP

Type

OMEGAMON Major command

Description

Displays the current sampling parameters and status of this facility, which monitors applications running in an address space. It also shows TCB CPU resource consumption.

INSP JOB(cccccccc) SAMPLES(nnnn)|NOLIMIT INTERVAL(nnn) STOP|START

When you enter the INSP command beginning in column 2, the cursor automatically moves to column 7 to accept an operand. The operand can be:

JOB(cccccccc)
The variable cccccccc specifies the address space INSP monitors. This can be a job name, * (the current address space), or the ASID value in decimal.
SAMPLES(nnnn)
Number of samples to gather. The default is 3000. If you set the sample number to 0, it has the same effect as the NOLIMIT operand.
NOLIMIT
Specifies sampling to continue until you enter the STOP command.
INTERVAL(nnn)
The variable nnn is the duration of the interval (in milliseconds) between samples. The default is 10 milliseconds.
STOP
Stops sampling immediately. You can use this parameter to terminate sampling before INSP reaches the specified sampling limit.
START
Begins sampling and displays results. Using the action character (-) in column 1 is the same as using this operand.

The INSP command requires APF-authorization.

To use the applications tuning facility, use the following procedure.

  1. Issue the INSP command. 
    INSP

    The following display appears:

     INSP
+      Current sampling options:
+      JOB(USER1)    ASID is 38     Sampling is not active
+      SAMPLES(200)  INTERVAL(100)
  2. To begin sampling, enter INSP START or the action character (-) in column 1. 
    INSP START

    Sampling begins and its progress appears:

     INSP
+      Current sampling options:
+      JOB(USER1)  ASID is 38     Sampling is active
+      SAMPLES(200)     INTERVAL(100)
+      Samples taken = 25; samples used = 15

    The figure given for samples taken includes both valid and not valid samples. Samples used reflects valid samples. A not valid sample may result from the address space being swapped out or not accumulating CPU.

INSP completes the sampling when the SAMPLES limit is reached or when you enter the STOP parameter: 
INSP STOP

The following display appears:

 INSP
+      Current sampling options:
+      JOB(USER1)  ASID is 38     Sampling is not active
+      SAMPLES(200)     INTERVAL(100)     200 samples have been taken
       Samples taken = 25; Samples used = 15

Related Information

Major of: ICPU and MLIB