 |
» |
|
|
|
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 the APPC TP.
The conversation group identifier is returned by the APPC verbs [MC_ALLOCATE,
[MC_] GET_ATTRIBUTES, and RECEIVE_ALLOCATE. 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. - 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 specified. If lu_name and lu_alias are not specified, the command is forwarded to the
LU associated with the CP (the default LU). - conv_group_id
Conversation group identifier for the session to
be deactivated. - type
Type of deactivation. Possible values are: DEACT_CLEANUP Deactivate the session immediately, without waiting for a
response from the partner LU. DEACT_NORMAL Do not deactivate the session until all conversations using
the session have ended. - sense_data
If type is set to DEACT_CLEANUP,
the sense_data parameter specifies the sense data to be used when deactivating
the session (specified as a 4-byte hexadecimal number preceded by
0x; for example, 0x84000007). Otherwise, this parameter is not used.
Returned Parameters | |
No parameters are returned by SNAplus2 when this command executes successfully. 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: - DEACT_CG_INVALID_CGID
The conv_group_id parameter did not match any valid conversion group
id. - INVALID_CLEANUP_TYPE
The type parameter was not set to a valid value. - DEACT_CLEANUP
Deactivate the session immediately, without waiting for
a response from the partner LU. - DEACT_NORMAL
Do not deactivate the session until all conversations using
the session have ended.
- sense_data
If type is set to DEACT_CLEANUP,
|
Printable version
