HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DELETE_CN
3.52.1 VCB Structure
typedef struct delete_cn
{
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 fqcn_name[17]; /* name of Connection Network */
unsigned char reserv1; /* reserved */
AP_UINT16 num_ports; /* number of ports to delete */
unsigned char port_name[8][8]; /* names of ports to delete */
} DELETE_CN;
3.52.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DELETE_CN
fqcn_name
Fully qualified name of the connection network. The name is a 17-byte EBCDIC string, right-padded with
EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character,
and a network name of up to 8 A-string characters.
num_ports
Specify zero to delete the connection network, or the number of ports to be deleted if you are removing ports
instead of deleting the connection network.
port_name
If you are removing ports (if
num_ports is nonzero), specify the names of the ports to be deleted. Each port
name is an 8-byte ASCII string, padded on the right with spaces if the name is shorter than 8 bytes. If you
are deleting the connection network (if num_ports is zero), these names must be set to binary zeros.
3.52.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.52.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_CN_NAME
The fully-qualified CN name specified did not match any defined CN name.
275