Start of change

REMOVE_MIGRATION_ROUTE procedure

The REMOVE_MIGRATION_ROUTE procedure removes a route from the list of modifications that will occur on the target node during the cutover stage of IBM i Migrate While Active.

Routes that have been defined can be displayed using MIGRATION_ROUTE_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 REMOVE_MIGRATION_ROUTE ( ROUTE_DESTINATION =>  route-destination ,NEXT_HOP =>  next-hop ,SUBNET_MASK => subnet-mask )

The schema is QSYS2.

route-destination
A character string that specifies the route destination to remove. Can contain the following special value:
*DFTROUTE
Specifies that a default route is being removed. This is the same as specifying a route destination value of 0.0.0.0.
next-hop
A character string that specifies the next gateway on the route.
subnet-mask
A character string that specifies the subnet mask for the route destination. Can contain the following special value:
*NONE
Specifies that no subnet mask is used. This is the same as specifying a subnet mask value of 0.0.0.0. This is the default.

Examples

  • Remove a route so it will not be applied during the cutover stage.
    
    CALL QSYS2.REMOVE_MIGRATION_ROUTE(
                            ROUTE_DESTINATION => '123.45.67.8',
                            NEXT_HOP => '1.2.34.567');
  • Remove a default route so it will not be applied during the cutover stage.
    
    CALL QSYS2.REMOVE_MIGRATION_ROUTE(
                            ROUTE_DESTINATION => '*DFTROUTE',
                            NEXT_HOP => '1.2.34.567');
End of change