HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DELETE_SECURITY_ACCESS_LIST
You can delete a user name from the security access list regardless of whether there are active conversations that
were set up using that user name. Deleting the user name does not affect the active conversations, but the invoking
program will not be able to set up any further conversations using the deleted user name.
3.76.1 VCB Structure
The DELETE_SECURITY_ACCESS_LIST verb contains a variable number of
security_user_name
structures; these
define the user names to be deleted from the security access list. The user name structures are included at the end
of the
delete_security_access_list structure; the number of these structures is specified by the
num_users parameter.
typedef struct delete_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 */
AP_UINT32 num_users; /* number of users to delete */
} DELETE_SECURITY_ACCESS_LIST;
typedef struct security_user_name
{
unsigned char user_name[10]; /* user name to delete */
} SECURITY_USER_NAME;
3.76.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DELETE_SECURITY_ACCESS_LIST
list_name
The name of the security access list being deleted, or the list from which user names are being deleted. This is
an ASCII string of 1–14 characters, padded on the right with spaces if the name is shorter than 14 characters,
which must match a previously-defined security access list name.
num_users
The number of user names to be deleted from the security access list, as follows:
• To delete one or more user names from the list but leave other user names configured, specify the number
of user names that are being deleted. Each of these must be defined by a user name structure, as described
below.
• To delete the entire security access list, specify zero in this parameter and do not include any user names.
For each user name to be deleted, up to the number specified in num_users, the following parameter is required:
user_name
The user name being deleted. This must match a user name that is currently defined for this security access
list.
3.76.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
311