MODIFY PROCESSGROUP command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
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>

Latest revision as of 21:37, 30 March 2021

Summary

Privileges
User 0, system administrator, system manager
Function
Modifies an operational Horizon processgroup

Syntax

MODIFY PROCESSGROUP processgroupname [RETAIN={nn | RETAINALL}] [INLIMIT={nn | NOINLIMIT}] [OUTLIMIT={nn | NOOUTLIMIT}]

Where: processgroupname is the name specified in the DEFINE PROCESSGROUP command.

RETAIN 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.
INLIMIT 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.
OUTLIMIT 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 processgroups.

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:

  1. STOP PROCESSGROUP command is issued for the processgroup.

  2. All conversations with the processgroup end.

  3. START PROCESSGROUP command is issued for the processgroup.

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.

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=MODIFY_PROCESSGROUP_command&oldid=118212"