zowe › ca7 › commands › restart🖨️

Restart a single job to CA 7.

Usage

zowe ca7 commands restart [options]

Required Options

• --ca7num (string)

  • ca7num=0016

    Defines the name of the job to Restart.
    Indicates the individual job to Restart, and the value must be a CA 7 job number.

Options

• --bypgdg | --bp (string)

  • bypgdg={NO|YES|VER|CAT}

    Indicates whether CA Workload Automation Restart 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 Option for z/OS Schedulers default value

• --condcd | --cc (string)

  • condcd=nnnn

    Indicates an optional CA Workload Automation Restart Option for z/OS Schedulers condition code
    that the CA Workload Automation Restart Option for z/OS Schedulers step sets when the rerun is executed.

    This option is honored only if CA Workload Automation Restart 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 | --fc (string)

  • forcecomp={NO|YES}

    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)

  • lc=nnnn

    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 Option for z/OS Schedulers is in use.

    Default: 0
    Limits: 1 to 4 numeric characters from 0 to 4095

• --lstp (string)

  • lstp=JS050

    Indicates an optional step name that has its last condition code value reset in the
    CA Workload Automation Restart 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 Option for z/OS Schedulers is in use.

    Limits: 1 to 8 alphanumeric characters

• --lpstp (string)

  • lpstp=COPY010

    Indicates an optional step name referencing a procedure that has its last condition code value reset
    in the CA Workload Automation Restart 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 Option for z/OS Schedulers is in use.

    Limits: 1 to 8 alphanumeric characters

• --procstrt | --ps (string)

  • procstrt=procname

    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 Option for z/OS Schedulers is in use.

    Limits: 1 to 8 alphanumeric characters

• --procend | --pe (string)

  • procend=procname

    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 Option for z/OS Schedulers is in use.

    Limits: 1 to 8 alphanumeric characters

• --process (string)

  • process=code

    Indicates an optional CA Workload Automation Restart 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 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 | -r (string)

  • reason=text

    Specifies a reason for the restart.
    If the CA Workload Automation Restart 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 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 | --se (string)

  • stpend=stepname

    Indicates an optional step name or number at which processing is to end.
    If 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 Option for z/OS Schedulers is in use.

    Limits: 1 to 8 alphanumeric characters

• --stpstrt | --ss (string)

  • stpstrt={stepname|*CMT*|*RERUN*|*RESUBP*}

    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 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 | --su (string)

  • sup11stp={NO|YES}

    Indicates whether to suppress the insertion of the CA Workload Automation Restart Option for z/OS Schedulers RMS step.

    If the job is resubmitted with SUP11STP=YES, the CA Workload Automation Restart Option for z/OS Schedulers step is not inserted.

    Only valid if CA WA CA 7 Edition is inserting the CA Workload Automation Restart 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)

  • usage=code

    Indicates an optional CA Workload Automation Restart 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 Option for z/OS Schedulers documentation.

    This option is honored only if CA Workload Automation Restart 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 | -c (string)

  • ca11rstp={Y|YES}

    Displays the CA11 restart step. Value can be Y or YES.

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

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

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

Examples

• Restart ca7 number, 0016 from CA 7:

  • zowe ca7 commands restart --ca7num 0016 Copy