HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DIRECTORY_STATS
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.108.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.109 QUERY_DIRECTORY_STATS
QUERY_DIRECTORY_STATS returns directory database statistics, which can be used to gauge the level of network
locate trafc. For a network node, it returns information about the usage of the directory cache; you can use this
information to determine the appropriate cache size, which is specied on the DEFINE_NODE verb.
This verb must be issued to a running node.
3.109.1 VCB Structure
typedef struct query_directory_stats
{
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 */
AP_UINT32 max_caches; /* maximum number of cache */
/* entries */
AP_UINT32 cur_caches; /* cache entry count */
AP_UINT32 cur_home_entries; /* home entry count */
AP_UINT32 cur_reg_entries; /* registered entry count */
AP_UINT32 cur_directory_entries; /* current number of directory */
/* entries */
AP_UINT32 cache_hits; /* count of cache finds */
AP_UINT32 cache_misses; /* count of resources found */
/* by broadcast search */
/* (not in cache) */
AP_UINT32 in_locates; /* locates in */
AP_UINT32 in_bcast_locates; /* broadcast locates in */
AP_UINT32 out_locates; /* locates out */
AP_UINT32 out_bcast_locates; /* broadcast locates out */
AP_UINT32 not_found_locates; /* unsuccessful locates */
AP_UINT32 not_found_bcast_locates; /* unsuccessful broadcast */
/* locates */
AP_UINT32 locates_outstanding; /* total outstanding locates */
unsigned char reserva[20]; /* reserved */
} QUERY_DIRECTORY_STATS;
3.109.2 Supplied Parameters
The application supplies the following parameter:
opcode
402