DLTNWID (Delete Network Interface Description)

DLTNWID Command syntax diagram

 

Purpose

The Delete Network Interface Description (DLTNWID) command deletes specified network interface descriptions. The network interface identified in the network interface description must be varied off before this command is issued.

Lines attached to the network interface and their associated controllers and devices must be varied off before this command is issued.

The line descriptions are detached when the command is started; the detached line descriptions cannot be used until they are associated with another network interface description. If a new network interface description is created, the detached line descriptions can be specified on the command that creates the network interface description. If the detached line descriptions must be attached to existing network interface descriptions, the detached line descriptions must be deleted and created again (or copied), and the new network interface names are given in the NWI (for nonswitched attachments) or SWTNWILIST (for switched attachments) parameters of the line description command.

 

Required Parameters

NWID

Specifies the names of the network interface descriptions being deleted.

network-interface-description-name: Specify the name of the network interface description being deleted.

generic*-network-description-name: Specify the generic name of the network description. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names.

Example for DLTNWID

DLTNWID   NWID(ISDNNET)

This command deletes the network interface description of the network interface named ISDNET from the system.

If the deleted network interface description has any line descriptions associated with it, they are detached and a message containing those line description names is sent to the system operator. The detached line descriptions are then associated with a new network interface description if their names are specified on the command that creates the network interface description.

Error messages for DLTNWID

*ESCAPE Messages

CPF2625

Not able to allocate object &1.

CPF2634

Not authorized to object &1.

CPF27A4

Network interface description &1 not found.

CPF27A9

Network interface description &1 not varied off.