Software Delivery › Folders › Software Package Library › Software Package Library Folder › Procedures › Procedure Parameters › Parameter Macros › Job Related Macros

Job Related Macros

$rf

Creates a result file to view the output of a job.

1. If the application has a parameter to write output to a file, for example /F, then /F:$rf can be specified (if the syntax for the command states /F:file).

2. If the application writes to stdout, you can redirect to the output file with >$rf. Refer to the last section on this page.

To view the output of a job, select a Job Target in the right pane, by expanding a job in the Jobs list. Right-click and select Properties... in the context menu. In the Job Target Properties dialog that appears, select the Job output tab. The result file will be displayed.

$up

Selection of this macro enables setting User parameters in the Job Options tab.

$joid

Expands to the job object identifier (this can be useful when creating unique keys).

$#bg

Runs the job in the background.

$#ec:xx

Overrides the usual exit code interpretation (where exit code=0 means OK, otherwise error). You can change this by an explicit specification of the exit code interpretation. The specification can be done in either of the following four ways (and the specifications can be concatenated).

$#ec:a-b

where a denotes the start of the interval and b the stop.

$#ec:a-

where a denotes the start of the interval (which is open upwards).

$#ec:-b

where b denotes the stop of the interval (which is open downwards, that is, starting with 0).

$#ec:b

where b denotes the specific exit code.

Example:

$#ec:3010 $#ec:0-100. Here exit code 3010 and all codes in the interval 0 to 100 are interpreted as OK.