HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEACTIVATE_CONV_GROUP
3.7.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_NODE_NAME
The value that was specified for the node_name parameter was not valid.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK
,
which are common to all NOF verbs.
3.7.5 Returned Parameters: State Check
If the verb does not execute because of a state error, SNAplus2 returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_CONNECTION_NOT_MADE
An error occurred in connecting to the node.
AP_INVALID_VERSION
The application could not connect to the node, because there was a version mismatch between the
SNAplus2 software on the computer where the application is running and the computer where the
target node is defined. If you are in the process of upgrading the network, so that different computers
are running different levels of the SNAplus2 software, nodes running on the back-level software can be
managed only by applications running on the back-level software.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK, which
are common to all NOF verbs.
3.7.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.8 DEACTIVATE_CONV_GROUP
The DEACTIVATE_CONV_GROUP verb requests the deactivation of the session corresponding to the specified
conversation group. Although this verb is part of the NOF API, it is primarily intended for use by application
programmers writing TPs that use the APPC API. The conversation group identifier is returned by the APPC verbs
[MC_]ALLOCATE, [MC_]GET_ATTRIBUTES, and RECEIVE_ALLOCATE.
This verb must be issued to a running node.
3.8.1 VCB Structure
typedef struct deactivate_conv_group
{
100