QUERY_NN_TOPOLOGY_STATS
 |
This verb applies only to Communications Server. |
VCB Structure
typedef struct query_nn_topology_stats
{
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 long max_nodes; /* max num of nodes in database */
unsigned long cur_num_nodes; /* current number of nodes in */
/* database */
unsigned long node_in_tdus; /* number of TDUs received */
unsigned long node_out_tdus; /* number of TDUs sent */
unsigned long node_low_rsns; /* node updates received with */
/* low RSNs */
unsigned long node_equal_rsns; /* node updates in with */
/* equal RSNs */
unsigned long node_good_high_rsns;
/* node updates in with */
/* high RSNs */
unsigned long node_bad_high_rsns;
/* node updates in with */
/* high and odd RSNs */
unsigned long node_state_updates; /* number of node updates sent */
unsigned long node_errors; /* number of node entry */
/* errors found */
unsigned long node_timer_updates; /* number of node records built */
/* due to timer updates */
unsigned long node_purges; /* num node records purged */
unsigned long tg_low_rsns; /* TG updates received with */
/* low RSNs */
unsigned long tg_equal_rsns; /* TG updates in with equal RSNs */
unsigned long tg_good_high_rsns; /* TG updates in with high RSNs */
unsigned long tg_bad_high_rsns; /* TG updates in with high */
/* and odd RSNs */
unsigned long tg_state_updates; /* number of TG updates sent */
unsigned long tg_errors; /* number of TG entry errors */
/* found */
unsigned long tg_timer_updates; /* number of node records */
/* built due to timer updates */
unsigned long tg_purges; /* num node records purged */
unsigned long total_route_calcs; /* num routes calculated for COS */
unsigned long total_route_rejs; /* num failed route calculations */
unsigned long total_tree_cache_hits;
/* total num of tree cache hits */
unsigned long total_tree_cache_misses;
/* total num of tree cache */
/* misses */
unsigned counter
total_tdu_wars; /* total number TDU war */
unsigned char reserva[16]; /* reserved */
} QUERY_NN_TOPOLOGY_STATS;Supplied Parameters
The application supplies the following parameters:
- opcode
- AP_QUERY_NN_TOPOLOGY_STATS
- format
- Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
Returned Parameters
If the verb executes successfully, the Program returns the following
parameters:
- primary_rc
- AP_OK
- max_nodes
- Maximum number of node records in the topology database (zero means unlimited).
- cur_num_nodes
- Current number of nodes in this node's topology database. If this value exceeds the maximum number of nodes allowed, an Alert is issued.
- node_in_tdus
- Total number of topology database updates (TDUs) received by this node.
- node_out_tdus
- Total number of topology database updates (TDUs) built by this node to be sent to all adjacent network nodes since the last initialization.
- node_low_rsns
- Total number of topology node updates received by this node with an RSN less than the current RSN. Both even and odd RSNs are included in this count. (These TDUs are not errors, but result when TDUs are broadcast to all adjacent network nodes. No update to this node's topology database occurs, but this node sends a TDU with its higher RSN to the adjacent node that sent this low RSN.)
- node_equal_rsns
- Total number of topology node updates received by this node with an RSN equal to the current RSN. Both even and odd RSNS are included in this count. (These TDUs are not errors, but result when TDUs are broadcast to all adjacent network nodes. No update to this node's topology database occurs.)
- node_good_high_rsns
- Total number of topology node updates received by this node with an RSN greater than the current RSN. The node updates its topology and broadcasts a TDU to all adjacent network nodes. It is not required to send a TDU to the sender of this update, because that node already has the update.
- node_bad_high_rsns
- Total number of topology node updates received by this node with an odd RSN greater than the current RSN. These updates represent a topology inconsistency detected by one of the APPN® network nodes. The node updates its topology and broadcasts a TDU to all adjacent network nodes.
- node_state_updates
- Total number of topology node updates built as a result of internally detected node state changes that affect APPN® topology and routing. Updates are sent by TDUs to all adjacent network nodes.
- node_errors
- Total number of topology node update inconsistencies detected by this node. This occurs when this node attempts to update its topology database and detects a data inconsistency. This node creates a TDU with the current RSN incremented to the next odd number and broadcasts it to all adjacent network nodes.
- node_timer_updates
- Total number of topology node updates built for this node's resource due to timer updates. Updates are sent by TDUs to all adjacent network nodes. These updates ensure that other network nodes do not delete this node's resource from their topology database.
- node_purges
- Total number of topology node records purged from this node's topology database. This occurs when a node record has not been updated in a specified amount of time. The owning node is responsible for broadcasting updates for its resource that it wants kept in the network topology.
- tg_low_rsns
- Total number of topology TG updates received by this node with an RSN less than the current RSN. Both even and odd RSNs are included in this count. (These TDUs are not errors, but result when TDUs are broadcast to all adjacent network nodes. No update to this node's topology database occurs, but this node sends a TDU with its higher RSN to the adjacent node that sent this low RSN.)
- tg_equal_rsns
- Total number of topology TG updates received by this node with an RSN equal to the current RSN. Both even and odd RSNs are included in this count. (These TDUs are not errors, but result when TDUs are broadcast to all adjacent network nodes. No update to this node's topology database occurs.)
- tg_good_high_rsns
- Total number of topology TG updates received by this node with an RSN greater than the current RSN. The node updates its topology and broadcasts a TDU to all adjacent network nodes.
- tg_bad_high_rsns
- Total number of topology TG updates received by this node with an odd RSN greater than the current RSN. These updates represent a topology inconsistency detected by one of the APPN® Network Nodes. The node updates its topology and broadcasts a TDU to all adjacent network nodes.
- tg_state_updates
- Total number of topology TG updates built as a result of internally detected node state changes that affect APPN® topology and routing. Updates are sent by TDUs to all adjacent network nodes.
- tg_errors
- Total number of topology TG update inconsistencies detected by this node. This occurs when this node attempts to update its topology database and detects a data inconsistency. This node creates a TDU with the current RSN incremented to the next odd number and broadcasts it to all adjacent network nodes.
- tg_timer_updates
- Total number of topology TG updates built for this node's resource due to timer updates. Updates are sent by TDUs to all adjacent network nodes. These updates ensure that other network nodes do not delete this node's resource from their topology database.
- tg_purges
- Total number of topology TG records purged from this node's topology database. This occurs when a node record has not been updated in a specified amount of time. The owning node is responsible for broadcasting updates for its resource that it wants kept in the network topology.
- total_route_calcs
- Number of routes calculated for all classes of service since the last.
- total_route_rejs
- Number of route requests for all classes of service that could not be calculated since the last initialization.
- total_tree_cache_hits
- Number of route computations that were satisfied by a cached routing tree. Note that this number may be greater than the total number of computed routes, because each route may require inspection of several trees.
- total_tree_cache_misses
- Number of route computations that were not satisfied by a cached routing tree, so that a new routing tree had to be built.
- total_tdu_wars
- Number of TDU wars the local node has detected and prevented.
If the verb does not execute because the node has not yet been
started, the Program returns the following parameter:
- primary_rc
- AP_NODE_NOT_STARTED
If the verb does not execute because of a system error, the Program returns
the following parameter:
- primary_rc
- AP_UNEXPECTED_SYSTEM_ERROR