nc list Command

By default, list results are obtained from the server in real-time. In large-scale workload environments, repeated queries can impact server performance. To reduce this impact, a list result cache can be enabled:

# Example content of vnclist.config.tcl
# enable 'nc list' local caching
set NCLIST(cache,enable) 1

If the list cache is enabled, list results will be written to a client-side file, and subsequent list requests will be obtained from this file, up to the cache expiration. The default expiration is 30s from creation. After this time, the cache file will be regenerated upon the next list request. To set the cache expiration to a different value:

set NCLIST(cache,timeout,default) 60

# Other variables used in global array NCLIST (not settable)
#set NCLIST(cache,timeout,default)
#set NCLIST(cache,cacheFile)
#set NCLIST(cache,cacheFp)

Another list operation that can affect server performance in a large-scale workload environment is listing by job name. This is due to the need to compare string values across many jobs. Listing by job name can be disabled entirely by setting:

set NCLIST(listbyjobname,enable) 0           

Environment variables that influence nc list caching:

# NC_LIST_FORMAT
# NC_LIST_CACHE_DIR  ; # default ~/.vov/vnclist.caches/<project>...
# NC_LIST_CACHE_TIMEOUT