HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SECURITY_ACCESS_LIST
3.155.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
path_switch_attempts
Number of path switch attempts to set on new RTP connections.
short_req_retry_limit
Number of times a Status Request is sent before SNAplus2 determines that an RTP connection is disconnected
and starts Path Switch processing.
path_switch_times
Length of time in seconds for which SNAplus2 attempts to path switch a disconnected RTP connection.
This parameter is specified as four separate time limits for each of the valid transmission priorities in order:
AP_LOW, AP_MEDIUM, AP_HIGH, and AP_NETWORK.
3.155.4 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.156 QUERY_SECURITY_ACCESS_LIST
QUERY_SECURITY_ACCESS_LIST returns information about security access lists defined in a SNAplus2
configuration file. It can return information about a single list or multiple lists, depending on the options used.
3.156.1 VCB Structure
typedef struct query_security_access_list
{
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 list_name[14]; /* Security Access List name */
unsigned char user_name[10]; /* user name */
AP_UINT32 num_init_users; /* number of users for first */
/* list when starting in middle */
AP_UINT32 num_last_users; /* number of users on last */
/* overlay if last list is */
/* incomplete */
unsigned char last_list_incomplete; /* set to AP_YES if user data */
641