Stops an agent.
Syntax
sqdconf stop <cab_file_name>
[--flush]
[--unmount]
[--failover]
[–-delay=<number>]
Keyword and Parameter Descriptions
| Keyword | Description |
|---|---|
| [--flush] | Instructs the agent to complete publishing the current unit-of-work and then Stop. Precisely how long the agent, and connected downstream Apply Engines remain connected cannot be predicted since the unit-of-work could be of any size. Without this parameter the default action is for the agent to Stop immediately. |
| [--unmount] | Take an agent offline in the same manner as the sqdconf unmount command but with a single execution of the sqdconf utility. |
| [--failover] | z/OS based capture/publishers ONLY. Instructs the agent to tell Engines, connected at the time the Stop is issued, to attempt to reconnect for approximately 10 minutes. This is intended to allow for z/OS source side maintenance or capture/publisher configuration changes to be made using the typical "Stop/Apply/Start" sequence without requiring downstream Engines to be manually restarted. |
| [--delay=<number>] | z/OS based DB2z capture/publishers ONLY. Instructs the agent to tell Engines, connected at the time the Stop is issued with --flush and --failover options, to attempt to reconnect for approximately as many number of minutes or 10 times retries, the number provided with this option. |
Note: Agent must be Mounted (executing on z/OS) and in a Started or Paused state before it can be Stopped.