Configuring ProcessQ calls

ProcessQ.exe can be configured with several parameters. Only -E is required; all other parameters are optional.

-S

Serializes the process calls. The default is parallel execution.

-TP n

Timeout, the number of milliseconds before the RUNNING process will stop. By default, no timeout occurs.

-TL n

Timeout, the number of milliseconds before the LOCKED process will stop. By default, no timeout occurs.

-I

Customized ID for exclusion.

-W n

Window style; see “Controlling the appearance of a new process”.

-D

The working directory for the application.

-E

The executable and its command line parameters. If this value contains spaces, it must be quoted with double quotes.

-P<ExtVar=Value>[,< ExtVar=Value>..,< ExtVar=Value>]

This option allows you to set parameters from the command line that can be used by the job or project during execution. <ExtVar> is an environment variable that you can access in a Sybase IQ ETL object during execution with the uGetEnv() function. Multiple variables are separated by a comma, the full string should be quoted using double quotes. Spaces within a value can be quoted with single quotes. Spaces within the key are not allowed.

Examples

o processq -P "HOME=h:\" -E emacs.exe

o processq -W 0 -S -P Port=8080 -E "d:\tod\engine.exe d:\tod\engineman.lbr"

o processq -P "HOME='h:\BS test 1\BS test'; LANG=de" -E transform.exe

Errorcodes

All error messages during execution are written into a log file. The name of the file will depend on the module name which raises the error, in this case ProcessQ.log. The path is the current working directory and can be set by the environment variable SOLONDE LOG DIR.

Code

Error

1

Invalid usage of command line. This also displays the available options.

2

Error when parsing the command line.

3

Error setting the environment variable.

4

No executable given.

5

Creating mutex failed.

6

Mutex timed out.

7

Creating process (running the executable) failed.

8

Terminating the process failed.