Pathname Optimization:ACCUREV_IGNORE_ELEMS and .acignore : Eligible “Whole-Workspace” Commands

Eligible “Whole-Workspace” Commands
The following accurev commands use the value of ACCUREV_IGNORE_ELEMS to filter names:
 
List files that have been modified, but are not active from AccuRev’s viewpoint (that is, are not in the workspace’s default group)
Update the workspace by incorporating versions from the backing stream (only if USE_IGNORE_ELEMS_OPTIMIZATION is set to TRUE)
These commands apply to the entire workspace if you don’t specify any filenames/pathnames or wildcard patterns on the command line:
accurev stat -n (“whole-workspace” command)
accurev stat -n *.doc (pattern specified; not a “whole-workspace” command)
When applying these commands to an entire workspace, the accurev tool, running on the client machine, uses ACCUREV_IGNORE_ELEMS to filter the list of filenames before sending the list to the AccuRev Server process. This can significantly reduce the amount of network traffic, and also reduce the amount of file-status computation the Server process must perform.
Note: by default, the stat command also uses a timestamp-based optimization to reduce the number of files it must process. For details, see Optimized Search for Modified Files: the Scan Threshold on page 248 in the AccuRev CLI User’s Guide.
GUI Counterparts to the “Whole-Workspace” Commands
The AccuRev GUI also uses the ACCUREV_IGNORE_ELEMS environment variable. Working in the searches pane of the File Browser corresponds to using the various “whole-workspace” forms of the accurev stat command. Thus, ACCUREV_IGNORE_ELEMS is used by these search criteria:
External (stat –x)
Modified (stat –m)
Non-member (stat –n)
Pending (stat –p)

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com