EXTEND FACILITY

EXTEND FACILITY

Adds new nodes or roles or both to an existing facility definition.

Format

EXTEND FACILITY [facility_name]

Command Qualifiers

Defaults

/BACKEND=backend-list

/NOBACKEND

/BALANCE

/NOBALANCE

/CALL_OUT=role-list

/NOCALL_OUT

/CLUSTER

/NOCLUSTER

/FRONTEND=frontend-list

/NOFRONTEND

/NODE[=node-list]

/NODE=default-node-list

/OUTPUT[=file-spec]

/OUTPUT=stdout

/ROUTER=router-list

/NOROUTER

Description

The EXTEND FACILITY command extends the configuration of an RTR facility. New nodes and roles can be added to a facility definition using the EXTEND FACILITY command. Thus a new node can be introduced into a facility, or a new role can be added to an existing node (for example, a router node can be extended to have a backend role).

Notes:

New router nodes must have all backend nodes defined and new backend nodes must have all router nodes defined.

Routers need only be defined with the frontends that they can connect to.

Frontends need only be defined with the routers they can connect to.

When using this command, the facility being extended may temporarily lose quorum until the affected nodes agree upon the new facility definition. During this time server applications will not be presented with any new transactions.

The RTR MONITOR QUORUM displays a monitor picture which allows the quorum negotiations to be followed after a TRIM or EXTEND of a facility. Once quorum has been attained, the participating nodes return to state ``qrt''.

As with CREATE FACILITY, nodes or roles may be specified which are superfluous. That is, you may specify backend nodes on a node which only has a frontend role, and frontend nodes may be specified on a node which only has a backend role. This permits a single RTR management command to be issued on many nodes, and each node only accepts those parts of the command which are relevant to it.

For example, in a two node facility called facnam, the node FE has the frontend role only, and node FETRBE that has frontend, router and backend roles can be created as follows:

RTR Command Line Interface 6–91

Page 167
Image 167
Compaq AA-Q88CE-TE manual Extend Facility facilityname