Configure PLCD on a client

You can modify PLCD settings on client machines.

Guidelines and behaviors

  • To reset the cache, it is safe to delete the whole PLCD directory. Shut down the Dimensions CM clients before resetting the cache.

  • Files that are downloaded into a work area using the fetch (FI), download (DOWNLOAD), and update (UPDATE) commands are copied into the cache.

  • Files that are uploaded to Dimensions CM using the revise item (UI), checkin (RI), edit item (EI), deliver (DELIVER), and upload (UPLOAD) commands are copied to the cache.

  • Changes that you make to the PLCD settings are saved in the plcd.properties file in the following location:

    <home>/.dmwebtools

Back to top

Enable and disable PLCD

By default, PLCD is enabled on a Dimensions CM server and all clients that connect to it, including:

  • Clients that run the dmcli command line, desktop client, and Eclipse and Visual Studio integrations.

  • Agents including any used for library caches.

To disable PLCD:

  1. In your client or integration, disable the personal library cache option:

    Desktop client
    1. Select Tools > Preferences > Personal Library Cache.
    2. Clear the Enable Personal Library Cache option.
    Eclipse and Visual Studio
    1. In Dimensions Explorer, right-click the Dimensions CM server connection, and select Properties > Personal Library Cache.

    2. Clear the Enable Personal Library Cache option.

  2. In the Dimensions CM dm.cfg configuration file on a client, set the variable DM_PLCD_ENABLED to 0.

  3. In a client such as dmcli, enter SET PLCD OFF. This disables PLCD for the duration of your session (or until you re-enable PLCD using SET PLCD ON).

Back to top

Specify a cache directory

To specify where the cache is stored on a local machine:

  1. In your client or integration, enter the cache directory path:

    Desktop client
    1. Select Tools > Preferences > Personal Library Cache.
    2. In the Cache Directory Path field, enter the location of the cache directory on your local machine.
    Eclipse and Visual Studio
    1. In Dimensions Explorer, right-click the Dimensions CM server connection, and select Properties > Personal Library Cache.

    2. In the Cache Directory Path field, enter the location of the cache directory on your local machine.

  2. In the Dimensions CM dm.cfg configuration file, add this variable:

    DM_PLCD_DIR C:\dimensions\plcd\

Back to top

Specify a maximum cache size

You can specify a maximum cache size in MB for the PLCD directory. When the directory reaches this size, earlier revisions of items are deleted to make more space.

To set a maximum cache size:

  1. In your client or integration, specify the cache size:

    Desktop client
    1. Select Tools > Preferences > Personal Library Cache.

    2. In the Maximum Cache Size field, enter a cache size.

    Eclipse and Visual Studio
    1. In Dimensions Explorer, right-click the Dimensions CM server connection, and select Properties > Personal Library Cache.

    2. In the Maximum Cache Size field, enter a cache size.

  2. In the Dimensions CM dm.cfg configuration file, add this variable:

    DM_PLCD_MAX_SIZE_MB <cache size in MB>

Back to top

Create additional messages

To create additional messages that confirm the use of the cache, add the following variable to the client configuration file:

DM_PLCD_BOAST 1

Back to top

Specify file sizes

To specify the maximum and minimum size of files that can be copied to PLCD, add these variables to the client configuration file:

  • DM_PLCD_FILE_MAX_KB <size in MB>

    Default: 500 MB

  • DM_PLCD_FILE_MIN_KB <size in MB>

Back to top

See also: