ECACCES...REQUEST(1p)

📦
version 6.3.1 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 ECACCES...REQUEST(1p) — the ecaccess-ectrans-request era 💖

okay bestie, pull up a chair, because this is the Perl manual page for ecaccess-ectrans-request and it's literally the girlboss of file transfers 🦋

✨ NAME ✨

ecaccess-ectrans-request — Request a new ECtrans transfer 💅

🌸 SYNOPSIS 🌸

ecaccess-ectrans-request -version|-help|-manual

ecaccess-ectrans-request [-debug] [-gateway name] [-target file-name]
[-retryCount number] [-retryFrequency frequency] [-priority priority]
[-lifeTime duration] [-mailTo email] [-onSuccess] [-onFailure]
[-onRetry] [-deleteSource] [-keep] [-reject|-append|-resume|-overwrite]
[-maximumDuration duration] [-minimumDuration duration] [-minimumRate
rate] association-name[@protocol] source

👑 DESCRIPTION 👑

So here's the tea ☕ — this command lets Member State users kick off file transfers between ECMWF and Member State servers. The ECaccess Server spools the ECMWF file you named in the source parameter straight into your very own ECtrans transfer queue 🎀

and like… if the connection between the ECMWF and Member State gateways is down, or literally any error pops off, the file just chills in the spool area at ECMWF 🫶 You can resume the transfer through the web interface or with the ecaccess-ectrans-restart command. And if you want it to just handle itself? The transfer can be retried automatically — peep the -retryCount and -retryFrequency options to tailor that retry mechanism ✨

The -reject, -append, -resume and -overwrite options are mutually exclusive — pick one, bestie — and they decide what happens if there's already a target file sitting there. The -mailTo option sets an email address to be notified on a successful transfer (-onSuccess) and/or a failed one (-onFailure) 💌

When a request has been spooled successfully, an ectrans-id is returned immediately. That ectrans-id is your little handle to reference the transfer — use it with the web interface, or with the ecaccess-ectrans-delete, ecaccess-ectrans-list or ecaccess-ectrans-restart commands. iykyk 💅

🧚 ARGUMENTS 🧚

  • association-name[@protocol] — the ECtrans Association, with optionally the name of the protocol to use. yes, "optionnaly" is how the original spells it and we respect the queen's spelling 🙈
  • source — Name of the file at ECMWF to spool in ECtrans. that's the whole vibe ⭐

✨ OPTIONS ✨

  • -gateway name — This is the name of the ECaccess Gateway where the ECtrans Association association-name is defined. It's by default the Gateway you're connected to. Wanna know which Gateway that is? Use the ecaccess-gateway-name command 🦋 And heads up: when you're using the commands at ECMWF, the default Gateway is always "boaccess.ecmwf.int".
  • -target file-name — Defines the target file-name (default: same as source). 🎀
  • -retryCount number — Defines the number of retries (default: 144). 🔁
  • -retryFrequency frequency — Defines the frequency of retries in seconds (default: 600 seconds). ⏰
  • -priority priority — Defines the transmission priority 0-99 (default: 99). 👑
  • -lifeTime duration — Defines the lifetime of the request (default: 7 days). The duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or [s]econds (e.g. 1w or 2d). 🌈
  • -mailTo email — Defines the target email address (default: <user-id>@ecmwf.int). 💌
  • -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. 🔁
  • -deleteSource — Allow deleting the original source file once it is safe in the spool. 💀 (gone but not forgotten)
  • -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 (default). 🚫
  • -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 — Define 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 (default: 12h). ⏳
  • -minimumDuration duration — Allow setting 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 (default: 10m). 🕰️
  • -minimumRate rate — Allow setting a 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 (default: 10240). 📈
  • -version — Display version number and exits. 🌟
  • -help — Print a brief help message and exits. 🆘
  • -manual — Prints the manual page and exits. 📖
  • -retry count — Number of SSL connection retries per 5s to ECMWF. This parameter only apply to the initial SSL connection initiated by the command to the ECMWF server. It does not apply to all the subsequent requests made afteward as it is mainly targeting errors that can happen from time to time during the SSL handshake. Default is no retry. 🔐
  • -debug — Display the SOAP and SSL messages exchanged. 🐛

🎀 EXAMPLES 🎀

ecaccess-ectrans-request -lifeTime 2d -overwrite -onFailure -onRetry
test@genericFtp ec:test.txt

Request a file transfer of the ec:test.txt file to the default gateway with the association test and the protocol genericFtp. If the target file already exists then the original file is deleted. If the transfer is retried or fail then an email is sent to the default email address (<user-id>@ecmwf.int). After 2 days the file is removed from the spool (whatever the status of the transmission is). 🦋

ecaccess-ectrans-request -minimumDuration 10m -maximumDuration 35m
-minimumRate 8192 test@genericFtp ec:test.txt

After 10 minutes ECtrans will start to control the transfer rate. If after 35 minutes the file is still not transmitted or if at a certain point in time the average transmission rate is less than 8Kbytes/s then the transmission will be canceled. If canceled, the transmission will be retried 144 times (with a 10 minutes interval). 🔥

💜 SEE ALSO 💜

ecaccess-ectrans-delete, ecaccess-ectrans-list, ecaccess-ectrans-restart and ecaccess.

and that's the whole page, bestie 🫶 this was served up by perl v5.40.1 on 2025-10-22 — go forth and transfer, you absolute icon 👑✨

📦 where this page comes from