NETCONTROL ADDLINK [ NS3000/iX Operations & Maintenance Reference Manual ] MPE/iX 5.0 Documentation
NS3000/iX Operations & Maintenance Reference Manual
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 "iname" 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
MPE/iX 5.0 Documentation