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.