Compaq AA-Q88CE-TE User Manual
Page 168
EXTEND FACILITY
$ RTR
RTR> SET ENVIRONMENT /NODE=(FE,FETRBE)
RTR> CREATE FACILITY facnam /FRONTEND=(FE,FETRBE) -
/ROUTER=FETRBE -
/BACKEND=FETRBE
A new frontend
NFE
can be added to this facility as follows:
$ RTR
RTR> SET ENVIRONMENT /NODE=(FETRBE,NFE)
RTR> EXTEND FACILITY facnam /FRONTEND=NFE -
/ROUTER=FETRBE
Parameters
facility_name
Specifies the name of the facility to be extended.
Any application program which uses this facility must specify the same name
when it calls the
rtr_open_channel
.
Facility names can contain up to thirty-one characters. Letters, numbers and
underline characters are all valid, but the first character of a facility name must
be a letter.
The default value for
facility_name
is
RTR$DEFAULT_FACILITY
.
The
/ROUTER
qualifier, and at least one of
/FRONTEND
or
/BACKEND
must be
specified.
An EXTEND FACILITY command executed on a node where the facility is not
defined is interpreted as a CREATE FACILITY command.
To maintain consistency in a facility, the following rules apply when adding nodes
or roles or both:
If a frontend role is added, then the node where it is added must know about
at least one router of the facility.
If a backend role is added, then the node where it is added must know about
all routers of the facility. If any router nodes are not known by a backend,
then problems may occur in achieving quorum.
If a router role is added, then the node upon which it is added must know
about all backends of the facility. If not all backend nodes are known by a
router, then problems will occur in achieving quorum. At least one frontend
must be defined on a node that has the router role.
In order to have a consistent facility definition across all nodes in the facility
(and thus avoid problems in attaining quorum), the command to add a router
role must be executed on all relevant nodes, that is, the node gaining the
router role and all backend nodes.
Qualifiers
/BACKEND=backend-list
/NOBACKEND (D)
Specifies the names of the added nodes that are to act as backends for this
facility.
6–92 RTR Command Line Interface