MODIFY PROCESSGROUP command - Revision history

SteveS: /* Syntax */

2021-03-30T21:37:35Z

Syntax

← Older revision		Revision as of 21:37, 30 March 2021
Line 8:		Line 8:
	==Syntax==		==Syntax==
	<p class="syntax">MODIFY PROCESSGROUP <i>processgroupname</i>		<p class="syntax">MODIFY PROCESSGROUP <i>processgroupname</i>
	~~[MODENAME = logmode table entry name]~~
	[RETAIN={<i>nn</i> \| RETAINALL}]		[RETAIN={<i>nn</i> \| RETAINALL}]
	[INLIMIT={<i>nn</i> \| NOINLIMIT}]		[INLIMIT={<i>nn</i> \| NOINLIMIT}]
Line 17:		Line 16:
	processgroupname is the name specified in the DEFINE PROCESSGROUP command.		processgroupname is the name specified in the DEFINE PROCESSGROUP command.
	<table>		<table>
	~~<tr>~~
	~~<th><var>MODENAME</var></th>~~
	~~<td> Horizon VTAM and VTAM Transfer Control only.~~
	Identifies the SNA Communications Server mode table entry to be used to establish the Transferred Session at the Transfer Target Remote Id and allows the User to control the characteristics of that session..
	A mode table entry contains a collection of Session Parameters, such as Display Model, RU size, EDS support et al, that are used to Bind the Transferred Session at the Transfer Target and provides the User with a means of controlling the session characteristics in force following the Transfer. </td>
	~~</tr>~~

	<tr>		<tr>
	<th><var>RETAIN</var></th>		<th><var>RETAIN</var></th>

SteveS: /* Syntax */

2021-03-29T19:52:32Z

Syntax

← Older revision		Revision as of 19:52, 29 March 2021
Line 17:		Line 17:
	processgroupname is the name specified in the DEFINE PROCESSGROUP command.		processgroupname is the name specified in the DEFINE PROCESSGROUP command.
	<table>		<table>
			<tr>
			<th><var>MODENAME</var></th>
			<td> Horizon VTAM and VTAM Transfer Control only.
			Identifies the SNA Communications Server mode table entry to be used to establish the Transferred Session at the Transfer Target Remote Id and allows the User to control the characteristics of that session..
			A mode table entry contains a collection of Session Parameters, such as Display Model, RU size, EDS support et al, that are used to Bind the Transferred Session at the Transfer Target and provides the User with a means of controlling the session characteristics in force following the Transfer. </td>
			</tr>

	<tr>		<tr>
	<th><var>RETAIN</var></th>		<th><var>RETAIN</var></th>

SteveS: /* Syntax */

2021-03-29T19:38:15Z

Syntax

← Older revision		Revision as of 19:38, 29 March 2021
Line 8:		Line 8:
	==Syntax==		==Syntax==
	<p class="syntax">MODIFY PROCESSGROUP <i>processgroupname</i>		<p class="syntax">MODIFY PROCESSGROUP <i>processgroupname</i>
			[MODENAME = logmode table entry name]
	[RETAIN={<i>nn</i> \| RETAINALL}]		[RETAIN={<i>nn</i> \| RETAINALL}]
	[INLIMIT={<i>nn</i> \| NOINLIMIT}]		[INLIMIT={<i>nn</i> \| NOINLIMIT}]

SteveS: /* Syntax */

2021-03-29T19:35:20Z

Syntax

← Older revision		Revision as of 19:35, 29 March 2021
Line 29:		Line 29:
	<th><var>OUTLIMIT</var></th>		<th><var>OUTLIMIT</var></th>
	<td> limits the number of concurrent outbound conversations. OUTLIMIT=0 indicates that no outbound conversations are allowed. NOOUTLIMIT specifies that there is no limit on the number of outbound conversations.		<td> limits the number of concurrent outbound conversations. OUTLIMIT=0 indicates that no outbound conversations are allowed. NOOUTLIMIT specifies that there is no limit on the number of outbound conversations.
	<p class="note"><b>Note:</b> The MODIFY command does not apply to TPROCESS ~~or Transfer Control~~ processgroups.</p>		<p class="note"><b>Note:</b> The MODIFY command does not apply to TPROCESS processgroups.</p>
	</td>		</td>
	</tr>		</tr>

	</table>		</table>

	==Usage notes==		==Usage notes==
	<p>The MODIFY PROCESSGROUP command changes an already operational processgroup definition. The INLIMIT, OUTLIMIT, and RETAIN session limits can be modified. If the limits are lowered, the effect is similar to the STOP command, which deactivates the processgroup, until the new limit is reached.</p>		<p>The MODIFY PROCESSGROUP command changes an already operational processgroup definition. The INLIMIT, OUTLIMIT, and RETAIN session limits can be modified. If the limits are lowered, the effect is similar to the STOP command, which deactivates the processgroup, until the new limit is reached.</p>

Alex: Automatically generated page update

2013-02-28T01:05:10Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>User 0, system administrator, system manager
<dt>Function
<dd>Modifies an operational Horizon processgroup
</dl>
==Syntax==
MODIFY PROCESSGROUP processgroupname
[RETAIN={nn | RETAINALL}]
[INLIMIT={nn | NOINLIMIT}]
[OUTLIMIT={nn | NOOUTLIMIT}]


Where:
processgroupname is the name specified in the DEFINE PROCESSGROUP command.
<table>
<tr>
<th><var>RETAIN</var></th>
<td> determines the number of sessions to be retained as conversations end. RETAIN=0 specifies that each session is released as each conversation ends. RETAINALL specifies that each session started is to be retained for the length of the run. If RETAIN=nn is specified, the maximum value is 9999.</td>
</tr>

<tr>
<th><var>INLIMIT</var></th>
<td> limits the number of concurrent inbound conversations. INLIMIT=0 indicates that no inbound conversations are allowed. NOINLIMIT specifies that there is no limit on the number of inbound conversations. </td>
</tr>

<tr>
<th><var>OUTLIMIT</var></th>
<td> limits the number of concurrent outbound conversations. OUTLIMIT=0 indicates that no outbound conversations are allowed. NOOUTLIMIT specifies that there is no limit on the number of outbound conversations.
Note: The MODIFY command does not apply to TPROCESS or Transfer Control processgroups.
</td>
</tr>

</table>
==Usage notes==
The MODIFY PROCESSGROUP command changes an already operational processgroup definition. The INLIMIT, OUTLIMIT, and RETAIN session limits can be modified. If the limits are lowered, the effect is similar to the STOP command, which deactivates the processgroup, until the new limit is reached.
MODIFY PROCESSGROUP has no effect on the stored processgroup definition. It affects only the current processing limits. For example, if the following sequence of events occurs:
<ol>
<li>
STOP PROCESSGROUP command is issued for the processgroup.
</li>

<li>
All conversations with the processgroup end.
</li>

<li>
START PROCESSGROUP command is issued for the processgroup. 
</li>
</ol>
Then the processgroup attributes return to those set in the DEFINE PROCESSGROUP command, ignoring any changes you might have made with MODIFY.
The effect of MODIFY may not be immediate. For example, if MODIFY specifies a lower INLIMIT value than the current DEFINE PROCESSGROUP value, and there are more currently active sessions than the modified limit, active sessions are drained (allowed to complete before being terminated) until the modified limit is reached.
Also, since MODIFY can only be used with an operational processgroup, it may not be used if the processgroup is currently stopped; nor may it be used if the processgroup has not yet been used for the first time.
[[Category: System administrator commands]]
[[Category: System manager commands]]
[[Category:Commands]]