run

This command runs a job.

Syntax

zos run jobname [--priority=] [--as=] [--watch] [--env=] [--start=]                  [--listen] [--policy=] [--trace]

Arguments

jobname

The user must enter the name of the job he or she wants to run.

Options

-r=, priority=

Specifies the priority level for a job. The user must enter a value with this option.

-a=, --as=

Specifies the name of the job instance. The user must enter a value with this option.

-W, --watch

Lets user watch job log messages in real time.

-V=, --env=

Lets user use the local environment for running a job or to use an optional list. The user must enter a value with this option.

-s=, start=

Specifies the start time for a job. The user must enter a value with this option.

-l, listen

Lets user listen for job messages until the job is completed.

-P=, policy=

Lets the user specify the policy file to be associated with this job. The user must enter a value with this option.

-t, --trace

Lets the user turn on event tracing for this job.

-C=, --cols=

Specifies the terminal width for formatting. The user must enter a value with this option.

-h, --help

Displays a help message for this operation.

-d, --debug

Turns on debug output during this operation.

-v, --verbose

Turns on verbose output during this operation.

Examples

Example 1

To run the job called unittest with the highest priority and another parameter, the user would use the following command:

zos run unittest --priority=highest testno=test57

Example 2

To run the job called unittest passing the PATH environment variable only, the user would use the following command:

zos run unittest --env=PATH

Example 3

To run the job called unittest at 5:01 p.m., the user would use the following command:

zos run unittest --start="5:01 PM"

NOTE:The date and time values should be specified as shown in the example—in the format MM/DD/YY hour:minute AM/PM and enclosed in quotes—"11/21/05 4:04 PM".