QUERY_HPR_STATS


The Communications Server icon lets you know that there is a change in the way things operate.
This verb applies only to Communications Server.

QUERY_HPR_STATS returns statistics describing the HPR performance of the node. QUERY_HPR_STATS is only supported by nodes that support the RTP Tower.

VCB Structure

typedef struct query_hpr_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 COUNTER
                        num-orig_rs_sent;   /* RS requests sent as origin  */
        unsigned COUNTER
                        num_orig_rs_rej;    /* RS rejections at orign      */
        unsigned COUNTER
                        num_inter_rs_rcvd;  /* Intermediate RS requests    */
        unsigned COUNTER
                        num_inter_rs_rej;   /* Intermediate RS rejections  */
        unsigned COUNTER
                        num_dest_rs_rcvd;   /* RS reqs as destination      */
        unsigned COUNTER
                        num_dest_rs_rej;    /* RS rej sent as destination  */
        unsigned long   active_isr_hpr_sessions;
                                            /* ISR sessions active         */
        unsigned char   reserv[28];         /* reserved                    */
} QUERY_HPR_STATS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_QUERY_HPR_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
num_orig_rs_sent
The total number HPR Route Setup requests sent that originated in this node, since the node started.
num_orig_rs_rej
The total number of HPR Route Setup requests that originated in this node and have been rejected by other nodes since the node started.
num_inter_rs_rcvd
The total number of HPR Route Setup requests processed by this node acting as an intermediate node since the node started.
num_inter_rs_rej
The total number of HPR Route Setup requests processed by this node acting as an intermediate node, that have been rejected by the node since the node started.
num_dest_rs_rcvd
The total number of HPR Route Setup requests received by this node, that has this node as the destination, since the node started.
num_dest_rs_rej
The total number of HPR Route Setup requests received by this node, that has this node as the destination and that have been rejected by the node since the node started.
active_isr_hpr_sessions
The number of ISR sessions using HPR-APPN Boundary Function that are currently active in the node.
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 the node does not support the HPR RTP Tower function, the Program returns the following parameter:
primary_rc
AP_FUNCTION_NOT_SUPPORTED