ECACCES...ION-PUT(1p)

💖 ecaccess-association-put — the one where you drop an Association into the world 💖

okay bestie, so this page is ecaccess-association-put from section 1p of the User Contributed Perl Documentation, and it's literally the glow-up tool for ECtrans Associations. no cap. 💅

---

✨ NAME ✨

ecaccess-association-put — Update/Create an Association 🦋

---

🌸 SYNOPSIS 🌸

ecaccess-association-put -version|-help|-manual

ecaccess-association-put [-debug] [-gateway name] [-password] source-
file

like, that's the whole vibe. two shapes: either you're asking for info, or you're actually pushing a file. ✨

---

💫 DESCRIPTION 💫

So this command lets you update or create an ECtrans Association. Here's the tea: if the name already exists, the Association gets updated. If it does not exist, a brand-new Association gets created. Either way, main character energy. 👑

Wanna get a starter template for a new Association? Run this little gem:

ecaccess-association-get -template association-name target-file

Now, super important bestie: the target-file for the Association Descriptive File does not have to match the name of the Association itself. The name for the Association is specified in the association-name parameter. so don't stress about the filename matching, it's not that deep. 🌈

And when you're creating a new Association, you should use the -password option to set the password — because it can not be set in the Association Descriptive File, since that would not be secure. 🔒 like, do not put your password in a file, I'm begging.

---

🎀 ARGUMENTS 🎀

• source-file — the name of the Association Descriptive File you wanna upload. that's it, that's the whole argument. 🫶

---

💅 OPTIONS 💅

• -gateway name — the name of the ECaccess Gateway where the Association should be installed. It's by default the Gateway you are connected to. Wanna know your current Gateway's name? Use the ecaccess-gateway-name command. And when you're using the commands at ECMWF, the default Gateway is always "boaccess.ecmwf.int". ⭐
• -password — allows prompting for a new password for the Association. 🍓
• -version — displays the version number and exits. short and sweet.
• -help — prints a brief help message and exits.
• -manual — prints the manual page and exits.
• -retry count — number of SSL connection retries per 5s to ECMWF. real talk: this parameter only applies to the initial SSL connection initiated by the command to the ECMWF server. It does not apply to all the subsequent requests made afteward, because it is mainly targeting errors that can happen from time to time during the SSL handshake. Default is no retry. 🙈
• -debug — displays the SOAP and SSL messages exchanged. perfect for when you need to see everything. 👀

---

🔥 EXAMPLES 🔥

ecaccess-association-put -password ./test

Push the Association described in the ./test file of your current directory on your default Gateway. You will also be prompted for a new password. iconic. ✨

ecaccess-association-put -gateway boaccess.ecmwf.int ./test

Push the Association described in the ./test file of your current directory on the boaccess.ecmwf.int Gateway. slay. 💖

---

🦋 SEE ALSO 🦋

• ecaccess-association-delete
• ecaccess-association-get
• ecaccess-association-list
• ecaccess-association-protocol
• ecaccess

go read those too, they're all part of the same friend group. 🫶

---

ngl, if you're setting a password for a new Association, use -password — the Association Descriptive File is not the place for secrets. periodt. 💀

---

okay and that's the whole page bestie!! this one's from perl v5.40.1, dated 2025-10-22 — so yeah, it's giving vintage-but-thriving. go forth and push those Associations, you absolute legend. 👑✨💜