ECACCES...LE-MOVE(1p)

💖 NAME 💖

okay bestie, so ecaccess-file-move is literally the move-or-rename ECaccess Files girlie 💅 she does both and she does it flawlessly.

---

✨ SYNOPSIS ✨

ecaccess-file-move -version|-help|-manual

ecaccess-file-move [-debug] source-ecaccess-file target-ecaccess-file

like. that's it. that's the whole vibe. 🎀

---

🦋 DESCRIPTION 🦋

so basically ecaccess-file-move lets you move an ECaccess File 🫶 and here's the tea: when the move happens inside the same ECaccess File System, it's a rename — clean, simple, iconic. but when the move goes across two different ECaccess File Systems?? then first a copy gets done and then a delete of the original file gets done (like, e.g. basically the same energy as ecaccess-file-copy ... -erase). no cap. 🌈

now the source-ecaccess-file and target-ecaccess-file are in the form:

[domain:][/user-id/]path

so pls go read the "Shell commands -> File Management" section of the "ecaccess" guide for more info on the ECaccess File System, iykyk 📚✨

---

🌸 ARGUMENTS 🌸

• source-ecaccess-file — the source ECaccess File name. the origin. the beginning of the journey 🦋
• target-ecaccess-file — the target ECaccess File name. the destination. where she's headed 💫

---

👑 OPTIONS 👑

• -version — displays the version number and then exits. short, sweet, done. 💅
• -help — prints a brief help message and exits. your lil quick assist 🎀
• -manual — prints the manual page and exits. that's literally this bestie 📖✨
• -retry count — number of SSL connection retries per 5s to ECMWF. okay important detail: 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 afterward, bc it's 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. for when you wanna see everything going on under the hood 🔍💀

---

💜 EXAMPLES 💜

ecaccess-file-move ec:test1.txt ec:test2.txt

this one renames the test1.txt file in the ECFS directory of the authenticated user into test2.txt. slay. same filesystem, pure rename energy ✨

ecaccess-file-move ec:test1.txt home:test2.txt

and this one copies the test1.txt file from the ECFS directory of the authenticated user to the test2.txt file in the $HOME directory of the authenticated user, then deletes the test1.txt file from ECFS. cross-filesystem, so she does the copy-then-delete combo 🫶🔥

---

⭐ SEE ALSO ⭐

go check out her whole friend group, they're all iconic: ecaccess-file-delete, ecaccess-file-get, ecaccess-file-mget, ecaccess-file-modtime, ecaccess-file-mput, ecaccess-file-rmdir, ecaccess-file-copy, ecaccess-file-dir, ecaccess-file-mdelete, ecaccess-file-mkdir, ecaccess-file-chmod, ecaccess-file-put, ecaccess-file-size and ecaccess. 🌈💖

---

perl v5.40.1 🎀 2025-10-22 — that's the version and the date bestie, written by the User Contributed Perl Documentation girlies, and that's a wrap fr fr 💅✨🦋