Routines (alphabetical) > Routines: D > DLM_LOAD

# DLM_LOAD

Normally, IDL system routines that reside in dynamically loadable modules (DLMs) are automatically loaded on demand when a routine from a DLM is called. The DLM_LOAD procedure can be used to explicitly cause the code within the `.dll` or `.so` file to be loaded.

## Examples

Force the JPEG DLM to be loaded:

DLM_LOAD, 'jpeg'

IDL prints:

% Loaded DLM: JPEG.

Manually load a DLM file that is not on !DLM_PATH:

DLM_LOAD, '/users/myname/mycode.dlm'

IDL prints:

% Loaded DLM: MYCODE.

## Syntax

DLM_LOAD, Name1 [, Name2,..., Namen]

## Arguments

### Namen

A string giving the DLM module name or the full filepath to a `.dlm` file.

Note: In order to use the DLM module name, the DLM must exist within one of the directories on !DLM_PATH (or you can use DLM_REGISTER to manually register a DLM).

## Keywords

None

## Version History

5.1 | Introduced
8.3 | Allow a full filepath to the DLM file

## See Also

DLM_REGISTER, !DLM_PATH environment variable, IDL_DLM_PATH preference, Dynamically Loadable Modules