Single-Node Listener States
You can change the state of a single-node listener on all nodes in an Integration Server cluster from any node in the cluster. When a single-node listener is enabled, disabled, or suspended on all nodes in the cluster, the action that a particular node takes depends on:
![*](chapterTOC_bullet.png)
the selected state change on all nodes
![*](chapterTOC_bullet.png)
the listener state on the particular node, that is if the listener thread is running or not
![*](chapterTOC_bullet.png)
whether the particular node is the active (primary) node
For example, if a single-node listener has already been suspended on node A, and then on node B you enable the listener on all nodes in the cluster, node A can:
![*](chapterTOC_bullet.png)
enable the listener, if node A becomes the active node in the cluster.
![*](chapterTOC_bullet.png)
show the listener as enabled without creating a new thread, if another node has already become the active one.
The following table shows what change occurs in the state of a single-node listener on a particular node in the cluster when you enable, disable, or suspend the listener on all nodes.
Listener State on a Particular Node | Enable Listener on All Nodes | Disable Listener on All Nodes | Suspend Listener on All Nodes |
Enabled | No action | ![*](chapterTOC_bullet.png) Disable the listener if this is the active node ![*](chapterTOC_bullet.png) Show the listener as disabled if this is not the active node. No action | ![*](chapterTOC_bullet.png) Suspend the listener if this is the active node ![*](chapterTOC_bullet.png) Show the listener as suspended if this is not the active node. No action |
Disabled | ![*](chapterTOC_bullet.png) Enable the listener if the node acquires the lock on the shared cache and becomes the active node ![*](chapterTOC_bullet.png) Show the listener as enabled if another node has already become the active node. No action | No action | No action |
Suspended | ![*](chapterTOC_bullet.png) Enable the listener if the node acquires the lock on the shared cache and becomes the active node ![*](chapterTOC_bullet.png) Show the listener as enabled if another node became the active node. No action | Show the listener as disabled. No action | No action |
If a single-node listener is active on a particular node and you try to disable it, another Integration Server node's listener will become active if that listener is in an enabled state. If the listener is in a disabled state on all other Integration Server nodes, those nodes will ignore the disable operation.