MODIFY SESSIONGROUP command

From m204wiki
Jump to navigation Jump to search

Summary

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

Syntax

MODIFY SESSIONGROUP name REMOTE=rmtname MODENAME=modent [MAXIMUM=xx] [WINNERS=yy]

Where: name is the name specified in the DEFINE SESSIONGROUP command.

REMOTE specifies the name of the remote session with which this sessiongroup is associated. This name and the MODENAME value must be the same as the remote name and the MODENAME value specified on a local DEFINE SESSIONGROUP command.
MODENAME refers to the SNA Communications Server (formerly VTAM) mode table entry to be used for this sessiongroup. A mode entry specifies a set of parameters that define characteristics for the session, such as security options and the size and handling of the RU (request/response unit) shipped between the two nodes.

The mode entry name you specify and the REMOTE value) must be the same as the mode entry name and the REMOTE value specified on a local DEFINE SESSIONGROUP command.

You cannot name your entry SNASVCMG; this name is reserved for CNOS control sessions between the local and remote LUs.

MAXIMUM specifies the maximum number of concurrent parallel sessions that can be active between the local LU and the target remote LU using the mode entry name specified in this command. MAXIMUM must be greater than zero, greater than or equal to the value of WINNERS, and less than or equal to 32,767.
WINNERS specifies the maximum number of this sessiongroups' first-speaker sessions, that is, sessions for which this LU is assured to win any contention with the remote LU for a chance to initiate an application conversation.

WINNERS must be greater than or equal to zero, less than or equal to the value of MAXIMUM, and less than or equal to 32,767.

The maximum number of sessions in which the remote node can be first speaker is equal to the difference between the values of MAXIMUM and WINNERS.

Usage notes

The MODIFY SESSIONGROUP command changes an already operational sessiongroup definition. You can modify the MAXIMUM and WINNERS session limits.

MODIFY SESSIONGROUP has no effect on the stored sessiongroup definition. It affects only the current processing limits. For example, if the following sequence of events occurs:

  1. STOP SESSIONGROUP command is issued for the sessiongroup.

  2. All conversations in the sessiongroup end.

  3. START SESSIONGROUP is issued for the sessiongroup.

Then the sessiongroup attributes return to those set in the DEFINE SESSIONGROUP command, ignoring any changes you might have made with MODIFY SESSIONGROUP.

The MODIFY SESSIONGROUP command cannot be used, if the sessiongroup is currently stopped, or if the sessiongroup has not yet been used.