Compaq AA-Q88CE-TE manual $ RTR RTR SET Environment /NODE=FE,FETRBE, Backend=Fetrbe, $ Rtr

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–92RTR Command Line Interface