zowe › ca7 › run › job🖨️

The value must be a job name.
If the job has not been defined in the database, this name must also match the member name for the JCL unless the job is defined in the database.
this name must also match the member name for the JCL unless the job is defined in the database.
See also JCLID. JOB and JOBL are mutually exclusive.

Usage

zowe ca7 run job <job> [options]

Positional Arguments

• job (string)

  • job=PAYROLL

    Defines the long name of the job to run.
    The ran jobs are placed in the request queue and assigned a unique CA 7 job number.

Options

• --arfset | --as (string)

  • arfset={arfsetname|**NONE**}

    Defines the ARF set name that is used for this run of the job.
    If you specify **NONE**, no ARF processing is performed for this run of the job.

    Limits: 1 to 8 alphanumeric characters or **NONE**

• --wlbclass | --wc (string)

  • class=x

    Defines the workload balancing class for resource checking.

    Limits: 1 alphanumeric character

• --dotm (string)

  • dotm=hhmm

    Defines the due-out time-of-day for the job in hours (hh) and minutes (mm).
    If DOTM is specified on the DEMAND/DEMANDH command and the value that is given is earlier than the current time, the due-out day is assumed to be the following day.

    If DOTM and LEADTM are both omitted, then deadline start time is assumed to be the current time plus the LEADTM.

    Limits: hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

    Required: No (unless DATE is used, if so, DOTM or TIME must be specified)

• --exec | -e (string)

  • exec={NO|YES}

    Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run. The value that is specified here overrides the value that is coded on the job definition EXEC field.

    Default: The job definition panel EXEC value if the job is defined to CA WA CA 7 Edition; otherwise YES.

• --inboxnod | --ibn (string)

  • inboxnod=MYWEBNODThe Web Service node where events associated with the job are to be delivered.

    Limits: 1 to 8 alphanumeric characters

• --jclid | --ji (string)

  • jclid=nnn

    Defines the JCL data set that contains the execution JCL to be submitted.

    If used, the value must be a numeric INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).

    Limits: 1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.

• --jcllib | --jl (string)

  • jcllib=&x...x

    Defines the JCL data set that contains the execution JCL to be submitted.

    If used, the value must be a symbolic INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).

    Limits: 2 to 16 alphanumeric characters beginning with ampersand (&)

• --late (string)

  • late={NO|YES}

    Specifies whether a notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE. If NO (N) is used, the job is never marked LATE. The value that is specified here overrides the value that is coded on the job definition PROMPTS field.

• --leadtm | --lt (string)

  • leadtm={0100|hhmm}

    Defines the amount of elapsed time that is required to process the job.
    Default: 1 hour
    Limits: hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

• --mainid | --mi (string)

  • mainid={ALL|SYn|/SYn|-SYn}

    Specifies the MAINID, as defined in the initialization file CPU statement, to which you want to redirect the job.

    ALL
    Specifies all CPUs are acceptable for executing the job.

    SYn
    n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7.

    /SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.

    -SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.

    Limits: Invalid for internal cross-platform jobs.

• --rms (string)

  • rms={NO|YES}

    Specifies whether CA WA CA 7 Edition inserts the CA Workload Automation Restart Option for z/OS Schedulers RMS step.

    Specify YES (Y) to insert the step with the CA Workload Automation Restart Option for z/OS Schedulers processing code of P. Enter NO (N) to indicate do not insert of the RMS step.

    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits: Invalid for internal cross-platform jobs.

• --schid | --si (string)

  • schid={1|nnn}

    Defines the schedule ID within the job’s total schedule definition to use for this run.

    Default: 1
    Limits: 1 to 3 numeric characters from 1 to 255 (See Note)

    If the SCHEDULE statement in the initialization file specifies SCHID=YES, this parameter is required.

• --time (string)

  • time={hhmm|+hhmm}

    Defines a submit time-of-day requirement for the job.

    Limits: + is optional
    hh= 1 through 2 numeric characters from 0 to 23
    mm= 2 numeric characters from 00 to 59

    Required: No (unless DATE is used, if so, specify DOTM or TIME (hhmm format). Also required if TYPE=CLOCK is specified.

• --type (string)

  • type={CLOCK|END|RES|START}

    TYPE=RES specifies the job is being scheduled in restart/rerun status.
    TYPE=CLOCK, START, or END controls how the submit time requirement is calculated for repeating jobs.

    Limits: RES, CLOCK, START, or END

CA7 Connection Options

• --host | -H (string)

  • Host name of the CA7 API service that is running on the mainframe system.

    Default value: localhost

• --port | -P (number)

  • Port for the CA7 API service that is running on the mainframe system.

    Default value: 8080

• --user | -u (string)

  • User name for authenticating connections to the CA7 API service that is running on the mainframe system.

    Default value: MASTER

• --password | --pass | --pw (string)

  • Password for authenticating connections to the CA7 API service that is running on the mainframe system.

    Default value:

• --base-path | --bp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

• --protocol | -o (string)

  • Specifies protocol to use for CA7 connection (http or https).

    Default value: https
    Allowed values: http, https

Profile Options

• --ca7-profile | --ca7-p (string)

  • The name of a (ca7) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Run a job, PAYROLL to CA 7:

  • zowe ca7 run job PAYROLL Copy