Compaq AA-Q88CE-TE - Manual (Page 45)

Partition Management
3.5 Entering Partition Commands
The rtr_set_info( ) call completes asynchronously. If the function call is
successful, completion will be signaled by the delivery of an RTR message
of type
rtr_mt_closed on the channel whose identifier is returned through
the pchannel argument. The programmer should retrieve this message by
using rtr_receive_message( ) . The data accompanying the message is of type
rtr_status_data_t . The completion status of the partition command can be
accessed as the status field of the message data.
3.6 Managing Partitions
To manage partitions a set of commands or program calls are used. Information
on managing partitions is provided in this section.
3.6.1 Controlling Shadowing
The state of shadowing for a partition can be enabled or disabled. This may be
useful in the following circumstances:
• Enabling site disaster protection for an application partition for the first time
• A recovery aid following prolonged outage of a former shadow site.
The following restrictions apply. Shadowing for a partition can be turned off only
in the absence of an active secondary site, The active member must be running
in remember mode. The command will fail if entered on either an active primary
or secondary with a message to this effect. If entered on a standby of either
the primary or secondary, the command is accepted but fails in the RTR router.
This failure is recorded with a log file entry at the router. Once shadowing is
disabled, the secondary site servers will be unable to startup in shadow mode
until shadowing is enabled again. Shadowing for the partition can be turned on
by entering the command at the current active member or on any of its standbys.
3.6.1.1 Command Line Example
RTR> SET PARTITION/FACILITY=Facility1/SHADOW Facility1:Partition1
For further information see the SET PARTITION command in Chapter 6.
3.6.1.2 Programming Information
To enable shadowing, program the set_qualifier argument of rtr_set_info( )
as follows:
rtr_qualifier_value_t set_qualifiers[ 2 ];
rtr_partition_state_t newState = rtr_partition_state_shadow;
set_qualifiers[ 0 ].qv_qualifier = rtr_partition_state;
set_qualifiers[ 0 ].qv_value
= &newState;
set_qualifiers[ 1 ].qv_qualifier = rtr_qualifiers_end;
set_qualifiers[ 1 ].qv_value
= NULL;
To disable shadowing, specify newState as rtr_partition_state_noshadow .
Partition Management 3–5