TRIM FACILITY

TRIM FACILITY

Removes nodes or roles or both from an existing facility definition.

Format

TRIM FACILITY [facility_name]

Command Qualifiers

Defaults

/BACKEND=backend-list

/NOBACKEND

/CLUSTER

/NOCLUSTER

/FRONTEND=frontend-list

/NOFRONTEND

/NODE[=node-list]

/NODE=default-node-list

/OUTPUT[=file-spec]

/OUTPUT=stdout

/ROUTER=router-list

/NOROUTER

Description

The TRIM FACILITY command removes nodes or roles or both from an RTR facility definition. A node can be removed from a facility or a role can be removed from a node. For example, a node having both router and frontend roles can be trimmed to have only a router role.

A TRIM FACILITY command resulting in the removal of all roles is equivalent to a DELETE FACILITY command.

A frontend role can be removed from a node with the router role as long as there is at least one other frontend defined.

A backend role can be removed from a node with the router role as long as at least one other backend is defined. A command to remove a backend role should be executed on all router nodes to avoid problems with inconsistent facility definitions.

If a router role is removed, then the node from which it is removed will discard its knowledge of other backends and frontends in the facility. If the router role is re-added to the node (using EXTEND FACILITY), this information will have to be specified again.

In order to have a consistent facility definition across the nodes of the facility (avoiding problems with attaining quorum), the command to remove a router role must be executed on all relevant nodes. This means executing the command on the node losing the router role, plus all backend and frontend nodes which know about this router.

As with CREATE or MODIFY 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.

When using this command, the facility being extended may 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.

RTR Command Line Interface 6–179

Page 255
Image 255
Compaq AA-Q88CE-TE manual Trim Facility facilityname