MONITOR MPLOCK command - Revision history

JAL: misc formatting

2017-06-27T18:16:27Z

misc formatting

← Older revision		Revision as of 18:16, 27 June 2017
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>~~		<tr> <th><var><p>Name </p></var></th>
	~~<p>Output column </p>~~		<td><p>Lock name</p></td>
	~~</th> <th>~~		</tr>
	~~<p>Indicates...</p>~~
	~~</th> </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>
			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 class="code">M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0
	</p>		</p>

	[[Category: System administrator commands]]		[[Category: System administrator commands]]
	[[Category:Commands]]		[[Category:Commands]]

ELowell at 22:19, 27 March 2017

2017-03-27T22:19:13Z

← Older revision		Revision as of 22:19, 27 March 2017
Line 106:		Line 106:
	<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>		<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>
	<p>If you issue a MONITOR MPLOCK command, but are not running MP/204, the following message is displayed: </p>		<p>If you issue a MONITOR MPLOCK command, but are not running MP/204, the following message is displayed: </p>
	<p class="code">M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0.		<p class="code">M204.1925: MPLOCK OPTION REQUIRES NMPSUBS>0
	</p>		</p>
	[[Category: System administrator commands]]		[[Category: System administrator commands]]
	[[Category:Commands]]		[[Category:Commands]]

ELowell: /* Example */

2017-03-27T22:17:09Z

Example

← Older revision		Revision as of 22:17, 27 March 2017
Line 41:		Line 41:
	V7OB no contention		V7OB no contention
	QMAN no contention		QMAN no contention

	QUEU no contention		QUEU no contention
	DBCD DKUC 1		DBCD DKUC 1

ELowell: /* Example */

2013-06-27T18:47:12Z

Example

← Older revision		Revision as of 18:47, 27 June 2013
Line 11:		Line 11:
	==Example==		==Example==
	Your output might look similar to the following:		Your output might look similar to the following:
	<p class="code"><b>MONITOR MPLOCK</b>		<p class="code"><b>MONITOR MPLOCK</b><nowiki>
	Name Usage Spins Waits Posts		Name Usage Spins Waits Posts
	---- ----- ----- ----- -----		---- ----- ----- ----- -----
Line 53:		Line 53:
	SMFS no contention		SMFS no contention
	JRNL BUFF 3		JRNL BUFF 3
	</p>		</nowiki></p>

	==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>

Alex: Automatically generated page update

2013-02-28T01:05:13Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>System administrator
<dt>Function
<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>
==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). 
<table>

<tr> <th>
Output column 
</th> <th>
Indicates...
</th> </tr>

<tr> <th><var>
Name 
</var></th> <td>
Lock name
</td> </tr>

<tr> <th><var>
Usage 
</var></th> <td>
Usage names per lock name
</td> </tr>

<tr> <th><var>
Spins 
</var></th> <td>
Number of times that there was contention for the lock, and the requesting task was able to obtain the lock within MAXSPINS spins.
</td> </tr>

<tr> <th><var>
Waits 
</var></th> <td>
Number of times that there was contention, and the requesting task had to enter a WAIT for the lock.
</td> </tr>

<tr> <th><var>
Posts 
</var></th> <td>
Number of times that a task released a lock, and there was a waiting task to be posted.
</td> </tr>

<tr> <th><var>
(unlabeled) 
</var></th> <td>
If there is no contention for the lock
</td> </tr>

</table>
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.
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. 
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.

[[Category: System administrator commands]]
[[Category:Commands]]