Connectivity Guide > Connectivity Guide > Establishing Communications > Netutil Non-Interactive Mode > Destroy Function--Destroy a Connection Data Entry
Was this helpful?
Destroy Function--Destroy a Connection Data Entry
In netutil non-interactive mode, you can use the destroy function to destroy a connection data entry. To obtain the network address, protocol, and listen address of the connection data entry you want to destroy, use the show command.
This function has the following format:
destroy type connection vnode network_address protocol listen_address
type
Specifies the type of entry. Valid values are:
global
Indicates that the object is available to all users on the local node.
private
Indicates that the object is available to a single user.
vnode
Identifies the virtual node name associated with this input line. An asterisk (*) can be used as a wildcard to select a range of records.
network_address
Identifies the address or name of the remote node. An asterisk (*) can be used as a wildcard to select a range of records.
protocol
Specifies the keyword for the protocol used to connect to the remote instance. For a list of protocols and their associated keywords, see Network Protocol Keywords. An asterisk (*) can be used as a wildcard to select a range of records.
listen_address
Is the unique identifier used by the remote Communications Server for interprocess communication. An asterisk (*) can be used as a wildcard to select a range of records.
Examples: Destroy a Connection Data Entry
The following command destroys a private connection data entry on vnode “payroll”, where:
Network address = payroll
Protocol = TCP/IP
Listen address = fe2
D p c payroll payroll tcp_ip fe2 # No comm server on fe2
The following command destroys all global connection data entries for vnode “accounting” that include the TCP/IP protocol:
d gl c accounting * tcp_ip *
Note:  Private connection data entries are destroyed for the currently logged-in user or for the user identified by the -u flag. Only a user with the GCA privilege NET_ADMIN can destroy a global connection data entry.
Last modified date: 11/28/2023