HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)

DEACTIVATE_CONV_GROUP

Chapter 3 151

DEACTIVATE_CONV_GROUP

The DEACTIVATE_CONV_GROUP verb requests the deactivation of the

session corresponding to the speciﬁed 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 identiﬁer is returned by the APPC verbs

[MC_]ALLOCATE, [MC_]GET_ATTRIBUTES, and

RECEIVE_ALLOCATE.

This verb must be issued to a running node.

VCB Structure

typedef struct deactivate_conv_group

{

AP_UINT16 opcode; /* verb operation code */

unsigned char reserv2; /* reserved */

unsigned char format; /* reserved */

AP_UINT16 primary_rc; /* primary return code */

AP_UINT32 secondary_rc; /* secondary return code */

unsigned char lu_name[8]; /* local LU name */

unsigned char lu_alias[8]; /* local LU alias */

AP_UINT32 conv_group_id; /* conversation group identifier */

unsigned char type; /* deactivation type */

unsigned char reserv3[3]; /* reserved */

AP_UINT32 sense_data; /* deactivation sense data */

} DEACTIVATE_CONV_GROUP;

Supplied Parameters

The application supplies the following parameters:

opcode

AP_DEACTIVATE_CONV_GROUP

lu_name

LU name of the local LU, as deﬁned to SNAplus2. This

is an 8-byte type-A EBCDIC string,padded on the right

with spaces if the name is shorter than 8 bytes. To

indicate that the LU is deﬁned by its LU alias instead

of its LU name, set this parameter to 8 binary zeros.