Running the CATDMUCacheManager
Batch Process

The CATDMUCacheManager Utility is intended to list the content of one cache directory in order to perform several tasks in batch mode, e.g. purge, update and  purge least-recently-accessed files.

Shells to perform the necessary operations will have to be written by customers based on the output of this utility.

The CATDMUCacheManager utility:

  • Searches all cache data located in a given directory
  • Retrieve their timestamp
  • Seeks the related original
  • Purges oldest files

 
On Windows, it is always necessary to specify the -env and -direnv options. Note also that these options should always be specified at the end of the command line. For more information, see the Infrastructure User's Guide, Starting a Session on Windows.

  1. To retrieve the help information, run the command:

CATDMUCacheManager -h

  1. To retrieve the content of a cache directory, run the command:

CATDMUCacheManager -content file [-g cachedir]
[-s char] [-t type]

  1. To purge a cache directory, run the command:

CATDMUCacheManager -purge value

 
Windows Examples

CATDMUCacheManager -h
CATDMUCacheManager -content c:\u\output.txt
CATDMUCacheManager -content c:\u\output.txt -t 3dmap
CATDMUCacheManager -purge 10

Unix Examples

CATDMUCacheManager -h
CATDMUCacheManager -content /u/output
CATDMUCacheManager -content /u/output -t 3dmap
CATDMUCacheManager -purge 10

 
Arguments

-h : Help.

-content file : Output file that will contain the list of cache files. Each line will contain the identifier of the cache file, a separator, the identifier of the original file, a separator and the time-stamp using YYYY-mm-dd-HH.MM.SS format.

-g cachedir : The cache directory to scan. If the -g option is specified but no directory parameter is specified, the local cache is used by default.

-s char : The character used to separate fields on a line of the input or output file. By default, the blank character is used.

-t type : To define the type of cache (cgr, 3dmap, etc.). By default, cgr is used.

-purge value : To purge the cache directory to a specified size (value). The size is given in Megabytes (Mo).
Diagnostics

Possible exit status values are:

  • 0: Successful completion.
  • 1: Failure due to any of the following:
    • license not available
    • cache management deactivated
    • missing arguments
    • invalid parameter
    • missing parameter after an option
    • unable to find output file
    • unable to open output file
  • 2: Processing error. 
Solutions per exit status value 
  • Exit status = 1: Modify the command line using information contained in the standard error file.
  • Exit status = 2: Contact you local support.