Start of change

ADD_MIGRATION_INTERFACE procedure

Edit online

The ADD_MIGRATION_INTERFACE procedure registers an interface to be modified on the source or target nodes to the IBM i Migrate While Active environment. The modification will occur on the source or target nodes during the cutover stage.

Interfaces that have been defined can be displayed using MIGRATION_INTERFACE_INFO view.

Authorization: The caller must have *IOSYSCFG special authority. To understand any additional authority needed to use this procedure, see Db2® Mirror services authorization.

Read syntax diagramSkip visual syntax diagram ADD_MIGRATION_INTERFACE ( CUTOVER_ACTION =>  cutover-action ,IP_ADDRESS =>  ip-address ,LINE_DESCRIPTION =>  line-description ,SUBNET_MASK =>  subnet-mask ,RESOURCE_NAME => resource-name,COMMUNICATION_PORT => communication-port,VIRTUAL_LAN_ID => virtual-lan-id,AUTOSTART => autostart )

The schema is QSYS2.

cutover-action
The migration cutover action to be performed by the Migration Manager for the interface.
ADD ON TARGET
Add the interface on the target node.
MOVE TO TARGET
Move the interface from the source node to the target node. The interface is removed from the source node and added to the target node.
REMOVE FROM SOURCE
Remove the interface from the source node.
REMOVE FROM TARGET
Remove the interface from the target node.
ip-address
A character string that specifies the IP address to add. It must be an IPv4 address. Each IP address added by this procedure must be unique.
line-description
A character string that specifies the system line description associated with the interface.
subnet-mask
A character string that specifies the subnet mask of the interface.
resource-name
A character string that specifies the name of the resource that identifies the communications port. If this parameter is omitted, no resource name is included in the interface definition.
communication-port
A character string that specifies the physical location of the communications port. If this parameter is omitted, no communication port is included in the interface definition.
virtual-lan-id
A character string that specifies the virtual LAN identifier of the associated line. This is either a number from 1 to 4094 or the following special value.
NONE
The IP address is not part of a virtual LAN. This is the default.
autostart
A character string that specifies whether the interface is automatically started when the protocol stack is activated.
NO

The interface is not started when TCP/IP is started.

YES

The interface automatically starts when TCP/IP is started. This is the default.

Example

  • Define an interface to be added to the target node during the cutover stage.
    CALL QSYS2.ADD_MIGRATION_INTERFACE(
           CUTOVER_ACTION => 'ADD ON TARGET',  
           IP_ADDRESS => '123.4.5.678', 
           LINE_DESCRIPTION => 'COTTAGELAN', 
           SUBNET_MASK => '255.255.255.0',  
           AUTOSTART => 'NO');
  • Define an interface to be moved from the source node to the target node during the cutover stage.
    CALL QSYS2.ADD_MIGRATION_INTERFACE(
           CUTOVER_ACTION => 'MOVE TO TARGET',  
           IP_ADDRESS => '123.4.5.679', 
           LINE_DESCRIPTION => 'ETHLINE1', 
           SUBNET_MASK => '255.255.255.0');
End of change