HP UX Internet and Networking Software manual Deactivateconvgroup, Sensedata

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