Page History

<logical folder>

This parameter is required and comes after all options are specified.  Replace it with the Data Catalog folder path where you want to begin your search.  
The more specific you are, the faster your search will be.

--recurse

If you specify this option, the find command will traverse the folder tree under <logical folder> in it's quest to provide you with the data you desire.

--search-folders

Tells find to look inside the folder (or folders if --recurse specified) and consider datasets that live there.  In general, datasets live in groups, and this option is not used.

--search-groups

Tells find to look inside all dataset groups in the specified folder (or folder tree if using --recurse) for your files.  May be combined with --search-folders and --recurse.  
Has no meaning if --group is also specified.

--group <group name>

Tells find to look inside groups only if they have the name specified by <group name>.  May be used with --recurse to search in groups of the given name in a folder tree.

--site <site name>

Specifies the specific site you want to get datasets from.  May be used one or more times

multiple times to specify a list of sites to search where order indicates preference.

--filter <filter expression>

Also known as "search criteria" is an expression using logical operators, meta-data fields and constant values on which to filter the output results.

--sort <meta name>

Specifies the name of the specific meta-data field on which to sort the output results.  May be used multiple times to specify a list of fields to sort on where order indicates preference.
Sorting may add a significant overhead to the time it takes to start getting results, as the entire output set must be calculated, then sorted, before being displayed.
Currently only 'ascending' sort is supported.