retry

Edit online

Use only in conjunction with {--sync-job | -j}. Specifies the number of times to resubmit the command when Command Central gets restarted during a CLI command operation and does not respond within the time interval specified in the {--wait-for-cc | -t} option.

Syntax

{--retry | -y}[count]

Arguments and Options

Argument	Description
`[count]`	Optional. Specifies the number of times to resubmit a command. If you omit the `count` argument, by default the command uses the value of the `CC_RETRY` environment variable. If the `CC_RETRY` environment variable is not set, the command uses 1.

Usage Notes

If {--retry | -y} is not included in the command syntax or is set to 0, the command will not be resubmitted.
If you specify a number for the {--retry | -y} option other than 0, the command waits for Command Central to come online for as many seconds as specified by the {--wait-for-cc | -t} option. If {--wait-for-cc | -t} is specified with no value, the command uses the value of the CC_WAIT environment variable, or 120 seconds if CC_WAIT is not specified. For more information, see sync-job and wait-for-cc.
Use in conjunction with the {--sync-job | -j} and {--wait-for-cc | -t} options to execute commands with long-running operations more reliably. For an example, see the "Examples" section of the sagcc exec templates composite apply.
You can also set retry as a parameter of the cc tasks included in an Ant script that executes CLI commands. See Parameters to Use with the cc Task.

Examples

To enable job monitoring and resubmit the command three times when Command Central is restarted and comes online within 120 seconds or the value of CC_WAIT:
```
--sync-job --retry 3 --wait-for-cc
```