run

This command runs a job.

Syntax

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

Arguments

jobname

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

Options

-r, priority=<value>

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

-a, --as=<value>

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=[<value>]

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=<value>

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.

-e, --detail

Lets user display detailed message information.

-P, --policy=<value>

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

-F, --policyfile=<value>

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=<value>

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.

-z, --tls=<value>

Force TLS/SSL encryption [on|off]. The user must enter a value with this option.

-Z, --tlsPort=<value>

Port number for TLS/SSL connections. The user must enter a value with this option.

-y, --tlsYesNew

Force acceptance of new TLS server certificates.

-Y, --tlsYesAll

Force acceptance of all TLS server certificates.

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 passing a local policy file, the user would use the following command:

zos run unittest --policyfile=/tmp/mypolicy.policy

Example 4

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/08 5:01 PM".