 |
» |
|
|
|
The change_session_limit command requests SNAplus2 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. Supplied Parameters | |
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
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
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). - plu_alias
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. - fqplu_name
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. - mode_name
Name of the mode to be used by the LUs. This name
is a type-A character string starting with a letter. - set_negotiable
Specifies whether the maximum negotiable session limit
for this mode, as defined by define_mode, should be modified. Possible values are: - YES
Use the value specified by plu_mode_session_limit as the maximum negotiable session limit for this LU-LU-mode
combination. - NO
Leave the maximum negotiable session limit as the value
specified for the mode.
- plu_mode_session_limit
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.
To specify a value of 0 (zero) use the reset_session_limit command. - min_conwinners_source
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. - min_conwinners_target
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. - auto_act
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 DEACT_NORMAL for
the type parameter on deactivate_session) this limit, new sessions are activated up to this limit.
Specify a value in the range 0-32,767. - responsible
Indicates whether the local LU or partner LU is responsible
for deactivating sessions after the session limit is changed. Possible
values are: - SOURCE
The local LU is responsible for deactivating sessions after
the session limit has been changed. - TARGET
The partner LU is responsible for deactivating sessions after
the session limit has been changed.
Returned Parameters | |
If the command executes successfully, the following parameters
are returned: - primary_rc
OK - secondary_rc
Possible values are: - AS_NEGOTIATED
The session limits were changed, but one or more values
were negotiated by the partner LU. - AS_SPECIFIED
The session limits were changed as requested, without being
negotiated by the partner LU.
Error Return Codes | |
If the command cannot be executed, SNAplus2 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,
SNAplus2 returns the following parameters: - primary_rc
PARAMETER_CHECK - secondary_rc
Possible values are: - EXCEEDS_MAX_ALLOWED
The plu_mode_session_limit, min_conwinners_source, min_conwinners_target, or auto_act parameter was set to a value outside the valid range. - CANT_CHANGE_TO_ZERO
The plu_mode_session_limit parameter cannot be set to 0 (zero)
using this command; use the reset_session_limit command instead. - INVALID_LU_ALIAS
The lu_alias parameter did not match any defined local LU alias. - INVALID_LU_NAME
The lu_name parameter did not match any defined local LU name. - INVALID_MODE_NAME
The mode_name parameter did not match any defined mode name. - INVALID_PLU_NAME
The fqplu_name parameter did not match any defined partner LU name. - INVALID_RESPONSIBLE
The responsible parameter was not set to a valid value. - INVALID_SET_NEGOTIABLE
The set_negotiable parameter was not set to a valid value.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters: - primary_rc
STATE_CHECK - secondary_rc
- MODE_RESET
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, SNAplus2
returns the following parameters: - primary_rc
ALLOCATION_ERROR - secondary_rc
- ALLOCATION_FAILURE_NO_RETRY
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.
- sense_data
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. - primary_rc
- CONV_FAILURE_NO_RETRY
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 SNAplus2 log file for information
about the error condition, and correct it before retrying this command.
- primary_rc
CNOS_PARTNER_LU_REJECT - secondary_rc
- CNOS_COMMAND_RACE_REJECT
The command failed because the specified mode was being
accessed by another administration program (or internally by the
SNAplus2 software) for session activation or deactivation, or for
session limit processing. Retry the command.
Appendix A “Common Return Codes from snapadmin Commands” lists combinations
of primary and secondary return codes that are common to all commands. |
Printable version
