DELETE_CN

DELETE_CN deletes and frees the memory for a connection network control block if all the associated ports are reset. DELETE_CN can also be used to delete selected ports from a connection network. To do this, the user should set the num_ports field to a nonzero value and supply the port names of the ports to be deleted.

VCB Structure

typedef struct delete_cn
{
        unsigned short  opcode;         /* verb operation code        */
        unsigned char   attributes;     /* verb attributes            */
        unsigned char   format;         /* format                     */
        unsigned short  primary_rc;     /* primary return code        */
        unsigned long   secondary_rc;   /* secondary return code      */
        unsigned char   fqcn_name[17];  /* name of connection network */
        unsigned char   reserv1;        /* reserved                   */
        unsigned short  num_ports;      /* number of ports to delete  */
        unsigned char   port_name[8] [8];
                                        /* names of ports to delete   */
} DELETE_CN;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_CN
attributes
The attributes of the verb. This field is a bit field. The first bit contains the visibility of the resource to be defined and corresponds to one of the following:

AP_EXTERNALLY_VISIBLE
AP_INTERNALLY_VISIBLE

format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
fqcn_name
Name of connection network (17 bytes long) to be deleted. This name is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
num_ports
The number of ports to delete on the connection network. This should be set to zero if the entire connection network is to be deleted.
port_name
Names of the ports to be deleted if the num_ports is nonzero. Each port name is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set. If the num_ports field is zero this field is reserved.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:
primary_rc
AP_OK
If the verb does not execute because of a parameter error, the Program returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_CN_NAME

AP_INVALID_NUM_PORTS_SPECIFIED

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:
primary_rc
AP_NODE_NOT_STARTED
If the verb does not execute because the node is stopping, the Program returns the following parameter:
primary_rc
AP_NODE_STOPPING
If the verb does not execute because of a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR