DELETE statement

Start of change Use the DELETE statement to delete a previously defined DEVICE, LINK, PORT, or PORTRANGE. End of change

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.


>>-DELEte--DEVice--device_name---------------------------------><


>>-DELEte--LINK--link_name-------------------------------------><


>>-DELEte--PORT------------------------------------------------->

   .---------------------------------------------------.   
   V                                                   |   
>----+-num--+-TCP-+--+-RESERVED------------------+---+-+-------><
     |      '-UDP-'  '-jobname--| Port Options |-'   |     
     '-UNRSV--+-TCP-+--+-jobname-+--+--------------+-'     
              '-UDP-'  '-*-------'  '-Port options-'

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.


>>-DELEte--PORTRange-------------------------------------------->

   .------------------------------------------------------------------.   
   V                                                                  |   
>----1st_port--num_ports--+-TCP-+--+-RESERVED-----------------------+-+-><
                          '-UDP-'  +-AUTHPORT-----------------------+     
                                   '-jobname--| Portrange Options |-'

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

This example shows DELETE statements that delete a link called sanjose and a device called ourctc:

DELETE LINK sanjose
DELETE DEVICE ourctc

This example shows a DELETE PORT statement that deletes a reservation for port 5001:

PORT 5001 TCP MEGA
DELETE PORT 5001 TCP MEGA

This example shows a PORT statement that denies all jobs access to unreserved UDP ports on explicit binds. The example also shows the DELETE PORT statement that deletes this access restriction.

PORT UNRSV UDP * DENY WHENBIND 
DELETE PORT UNRSV UDP *

The keywords DENY and WHENBIND are not required on the DELETE PORT statement.

This example shows several PORTRANGE statements to reserve ports for MEGA, and then several DELETE PORTRANGE statements to delete the reservations for those ports:

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.