|
|
|
|
The change_session_limit command requests SNAP-IX to change the session limits for a particular LU-LU-mode combination. Sessions can be activated or deactivated as a result of processing this command.
This command must be issued to a running node.
Parameter name Type Length Default [change_session_limit] lu_name character 8 (null string) lu_alias character 8 (null string) plu_alias character 8 (null string) fqplu_name character 17 (null string) mode_name character 8 set_negotiable constant NO plu_mode_session_limit decimal min_conwinners_source decimal 0 min_conwinners_target decimal 0 auto_act decimal 0 responsible constant SOURCE
Supplied parameters are:
LU name of the local LU. This name is a type-A character string. To indicate that the LU is defined by its LU alias instead of its LU name, do not specify this parameter.
LU alias of the local LU. This alias is a character string using any locally displayable characters. It is used only if lu_name is not specified.
If lu_name and lu_alias are not specified, the command is forwarded to the LU associated with the CP (the default LU).
LU alias of the partner LU. This alias is a character string using any locally displayable characters. To indicate that the partner LU is defined by its fully qualified LU name instead of its LU alias, do not specify this parameter.
Fully qualified name of the partner LU. Specify 3-17 type-A characters that consist of a 1-8 character network name, followed by a period, followed by a 1-8 character partner LU name.
This parameter is used only if the plu_alias parameter is not specified; it is ignored if plu_alias is specified.
Name of the mode to be used by the LUs. This name is a type-A character string starting with a letter.
Specifies whether the maximum negotiable session limit for this mode, as defined by define_mode, should be modified. Possible values are:
Use the value specified by plu_mode_session_limit as the maximum negotiable session limit for this LU-LU-mode combination.
Leave the maximum negotiable session limit as the value specified for the mode.
Requested total session limit for this LU-LU-mode combination-the maximum number of parallel sessions allowed between these two LUs using this mode. This value can be negotiated with the partner LU. Specify a value in the range 1-32,767 (which must not exceed the session limit specified for the local LU on the define_local_lu command). To specify a value of 0 (zero) use the reset_session_limit command.
Minimum number of sessions using this mode for which the local LU is the contention winner. The sum of the min_conwinners_source and min_conwinners_target parameters must not exceed the plu_mode_session_limit parameter. Specify a value in the range 0-32,767.
Minimum number of sessions using this mode for which the partner LU is the contention winner. The sum of the min_conwinners_source and min_conwinners_target parameters must not exceed the plu_mode_session_limit parameter. Specify a value in the range 0-32,767.
Number of sessions to activate automatically after the session limit
is changed. The actual number of automatically activated sessions is the minimum
of this value and the negotiated minimum number of contention winner sessions
for the local LU. When sessions are deactivated normally (specifying
Indicates whether the local LU or partner LU is responsible for deactivating sessions after the session limit is changed. Possible values are:
The local LU is responsible for deactivating sessions after the session limit has been changed.
The partner LU is responsible for deactivating sessions after the session limit has been changed.
If the command executes successfully, the following parameters are returned:
OK
Possible values are:
The session limits were changed, but one or more values were negotiated by the partner LU.
The session limits were changed as requested, without being negotiated by the partner LU.
If the command cannot be executed, SNAP-IX returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
If the command does not execute because of a parameter error, SNAP-IX returns the following parameters:
PARAMETER_CHECK
Possible values are:
The plu_mode_session_limit, min_conwinners_source , min_conwinners_target, or auto_act parameter was set to a value outside the valid range.
The plu_mode_session_limit parameter cannot be
set to
The lu_alias parameter did not match any defined local LU alias.
The lu_name parameter did not match any defined local LU name.
The mode_name parameter did not match any defined mode name.
The fqplu_name parameter did not match any defined partner LU name.
The responsible parameter was not set to a valid value.
The set_negotiable parameter was not set to a valid value.
If the command does not execute because of a state error, SNAP-IX returns the following parameters:
STATE_CHECK
No sessions are currently active for this LU-LU-mode combination. Use initialize_session_limit instead of change_session_limit to specify the limits.
If the command does not execute because other conditions exist, SNAP-IX returns the following parameters:
ALLOCATION_ERROR
A session could not be allocated because of a condition that requires action. Check the sense_data parameter and logged messages to determine the reason for the failure, and take any action required. Do not attempt to retry the command until the condition has been corrected.
If the secondary_rc parameter is ALLOCATION_FAILURE_NO_RETRY, this parameter contains the SNA sense data associated with the error. For all other secondary_rc values, this parameter is not returned.
The session limits could not be initialized because of a condition that requires action (such as a configuration mismatch or a session protocol error). Check the SNAP-IX log file for information about the error condition, and correct it before retrying this command.
CNOS_PARTNER_LU_REJECT
The command failed because the specified mode was being accessed by another administration program (or internally by the SNAP-IX software) for session activation or deactivation, or for session limit processing. Retry the command.
Common Return Codes from snaadmin Commands lists combinations of primary and secondary return codes that are common to all commands.
|
|
|
 |
|