NAME¶
ecaccess-ectrans-restart - Restart an existing ECtrans transfer
SYNOPSIS¶
ecaccess-ectrans-restart -version|-help|-manual
ecaccess-ectrans-restart [-debug] [-gateway name] [-remote
location] [-target file-name] [-retryCount
number ] [-retryFrequency frequency]
[-priority priority] [-lifeTime duration]
[-mailTo email] [-onSuccess] [-onFailure] [-onRetry]
[-keep] [-reject|
-append|
-resume|
-overwrite]
[-maximumDuration duration] [-minimumDuration
duration ] [-minimumRate rate] ectrans-id
DESCRIPTION¶
Allow restarting the ECtrans transfer with the
ectrans-id identifier.
In order to get the list of ECtrans transfers and the corresponding
ectrans-id please use the
ecaccess-ectrans-list command. If you
want to setup an ECtrans transfer then use the
ecaccess-ectrans-request
command which will give you an
ectrans-id (this one can be kept for a
later restart).
ARGUMENTS¶
- ectrans-id
- The identifier of the ECtrans transfer to restart.
OPTIONS¶
- -gateway name
- Update the name of the ECaccess Gateway.
- -remote location
- Update the target location in the format
association-name
[@protocol].
- -target file-name
- Update the target file-name.
- -retryCount number
- Update the number of retries.
- -retryFrequency frequency
- Update the frequency of retries in seconds.
- -priority priority
- Update the transmission priority 0-99.
- -lifeTime duration
- Update the lifetime of the transfer request. The
duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or
[s]econds (e.g. 1w or 2d).
- -mailTo email
- Update the target email address.
- -onSuccess
- Allow sending a mail when the transfer is successful.
- -onFailure
- Allow sending a mail when the transfer has failed.
- -onRetry
- Allow sending a mail when the transfer is retried.
- -keep
- Allow keeping the request in the spool until the duration
specified in the -lifeTime option has passed. By default a
successful transfer is removed from the spool.
- -reject
- Allow failing if there is an existing target file.
- -append
- Allow appending if there is an existing target file.
- -resume
- Allow resuming if there is an existing target file.
- -overwrite
- Allow overwriting if there is an existing target file.
- -maximumDuration duration
- Allow updating the maximum transfer duration. The
duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or
[s]econds (e.g. 10m or 1h). A value <=0 will deactivate
the feature.
- -minimumDuration duration
- Allow updating the duration before to control a
transmission (e.g. for the first 10 minutes ECtrans don't try to check the
transfer rate, which allow not to enforce some minimum transfer rates for
very small files). The duration is specified in [w]eeks, [d]ays,
[h]ours, [m]inutes or [s]econds (e.g. 30s or 10m). A value
<=0 will deactivate the feature.
- -minimumRate rate
- Allow updating the minimum transfer rate for a
transmission (expressed in bytes/s). This is an average value, not the
transmission rate at one particular moment in time (e.g. if a big
file is stuck for 5 minutes but then transmit much faster later on then it
will not be interrupted as long as the overall transfer rate is above the
minimum). A value <=0 will deactivate the feature.
- -version
- Display version number and exits.
- -help
- Print a brief help message and exits.
- -manual
- Prints the manual page and exits.
- -debug
- Display the SOAP messages exchanged.
EXAMPLES¶
ecaccess-ectrans-restart 124356
Restart the ECtrans transfer with the identifier
124356.
SEE ALSO¶
ecaccess-ectrans-delete,
ecaccess-ectrans-list,
ecaccess-ectrans-request and
ecaccess.