DELETE statement
Use the DELETE statement to delete a previously defined DEVICE, LINK, PORT, or PORTRANGE.
Guideline: Use the INTERFACE statement with the DELETE parameter to delete a previously defined interface.
Syntax
Rule: Specify the parameters in the order shown here.
Port Options
The optional parameters for the PORT profile statement can be specified on the DELETE PORT statement but, though the syntax of the parameters is verified, the parameter values are ignored.
Portrange Options
The optional parameters for the PORTRANGE profile statement can be specified on the DELETE PORTRANGE statement but, though the syntax of the parameters is verified, the parameter values are ignored.
Parameters
The values of the required parameters must match the existing reservation or the delete fails. You can specify the optional parameters for the PORT or PORTRANGE profile statement on the DELETE PORT or DELETE PORTRANGE statement. However, even though the syntax of the parameters is verified, the parameter values are ignored.
The following parameters are network interface parameters:
- device_name
- The name of the device to be deleted. This is the name that was used on a DEVICE statement to define the device to TCP/IP.
- link_name
- The name of the link to be deleted. This is the name that was used on a LINK statement to define the link to TCP/IP.
The following parameters are PORT and PORTRANGE parameters.
To delete an existing PORT or PORTRANGE reservation, use a PORT or PORTRANGE profile statement and prefix it with the DELETE keyword. The only required parameters on the DELETE PORT or DELETE PORTRANGE statement are as follows:
- Reserved port number or UNRSV on the DELETE PORT statement, or the range of port numbers on the DELETE PORTRANGE statement
- Protocol of TCP or UDP
- Job name specification
- num
- The port number of the port to be deleted. This is the port number that was used on a PORT statement to define the port to TCP/IP.
- UNRSV
- UNRSV indicates that a statement that defines access to unreserved port numbers is to be deleted.
- 1st_port
- The first port number in the range of reserved ports to be deleted.
- num_ports
- The number of ports to be deleted, starting with the port specified on the 1st_port parameter. This range is the same number of ports that were reserved when the port range was defined with the PORTRANGE statement.
- jobname
- The job name associated with the port to be deleted.
- RESERVED
- Indicates that the port is not available for use by any user. Use this value to lock certain ports. This value is optional and valid for TCP and UDP protocols.
- AUTHPORT
- Indicates that the port is not available for use by any user except FTP, and only when FTP is configured to use PASSIVEDATAPORTS. AUTHPORT is valid only with the TCP protocol.
Steps for modifying
Modification is not applicable to this statement.
Statement dependency
- To delete a link, you must first delete any associated HOME entry
by specifying a HOME statement that does not include the link, and
you must also stop the device.
Restriction: You do not need to (and cannot) stop the device when deleting a link for a virtual device.
- To delete a device, you must first stop the device, then delete
all associated links.
Restriction: You do not need to (and cannot) stop the device when deleting a link for a virtual device.
Examples
DELETE LINK sanjose
DELETE DEVICE ourctc
PORT 5001 TCP MEGA
DELETE PORT 5001 TCP MEGA
PORT UNRSV UDP * DENY WHENBIND
DELETE PORT UNRSV UDP *
The keywords DENY and WHENBIND
are not required on the DELETE PORT statement.PORTRANGE 5000 10 UDP MEGA
5100 10 TCP MEGA NOAUTOLOG
5200 10 UDP MEGA DELAYACKS
5300 10 TCP MEGA
5400 10 UDP MEGA
5500 10 TCP MEGA NOAUTOLOG DELAYACKS
DELETE PORTRANGE
5000 10 UDP MEGA
5100 10 TCP MEGA NOAUTOLOG
5200 10 UDP MEGA DELAYACKS
5300 10 TCP MEGA
5400 10 UDP MEGA
5500 10 TCP MEGA NOAUTOLOG DELAYACKS
Usage notes
The link_name of a deleted link remains associated with its device. It cannot be reassigned to a new device while TCP/IP is active.