Command Reference Guide

Administration Commands

deactivate_session

Other Conditions

Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary

return codes that are common to all commands.

2.8 deactivate_session

The deactivate_session command requests SNAplus2 to deactivate one or more sessions using a particular

local LU/mode/partner LU combination.

To identify a local LU/mode/partner LU combination specify the following:

• Specify the local LU using either the lu_name or the lu_alias parameter. If neither are speciﬁed then the LU

associated with the CP (the default LU) is used.

• Specify the mode.

• Specify the remote LU using either the fqplu_name or the plu_alias parameter.

To deactivate a particular session using the speciﬁed local LU/mode/partner LU combination, specify its session

identiﬁer. If no session identiﬁer is speciﬁed then all sessions using the speciﬁed local LU/mode/partner LU are

deactivated.

This command must be issued to a running node.

2.8.1 Supplied Parameters

Parameter name Type Length Default

[deactivate_session]

lu_name character 8 (null string)

lu_alias character 8 (null string)

session_id hex number 8 0x0

plu_alias character 8 (null string)

mode_name character 8

type constant DEACT_NORMAL

sense_data hex number 4 0x0

fqplu_name character 17 (null string)

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 deﬁned 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. This

parameter is used only if lu_name is not speciﬁed.

If lu_name and lu_alias are not speciﬁed, the command is forwarded to the LU associated with the CP (the

default LU).

session_id

An 8-byte identiﬁer of the session to deactivate. If you do not specify this parameter, SNAplus2 deactivates

all sessions for the LU-MODE-LU combination.

An error code is not returned when the speciﬁed session ID does not match the session ID of an active session

(implying that the session has already been deactivated).