NETCONTROL ADDLINK

Dynamically adds a configured network link to the active network interface.

Syntax

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

Parameters

ADDLINK=linkName: Specifies the name of the link to be dynamically added to 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 added, an "ALREADY 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 adds an already configured link to an active network interface without having to first bring down and then restart the network interface or the entire transport. This can be a link for a newly-configured node mapping, a link being shared with another subsystem such as RJE/iX or SNA/iX, or a link being restarted after an earlier failure due to link errors. Note that some link errors are so serious that an ADDLINK cannot restore use of the link.

The control process will create a new link driver for the specified link and bind it to the existing network interface and its network interface protocols.

This function is mainly used with router NI types.

Example

To add the linkname "PSI48" to the active NI "ROUTER1", enter

:NETCONTROL ADDLINK=PSI48; NET=ROUTER1

NETCONTROL ADDLINK

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Discussion

Example