 |
» |
|
|
|
The reset_session_limit command requests SNAplus2 to reset the session limits
for a particular LU-LU-mode combination. Sessions may be deactivated
as a result of processing this command. Supplied Parameters | |
Parameter name Type Length
[reset_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 (null string)
mode_name_select constant ONE
set_negotiable constant NO
responsible constant SOURCE
drain_source constant NO
drain_target constant NO
force constant NO
|
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 identified 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. For the network name and partner LU name, use only
letters, digits 0-9,
and special characters $, #,
and @. 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 for which to reset session limits. This
parameter is a type-A character string starting with a letter. It
is ignored if mode_name_select is set to ALL. - mode_name_select
Selects whether session limits should be reset on
a single specified mode, or on all modes between the local and partner
LUs. Possible values are: - ONE
Reset session limits on the mode specified by mode_name. - ALL
Reset session limits on all modes.
- set_negotiable
Specifies whether to reset the maximum negotiable session
limit for this LU-LU-mode combination to 0. (The
current limit may be the limit specified for the mode, or may have
been changed by initialize_session_limit or change_session_limit.) Possible values are: - YES
Reset the maximum negotiable session limit for this LU-LU-mode
combination to 0 (so that sessions cannot be
activated until the limit is changed by initialize_session_limit). - NO
Leave the maximum negotiable session limit unchanged.
- responsible
Indicates whether the source (local) or target (partner) LU
is responsible for deactivating sessions after the session limit
is reset. Possible values are: - SOURCE
The local LU is responsible for deactivating sessions. - TARGET
The partner LU is responsible for deactivating sessions.
- drain_source
Specifies whether the source LU satisfies waiting session
requests before deactivating a session. Possible values are: - YES
Waiting session requests are satisfied. - NO
Waiting session requests are not satisfied.
- drain_target
Specifies whether the target LU satisfies waiting session
requests before deactivating a session. Possible values are: - YES
Waiting session requests are satisfied. - NO
Waiting session requests are not satisfied.
- force
Specifies whether to set session limits to 0 even
if CNOS negotiation fails. Possible values are: - YES
Set session limits to 0. - NO
Do not set session limits to 0 even
if CNOS negotiation fails.
Returned Parameters | |
If the command executes successfully, SNAplus2 returns the
following parameters: - primary_rc
OK - secondary_rc
Possible values are: - AS_SPECIFIED
The command executed successfully. The session limits were
changed as specified. - FORCED
The session limits were set to 0 even
though CNOS negotiation failed. - AS_NEGOTIATED
The session limits were changed, but one or more values
were 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
A SNAplus2 internal error occurred. - INVALID_LU_ALIAS
The lu_alias parameter value did not match any defined local LU
alias. - INVALID_LU_NAME
The lu_name parameter value did not match any defined local LU
name. - INVALID_MODE_NAME
The mode_name parameter value did not match any defined mode name. - INVALID_PLU_NAME
The fqplu_name parameter value did not match any defined partner LU
name. - INVALID_MODE_NAME_SELECT
The mode_name_select parameter was not set to a valid value. - INVALID_DRAIN_SOURCE
The drain_source parameter was not set to a valid value. - INVALID_DRAIN_TARGET
The drain_target parameter was not set to a valid value. - INVALID_FORCE
The force parameter was not set to a valid value. - 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 reset_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
A session could not be allocated because of a condition that
requires action. Check the log files for messages indicating the
reason for the failure, and take any action required. Do not attempt
to retry the command until the condition has been corrected.
- 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
The SNA sense data associated with the allocation failure. - primary_rc
- CONV_FAILURE_NO_RETRY
The session limits could not be changed 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
The command failed because SNAplus2 failed to negotiate
the session limits with the partner. Check configuration at both
the local LU and partner LU.
- 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
