NETCONTROL DELLINK

Dynamically deletes a configured network link from the active network interface.

Syntax

NETCONTROL DELLINK=linkName; {NET =niName      }
                             {GATE=gatehalfName}

Parameters

DELLINK=linkName: Specifies the name of the link to be dynamically deleted from the specified active NI. The linkname must be a valid NI link name configured in the NMMGR Link Selection screen and also in the Network Interface Links screen under the specified "niname" or "gatehalfname" NI. If already deleted, a "NOT STARTED" error will occur, or if the linkname is not valid, a "NOT CONFIGURED" error will occur.
NET=niName: Specifies the name of an active network interface under which the specified linkname is configured. Enter any valid NI name from the NMMGR Network Interface Configuration screen which is not a gateway half. If this NI is not active, a "NOT STARTED" error will occur.
GATE=gatehalfName: Specifies the name of an active gateway half network interface under which the specified linkname is configured. Enter any valid gatehalf NI name from the NMMGR Network Interface Configuration screen. If this NI is not active, a "NOT STARTED" error will occur.

Discussion

This command deletes a previously configured and started link from an active network interface without having to bring down the entire network interface or transport. This command is particularly useful when making cabling or modem changes, to make a device unusable for security reasons, or when sharing a device with other subsystems such as RJE/iX or SNA/iX. Certain types of errors can also sometimes be cleared by a DELLINK followed by an ADDLINK.

The control process will unbind the network interface protocols and network interface from the existing link driver, then terminate that link driver. Depending on the link type, the link driver may not actually terminate if other links are still bound. The network interface and its protocols remain active until that NI is stopped using the NETCONTROL STOP command.

This function is mainly used with router NI types.

Example

To delete the linkname "PSI48" from the active NI "ROUTER1", enter

:NETCONTROL DELLINK=PSI48; NET=ROUTER1

NETCONTROL DELLINK

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Parameters

Discussion

Example