zowe › ca7 › commands › restart🖨️

The RESTART top line command restarts a job awaiting restart in the request queue.
This function is available as the F option on the QM.1 CPU Jobs Status Prompt panel.
You can also use QM.4 CPU Job in the Restart Status Prompt panel to accomplish a job restart.
If CA Workload Automation Restart Option for z/OS Schedulers is used, the CMT is updated with the appropriate restart data.
If CA Workload Automation Restart Option for z/OS Schedulers is not installed,
the starting and ending steps, USAGE, PROCESS, CONDCD, or SUP11STP have no significance.

The cross-platform jobs never use CA Workload Automation Restart Option for z/OS Schedulers services for restart functions.

Usage

zowe ca7 commands restart [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

Options

• --key (string)

  • The command transaction key

• --ca7# (string)

  • Indicates the individual job to restart, and the value must be a CA 7 job number.

• --bypgdg (string)

  • (Optional) Indicates whether CA Workload Automation Restart_XXX Option for z/OS Schedulers bypasses GDG logic on a restart/rerun.
    Value can be NO, YES, VER, or CAT.
    Default: CA Workload Automation Restart_XXX Option for z/OS Schedulers default value

• --condcd (string)

  • (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers condition code
    that the CA Workload Automation Restart_XXX Option for z/OS Schedulers step sets when the rerun is executed.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA Workload Automation CA 7� Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 to 4 numeric characters from 0 to 4095

• --forcecomp (string)

  • (Optional) Indicates whether to flag the job as a normal completion.
    If FORCECOMP=YES, the previous abnormal status of the job is ignored.
    Normal job completion processing is performed instead of a restart.
    Value can be NO or YES. NO is the default.

• --lcc (string)

  • (Optional) Indicates an optional condition code value that replaces the last condition code value for the step that the LSTP references and,
    optionally, LPSTP keywords.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Default: 0
    Limits:
    1 to 4 numeric characters from 0 to 4095

• --lstp (string)

  • (Optional) Indicates an optional step name that has its last condition code value reset in the
    CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    Code LSTP and LCC when LPSTP is specified.
    LSTP requires that an STPSTRT value is specified and that the LSTP step name occurs in the JCL of the job before the STPSTRT step name.
    This option is honored only when CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

• --lpstp (string)

  • (Optional) Indicates an optional step name referencing a procedure that has its last condition code value reset
    in the CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    If LPSTP is used, also code LSTP and LCC.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

• --procstrt (string)

  • (Optional) Indicates an optional step name referencing a procedure where processing is to start.
    If PROCESS=R and PROCSTRT are used, also code STPSTRT.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

• --procend (string)

  • (Optional) Indicates an optional step name referencing a procedure where processing is to end.
    If PROCESS=R and PROCEND are used, code STPEND.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

• --process (string)

  • (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers processing function code character to use in the restart/rerun.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel. Value can be F, P, S, N, O, or R.
    Default: P
    Limits:
    1 alphabetic character

• --reason (string)

  • (Optional) Specifies a reason for the restart.
    If the CA Workload Automation Restart_XXX Option for z/OS Schedulers Reason-for-Rerun module is available,
    a code of up to four characters can be input and it is expanded.
    Any reason input or expanded is copied to the run log.
    This field is optional unless CA Workload Automation Restart_XXX Option for z/OS Schedulers requires a reason or
    REASON=YES was specified in the RESTART statement in the initialization file.
    Limits:
    1 to 40 alphanumeric characters

• --stpend (string)

  • (Optional) Indicates an optional step name or number at which processing is to end.
    f not specified, the last step of the job is assumed to be the ending step.
    Code STPEND when PROCEND is specified.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

• --stpstrt (string)

  • (Optional) Indicates an optional step name or number at which processing is to start.
    If STPSTRT is not coded, the first step of the job is assigned to be the starting step.
    Code STPSTRT when PROCSTRT is specified. This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    It can be one of stepname
    Specifies the step name or number at which processing is to start. *CMT*
    Indicates that the job is to restart with the step values currently on the CMT record. *RERUN*
    Indicates to rerun t the total job. If there are no restartable steps, specify *RERUN*. *RESUBP*
    Indicates that the CMT record of the job is set to production, and then the job is submitted.

• --sup11stp (string)

  • (Optional) Indicates whether to suppress the insertion of the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    If the job is resubmitted with SUP11STP=YES, the CA Workload Automation Restart_XXX Option for z/OS Schedulers step is not inserted.
    Only valid if CA WA CA 7 Edition is inserting the CA Workload Automation Restart_XXX Option for z/OS Schedulers step.
    See the INSERT-RMS field on the DB.1 panel.
    Value can be NO or YES. NO is the default.

• --usage (string)

  • (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers usage code of the character to use in the restart/rerun.
    For the values, see the CA Workload Automation Restart_XXX Option for z/OS Schedulers documentation.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use and
    CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 alphanumeric character

• --ca11rstp (string)

  • (Optional) Indicates that the RESTART command should return the job jobstep.procstep information from the CA Workload Automation Restart_XXX Option for z/OS Schedulers (CA-11) database (if available) in a SRJ2-55 message.
    YES or Y are the only valid values. If YES or Y is specified, no other keywords are allowed, and no attempt is made to restart the job.

CA7 Connection Options

• --host | -H (string)

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

• --port | -P (number)

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

• --user | -u (string)

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

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

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

• --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).

    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.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

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

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

Examples

• Restarts a job awaiting restart in the request queue for jobs AJOB* on instance1:

  • zowe ca7 commands restart --ca7# AJOB* --ca7Id Instance1 Copy