MCR Component Cache and CTF Archive Embedding

On this page…
Overriding Default Behavior For More Information

CTF data is automatically embedded directly in .NET and COM components and extracted to a temporary folder.

Automatic embedding enables usage of MCR Component Cache features through environment variables.

These variables allow you to specify the following:

• Define the default location where you want the CTF archive to be automatically extracted

• Add diagnostic error printing options that can be used when automatically extracting the CTF, for troubleshooting purposes

• Tuning the MCR component cache size for performance reasons.

Use the following environment variables to change these settings.

Environment Variable	Purpose	Notes
MCR_CACHE_ROOT	When set to the location of where you want the CTF archive to be extracted, this variable overrides the default per-user component cache location.	Does not apply
MCR_CACHE_VERBOSE	When set to any value, this variable prints logging details about the component cache for diagnostic reasons. This can be very helpful if problems are encountered during CTF archive extraction.	Logging details are turned off by default (for example, when this variable has no value).
MCR_CACHE_SIZE	When set, this variable overrides the default component cache size.	The initial limit for this variable is 32M (megabytes). This may, however, be changed after you have set the variable the first time. Edit the file .max_size, which resides in the file designated by running the mcrcachedir command, with the desired cache size limit.

You can override this automatic embedding and extraction behavior by compiling with the Overriding Default Behavior option.

Caution   If you run mcc specifying conflicting wrapper and target types, the CTF will not be embedded into the generated component. For example, if you run: mcc -W lib:myLib -T link:exe test.m test.c the generated test.exe will not have the CTF embedded in it, as if you had specified a -C option to the command line.

Overriding Default Behavior

To extract the CTF archive in a manner prior to R2008b, alongside the compiled .NET or COM component, compile using the option mcc -C.

You can also implement this override by checking the appropriate Option in the Deployment Tool.

You might want to use this option to troubleshoot problems with the CTF archive, for example, as the log and diagnostic messages are much more visible.

Back to Top

For More Information

For more information about the CTF archive, see Component Technology File (CTF Archive).

Back to Top

MCR Run-Time Options

The MCR User Data Interface

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS