NN_TOPOLOGY_TG_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 TG entry in a network node's topology database changes from active to inactive, or from inactive to active.

VCB Structure

typedef struct nn_topology_tg_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   status;         /* TG status                     */
   unsigned char   owner[17];      /* name of TG owner node         */
   unsigned char   dest[17];       /* name of TG destination node   */
   unsigned char   tg_num;         /* TG number                     */
   unsigned char   owner_type;     /* Type of node that owns the TG */
   unsigned char   dest_type;      /* TG destination node type      */
   unsigned char   cp_cp_session_active;
                                   /* CP-CP session is active       */
   unsigned char   branch_tg;      /* TG is a branch TG             */
   unsigned char   reserva[16];    /* reserved                      */
} NN_TOPOLOGY_TG_INDICATION;

Parameters

opcode

AP_NN_TOPOLOGY_TG_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.

status

Specifies the status of the TG. This can be one or more of the following values ORed together:

AP_TG_OPERATIVE
AP_TG_QUIESCING
AP_TG_CP_CP_SESSIONS
AP_NONE

owner

Name of the TG's originating node (always set to the local node name). 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.)

dest

Fully qualified destination node name for the TG. 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.)

tg_num

Number associated with the TG.

owner_type

Type of the node that owns the TG.

AP_NETWORK_NODE
AP_VRN

dest_type

Type of the node.

AP_NETWORK_NODE
AP_VRN

cp_cp_session_active

Specifies whether the owning node's contention winner CP-CP session is active (AP_NO or AP_YES).

branch_tg

Sepcifies whether the TG is a branch TG.

AP_NO: The TG is not a branch TG.
AP_YES: The TG is a branch TG.