...

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.

...