SWAP_MIRROR_TAKEOVER_GROUP procedure

The SWAP_MIRROR_TAKEOVER_GROUP procedure repositions a takeover IP address group to the other node. If the takeover IP address group is currently active on the primary node, it will be changed to run on the secondary node. If the takeover IP address group is currently active on the secondary node, it will be changed to run on the primary node.

The current node as returned by the QSYS2.MIRROR_TAKEOVER_INFO view will change. The preferred node is not changed.

This procedure will initiate the switchover for all active TCP/IP interfaces in the group.

Authorization: For the authority needed to use this procedure, see Authorization.

Read syntax diagramSkip visual syntax diagram SWAP_MIRROR_TAKEOVER_GROUP ( GROUP_NAME =>  group-name )

The schema is QSYS2.

group-name
A character or graphic string that contains the name of the takeover IP address group to be repositioned to the other node.
group-name must have been registered with the QSYS2.CREATE_MIRROR_TAKEOVER_GROUP procedure.

Example

  • To prepare for a planned outage, move an active takeover IP address group to the other node.
    CALL QSYS2.SWAP_MIRROR_TAKEOVER_GROUP(GROUP_NAME => 'GROUP1');