HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_RTP_CONNECTION
The details of the workstation, as defined in the configuration. The format of this information is the same as
for the DEFINE_RJE_WKSTN verb.
3.153.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_WORKSTATION
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
specified name, but the workstation_name parameter did not match any defined RJE workstation name.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.153.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.154 QUERY_RTP_CONNECTION
The QUERY_RTP_CONNECTION verb returns a list of information about Rapid Transport Protocol (RTP)
connections for which the node is an endpoint. This verb can be used to obtain summary or detailed information
about a specific RTP connection or about multiple RTP connections, depending on the options used.
This verb must be issued to a running node.
3.154.1 VCB Structure
typedef struct query_rtp_connection
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
unsigned char rtp_name[8]; /* name of RTP connection */
632