HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_SECURITY_ACCESS_LIST
If a local LU or an invokable TP does not have a security access list defined, but is still configured to require
conversation security, the standard conversation security checking still applies.
3.43.1 VCB Structure
The DEFINE_SECURITY_ACCESS_LIST verb contains a variable number of
security_user_data structures; these
define the user names to be added to the security access list. The user name structures are included at the end of
the
def_data structure; the number of these structures is specified by the
num_users parameter.
typedef struct define_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 list_name[14]; /* name of this list */
unsigned char reserv3[2]; /* reserved */
SECURITY_LIST_DEF def_data; /* security access list */
} DEFINE_SECURITY_ACCESS_LIST;
typedef struct security_list_def
{
unsigned char description[32]; /* description */
unsigned char reserv3[16]; /* reserved */
AP_UINT32 num_users; /* number of users being added */
unsigned char reserv2[16]; /* reserved */
} SECURITY_LIST_DEF;
typedef struct security_user_data
{
AP_UINT16 sub_overlay_size; /* reserved */
unsigned char user_name[10]; /* user name */
} SECURITY_USER_DATA;
3.43.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_SECURITY_ACCESS_LIST
list_name
Name of the security access list. This is an ASCII string, padded on the right with spaces.
If this name matches an existing security access list, the users defined by this verb are added to the list;
otherwise a new list is created.
def_data.description
A null-terminated text string (0–31 characters followed by a null character) describing the security access
list. This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_SECURITY_ACCESS_LIST verb, but SNAplus2 does not make any other use of it.
def_data.num_users
Number of user names being defined by this verb. Each user must be specified by a
security_user_data structure
following the
def_data structure.
253