dssstart - DSS 6 | Data Source Solutions Documentation
Documentation: dssstart - DSS 6 | Data Source Solutions Documentation
dssstart
Usage
<b>dssstart</b> [<b>-R</b><em>url</em>] [<em>-options</em>] <em>hub</em> <em>jobs…</em>
Description
Command dssstart starts DSS jobs. The started jobs are run by the Scheduler. Jobs can be specified explicitly (e.g. chn-cap-locx) or partially (e.g. chn-cap, which matches all capture jobs). If only a channel (chn) name is specified, dssstart runs the capture jobs (chn-cap) and then the integrate jobs (chn-integ).
Command dssstart will not start the jobs in the SUSPEND state unless option <b>-u</b> is used. Jobs in the FAILED or RETRY states will not be started unless option <b>-r</b> is used. In this mode, the Scheduler process must already be running. If the job is already running, then the Scheduler will force the job to wake up and perform a new replication cycle.
Options
This section describes the options available for command dssstart.
| Parameter | Description |
|---|---|
-i |
Run jobs directly in the command line instead of via the Scheduler. The job output and errors are sent to stdout and stderr. Note that replication jobs (capture/integrate) will run only one cycle. Before using this option, make certain the same job is not running in the Scheduler. Single job run in parallel may cause corruption. |
-r |
Retry jobs in the FAILED or RETRY states by triggering them with value 2 in column job_trigger of the DSS_JOB repository table. This option cannot be combined with option-i. |
-Rurl |
Remote hub server. Access the hub server running on a remote machine, via the REST interface. This option is required for remote CLI access. When using this option, command dsslogin should be run first, for authentication. |
-u |
Start jobs in SUSPEND state. This option cannot be combined with option-i. |
-w |
Wait until all of the selected running jobs have finished or have completed a full replication cycle. While dssstart is waiting for a job, its output is carbon-copied to the stdout and stderr of the dssstart command. This option cannot be combined with option-i. |
Examples
This section provides examples of using the dssstart command.
Example 1. Start capture job
The following command starts a capture job:
dssstart <em>hub chn</em>-cap-<em>loc </em>
Example 2. Start integrate job
The following command starts all integrate jobs:
dssstart <em>hub chn</em>-integ
Example 3. Start capture and integrate jobs
The following command starts all capture jobs and then all integrate jobs:
dssstart <em>hub</em> <em>chn</em>
Example 4. Start refresh job
The following command starts a refresh job:
dssstart <em>hub chn</em>-refr-<em>loc1-loc2 </em>