Start of change

CHANGE_MIRROR_TAKEOVER_GROUP procedure

The CHANGE_MIRROR_TAKEOVER_GROUP procedure allows attributes of a takeover IP address group to be changed.

Changes made by this procedure affect future transitions. No action will be taken to modify an active takeover IP address group to conform to this changed definition. For example, if the preferred node is currently ACTIVE and the takeover IP address group is active on the backup node, it will not be switched by changing auto-switchback to YES.

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

Read syntax diagramSkip visual syntax diagram CHANGE_MIRROR_TAKEOVER_GROUP ( GROUP_NAME =>  group-name ,PREFERRED_NODE => preferred-node,IASP_NAME => iasp-name,TEXT_DESCRIPTION => text-description,AUTO_SWITCHBACK => auto-switchback )

The schema is QSYS2.

group-name
A character or graphic string that contains the name of an existing takeover IP address group that is to be modified.
preferred-node
A character or graphic string that indicates the name of the initial node that will be used for starting the IP interfaces for the IP addresses in this takeover IP address group. This must be the partition name of one of the Db2® Mirror nodes. If this parameter is omitted, the preferred node of the takeover IP address group is not changed.
iasp-name
A character or graphic string that contains the device description name of the independent auxiliary storage pool (IASP) where the takeover IP address group is to be located. For an IASP group, specify the device description name of the primary IASP. Can contain the following special value:
*SYSBAS
group-name is to be located in SYSBAS. SYSBAS includes the system ASP (ASP 1) and the basic user ASPs (ASPs 2-32).

If this parameter is omitted, the location of the takeover IP address group is not changed.

text-description
A character or graphic string that contains descriptive text associated with this takeover IP address group. It can be up to 50 characters long. If this parameter is omitted, the text description of the takeover IP address group is not changed.
auto-switchback
A character or graphic string that indicates whether this takeover IP address group should be automatically switched back to its preferred node when the node returns to ACTIVE state.
NO
Manual intervention is needed to return this takeover IP address group to its preferred node.
YES
The system will automatically return this takeover IP address group to its preferred node.

If this parameter is omitted, the automatic switch back setting of the takeover IP address group is not changed.

Example

  • Change a takeover IP address group to have its preferred node as NODE2 and have the system automatically switch this group back to the preferred node when the node returns to ACTIVE state.
    CALL QSYS2.CHANGE_MIRROR_TAKEOVER_GROUP(GROUP_NAME  => 'GROUP1',
                                   PREFERRED_NODE   => 'NODE2',
                                   AUTO_SWITCHBACK  => 'YES');
End of change