View source for STOP command: Stopping a Horizon CNOS remote or session group

==Summary==
<dl>
<dt>Privileges
<dd>User 0, system administrator, system manager
<dt>Function
<dd>Stops a remote or session group
</dl>
==Syntax==
<p class="syntax">STOP {REMOTE | SESSIONGROUP} <i>entityname</i>
</p>
 
<b>Where:</b>
entityname is the name specified on the DEFINE REMOTE or DEFINE SESSIONGROUP command.
==Usage notes==
<p>The STOP command stops the specified remote or sessiongroup.</p>
<p>If the STOP command is issued when there are active users of the specified entity, the entity is put in a drain state in which new users are prevented from using the entity. Active users are allowed to continue until their current conversations end.</p>
<p>If the STOP command is issued while there are no active users of the specified entity, the entity is completely stopped. </p>
<p>STOP REMOTE has the following effects: </p>
<ul> 
<li>
<p>Causes an orderly shutdown of all sessions associated with the remote. This consists of: </p>
<ul> 
<li>
<p>Resetting to zero the session limits for all session groups associated with that remote</p>
</li>
 
<li>
<p>Rejecting new conversation requests</p>
</li>
 
<li>
<p>Unbinding all sessions associated with the remote </p>
</li>
 </ul>
</li>
 
<li>
<p>Frees any storage acquired for session management</p>
</li>
 
<li>
<p>Preserves remote and sessiongroup entity definitions </p>
</li>
 </ul>
<p>STOP SESSIONGROUP has the same effects on a single session group as STOP REMOTE has on all the session groups for a remote, except that STOP SESSIONGROUP does not free any storage acquired for session management.</p>
<p>Once stopped, you can restart a session group by using START SESSIONGROUP. A stopped sessiongroup is also restarted implicitly by the next request for a conversation using that CNOS connection. Restarting a sessiongroup causes a renegotiation of the session limits and contention winners between the LUs sharing the sessions.</p>
<p>Unlike STOP PROCESSGROUP, STOP REMOTE does not unlock the remote definition. You cannot redefine this entity by issuing a new DEFINE command for it during the <var class="product">Model&nbsp;204</var> run.</p>
[[Category: System administrator commands]]
[[Category: System manager commands]]
[[Category:Commands]]