MONITOR MPLOCK command: Difference between revisions
m (misc formatting) |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 6: | Line 6: | ||
<dd>You can display information about <var class="product">Model 204</var> multiprocessor lock contention. The command output is mainly intended for Rocket Software Technical Support. | <dd>You can display information about <var class="product">Model 204</var> multiprocessor lock contention. The command output is mainly intended for Rocket Software Technical Support. | ||
</dl> | </dl> | ||
==Syntax== | ==Syntax== | ||
<p class="syntax"><b>M</b>ONITOR MPLOCK | <p class="syntax"><b>M</b>ONITOR MPLOCK | ||
</p> | </p> | ||
==Example== | ==Example== | ||
Your output might look similar to the following: | Your output might look similar to the following: | ||
| Line 57: | Line 59: | ||
==Usage== | ==Usage== | ||
<p>For each lock, separate counts are maintained for each use of the lock-meaning, for each purpose for which the lock can be requested). </p> | <p> | ||
For each lock, separate counts are maintained for each use of the lock-meaning, for each purpose for which the lock can be requested). </p> | |||
<table> | <table> | ||
<tr class="head"> | |||
<th nowrap>Output column </th> | |||
<th>Indicates...</th> | |||
</tr> | |||
<tr> <th><var><p>Name </p></var></th> | |||
<td><p>Lock name</p></td> | |||
</tr> | |||
<tr> <th><var> | |||
<p>Name </p> | |||
</var></th> <td> | |||
<p>Lock name</p> | |||
</td> </tr> | |||
<tr> <th><var> | <tr> <th><var><p>Usage </p></var></th> | ||
<p>Usage </p> | <td><p>Usage names per lock name</p></td> | ||
</var></th> <td> | </tr> | ||
<p>Usage names per lock name</p> | |||
</td> </tr> | |||
<tr> <th><var> | <tr> <th><var><p>Spins </p></var></th> | ||
<p>Spins </p> | <td> | ||
</var></th> <td> | |||
<p>Number of times that there was contention for the lock, and the requesting task was able to obtain the lock within MAXSPINS spins.</p> | <p>Number of times that there was contention for the lock, and the requesting task was able to obtain the lock within MAXSPINS spins.</p> | ||
</td> </tr> | </td> </tr> | ||
<tr> <th><var> | <tr> <th><var><p>Waits </p></var></th> | ||
<p>Waits </p> | <td> | ||
</var></th> <td> | |||
<p>Number of times that there was contention, and the requesting task had to enter a WAIT for the lock.</p> | <p>Number of times that there was contention, and the requesting task had to enter a WAIT for the lock.</p> | ||
</td> </tr> | </td> </tr> | ||
<tr> <th><var> | <tr> <th><var><p>Posts </p></var></th> | ||
<p>Posts </p> | <td> | ||
</var></th> <td> | |||
<p>Number of times that a task released a lock, and there was a waiting task to be posted.</p> | <p>Number of times that a task released a lock, and there was a waiting task to be posted.</p> | ||
</td> </tr> | </td> </tr> | ||
<tr> <th><var> | <tr> <th><var><p>(unlabeled) </p></var></th> | ||
<p>(unlabeled) </p> | <td> | ||
</var></th> <td> | |||
<p>If there is no contention for the lock</p> | <p>If there is no contention for the lock</p> | ||
</td> </tr> | </td> </tr> | ||
</table> | </table> | ||
<p>All numbers are cumulative since the beginning of the run. The lock names and usage names relate to <var class="product">Model 204</var> internals only.</p> | <p> | ||
<p>When you run <var class="product">Model 204</var> with the MP/204 (multiprocessor) option, the <var class="product">Model 204</var> nucleus uses a number of locks to control access to shared memory resources. For each lock, the output indicates the number of times since <var class="product">Model 204</var> started that contention for the lock occurred. Contention means that one task attempted to acquire the lock, but could not because another task was holding the lock at the time. </p> | All numbers are cumulative since the beginning of the run. The lock names and usage names relate to <var class="product">Model 204</var> internals only.</p> | ||
<p>If you issue a MONITOR MPLOCK command, but are not running MP/204, the following message is displayed: </p> | <p> | ||
<p class="code">M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0 | When you run <var class="product">Model 204</var> with the [[MP/204]] (multiprocessor) option, the <var class="product">Model 204</var> nucleus uses a number of locks to control access to shared memory resources. For each lock, the output indicates the number of times since <var class="product">Model 204</var> started that contention for the lock occurred. Contention means that one task attempted to acquire the lock, but could not because another task was holding the lock at the time. </p> | ||
<p> | |||
If you issue a <var>MONITOR MPLOCK</var> command, but are not running MP/204, the following message is displayed: </p> | |||
<p class="code">M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0 | |||
</p> | </p> | ||
[[Category: System administrator commands]] | [[Category: System administrator commands]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
Latest revision as of 18:16, 27 June 2017
Summary
- Privileges
- System administrator
- Function
- You can display information about Model 204 multiprocessor lock contention. The command output is mainly intended for Rocket Software Technical Support.
Syntax
MONITOR MPLOCK
Example
Your output might look similar to the following:
MONITOR MPLOCK Name Usage Spins Waits Posts ---- ----- ----- ----- ----- NONE no contention SIR1 no contention SIR2 no contention ITS1 no contention ITS2 no contention USR1 no contention USR2 no contention TST1 no contention TST2 no contention ECTM no contention ECMM no contention MQCH no contention MQST no contention MQTA no contention HASH DKDP 6 1 DKFB 79 78 93 DKFR 32 25 DKSW 91 45 56 LRUQ DKUC 90 1 DFB1 3 1 DFB2 67 2 2 DFR2 1 RCLK no contention FORT no contention V7IB no contention V7OB no contention QMAN no contention QUEU no contention DBCD DKUC 1 DU2L 4 2 1 DKRR 2 1 DKFB 2 FILD no contention TWND no contention CMLW CDEQ 1 PAGE no contention CNST no contention SMFS no contention JRNL BUFF 3
Usage
For each lock, separate counts are maintained for each use of the lock-meaning, for each purpose for which the lock can be requested).
| Output column | Indicates... |
|---|---|
Name |
Lock name |
Usage |
Usage names per lock name |
Spins |
Number of times that there was contention for the lock, and the requesting task was able to obtain the lock within MAXSPINS spins. |
Waits |
Number of times that there was contention, and the requesting task had to enter a WAIT for the lock. |
Posts |
Number of times that a task released a lock, and there was a waiting task to be posted. |
(unlabeled) |
If there is no contention for the lock |
All numbers are cumulative since the beginning of the run. The lock names and usage names relate to Model 204 internals only.
When you run Model 204 with the MP/204 (multiprocessor) option, the Model 204 nucleus uses a number of locks to control access to shared memory resources. For each lock, the output indicates the number of times since Model 204 started that contention for the lock occurred. Contention means that one task attempted to acquire the lock, but could not because another task was holding the lock at the time.
If you issue a MONITOR MPLOCK command, but are not running MP/204, the following message is displayed:
M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0