NN_TOPOLOGY_NODE_INDICATION

The Communications Server icon lets you know that there is a change in the way things operate.
This verb applies only to Communications Server.
This indication is generated when a node entry in a network node's topology database changes from active to inactive, or from inactive to active.

VCB Structure

typedef struct nn_topology_node_indication
{
   unsigned short  opcode;         /* verb operation code           */
   unsigned char   reserv2;        /* reserved                      */
   unsigned char   format;         /* format                        */
   unsigned short  primary_rc;     /* primary return code           */
   unsigned long   secondary_rc;   /* secondary return code         */
   unsigned char   data_lost;      /* previous indication lost      */
   unsigned char   deactivated;    /* has the node become inactive? */
   unsigned char   node_name[17];  /* node name                     */
   unsigned char   node_type;      /* node type                     */
   unsigned char   branch_aware;   /* node is branch aware          */
   unsigned char   reserva[19];    /* reserved                      */
} NN_TOPOLOGY_NODE_INDICATION;

Parameters

opcode
AP_NN_TOPOLOGY_NODE_INDICATION
format
Identifies the format of the VCB. This field is set to zero to specify the version of the VCB listed above.
primary_rc
AP_OK
secondary rc
Equals zero.
data_lost
Specifies whether data has been lost (AP_YES or AP_NO). It is set when an internal component detects a failure that has caused a previous indication to be lost. If the data_lost flag is set to AP_YES then subsequent data fields can be set to null. The application should issue a QUERY verb to update the information that has been lost.
deactivated
Set to AP_YES when the node becomes inactive. Set to AP_NO when the node becomes active.
node_name
Network qualified node name from network topology database. This name is 17 bytes long and is right-padded with EBCDIC spaces. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
node_type
Type of the node. It is one of the following.

AP_NETWORK_NODE
AP_VRN

branch_aware
Specifies whether the node is branch aware.
AP_NO
The node is not branch aware.
AP_YES
The node is branch aware.