Command Reference Guide

Administration Commands
deactivate_conv_group
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.
2.6 deactivate_conv_group
The deactivate_conv_group command requests SNAplus2 to deactivate the session corresponding to the
specified APPC conversation group. Although this command is available within the command-line administration
program, deactivating a session identified by its conversation group is more usually done using the NOF verb
DEACTIVATE_CONV_GROUP from within an APPC TP. The conversation group identifier is returned by the
APPC verbs [MC_]ALLOCATE, [MC_]GET_ATTRIBUTES, and RECEIVE_ALLOCATE.
This command must be issued to a running node.
2.6.1 Supplied Parameters
Parameter name Type Length Default
[deactivate_conv_group]
lu_name character 8 (null string)
lu_alias character 8 (null string)
conv_group_id decimal
type constant DEACT_NORMAL
sense_data hex number 4 0x0
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.
52