LOCAL_TOPOLOGY_INDICATION

This indication is generated when a TG entry in a node's local topology database changes from active to inactive, or from inactive to active.

VCB Structure

typedef struct local_topology_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   dest[17];       /* name of TG destination node   */
   unsigned char   dest_type;      /* TG destination node type      */
   unsigned char   tg_num;         /* TG number                     */
   unsigned char   cp_cp_session_active;
                                   /* CP-CP session is active       */
   unsigned char   branch_link_type;
                                   /* branch link type              */
   unsigned char   branch_tg;      /* TG is a branch TG             */
   unsigned char   reserva[17];    /* reserved                      */
} LOCAL_TOPOLOGY_INDICATION;

Parameters

opcode
AP_LOCAL_TOPOLOGY_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_CP_CP_SESSIONS
AP_TG_QUIESCING
AP_NONE

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.)
dest_type
Type of the node. It is one of the following values:

AP_END_NODE
AP_NETWORK_NODE
AP_VRN

tg_num
Number associated with the TG.
cp_cp_session_active
Specifies whether the local node's contention winner CP-CP session is active (AP_NO or AP_YES).
branch_link_type
BrNN only. This branch link type of this TG. This is set to one of the following:
AP_UPLINK
This link is an uplink.
AP_DOWNLINK
The link is a downlink to an EN.
AP_DOWNLINK_TO_BRNN
The TG is a downlink to a BrNN that is showing its EN face.
AP_OTHERLINK
This link is an otherlink.

Other node types: This field is not meaningful and is always set to AP_BRNN_NOT_SUPPORTED.

branch_tg
NN only. 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.

Other node types: This field is not meaningful and is always set to AP_NO.