...
NOTE: Files are removed from ECFS with a soft-delete: files will still be kept for some time (currently 30 days) during which it will be possible, on request, to un-delete any file that was removed/deleted by mistake. After that period any removal will become permanent, irrespective of the existence of backup copies.
ECFS usage monitoring
The ecfs_status command will give you the most recent status on ECFS usage for your default project account. For more information please call ecfs_status -h.
To get an overview on your ECFS usage, you can also refer to your audit files ec:ecfs_audit
and/or ectmp:ecfs_audit.tmp
...
Each ECFS user has an ecfs_audit file, placed in each of their ECFS domains. These files contain a list of all files you own in the relevant ECFS domai, excluding any backup copies. To list the audit file in your ec: domain use the following command:
...
Small audit files can be inspected quickly using the ecat command, e.g.
...
To examine the audit file in more detail you might want to copy it to your disk space in $HOME, $PERM or $SCRATCH, e.g. :
...
ecp ec:ecfs_audit $SCRATCH
...
The ecfs_audit file lists your files (no directories) in the format
...
-- uid gid size(bytes) creation last_access path today=2018-09-13
...
*+ uid gid 114176 20120307 20120702 /uid/directory1/file1
* uid gid 114176 20120307 20120702 /uid/directory2/file1
b+ uid gid 19363 20141208 20141208 /uid/directory2/file2
...
Total files =924 gigabytes = 282.40779780224
total directories = 52 total files not accessed since 20170312 = 865
where the columns have the following meaning:
...
Attribute:
b
- file is backed-up+
- file has not been accessed for over 18 months
* - file is not backed-up
...
size(bytes)
...
creation
...
last_access
...
path
...
The audit file's creation date in the format "today= YYYY-MM-DD" is stated in its first line. At the bottom the total of your ECFS content is reported in terms of number and (binary) volume. The very last line gives the number of directories and the number of files not accessed for 18 months.
In addition, you might want to use the new ecfs_filter tool to help analyse and/or delete your ECFS files or use the web based ECFS Data Management tool (web login with your computer user-ID required)The ecfs_usage command gives the most recent status on ECFS usage at user level. For more information please call ecfs_usage -h.
Using ECFS in scripts
All ECFS commands specifying a single operation return the value 0 if successful, and an error code > 0 otherwise. However, as with Unix, ECFS commands may specify a number of operations, either due to multiple arguments or to wildcard expressions. In such cases, ECFS will always attempt to carry out all operations, even if some intervening operations are not successful. If all such operations for a command are successful, the return code will be 0; if some of the operations are not successful, the return code will be 1; if fatal errors are incurred, the entire command is discontinued, and the error number > 1 is returned with an explanatory message.
...