Home
Runtimes
Descriptions of Link runtime services.
SDK
The LNK programming interface includes language-specific methods and objects that provide common functionality across multiple environments.
C API
The C API enables applications to invoke maps and to develop adapters to use with HCL Link.
Loading, running, and controlling maps
There are various methods you can use to load, run, and control maps when you use APIs with HCL Link.
Loading and running maps
Use the following methods to load specific maps, refresh maps when the maps have changed, and run maps.
mpiMapRun
The C API uses different methods to load, run, and control maps, including mpiMapRun.

Runtimes
Descriptions of Link runtime services.
- REST API
  The REST Runtme provides a REST API used to run maps and flows that have been deployed.
- Flow Command Server
  Deploy a flow from the HCL Link to the local filesystem using Execution flow server definition.
- Map Command Server
  To use the Map Command Server to execute a map, you will prepare the maps for execution.
- SDK
  The LNK programming interface includes language-specific methods and objects that provide common functionality across multiple environments.
  - Link programming interface overview
    The Link programming interface is an object-oriented approach that enables applications to invoke HCL Link maps, thus removing reliance on command lines.
  - C API
    The C API enables applications to invoke maps and to develop adapters to use with HCL Link.
    - C API interface methods overview
      The map, card, and adapter object properties define the properties that can be set for each object. Use the C API interface methods to GET or SET the adapter object properties.
    - Object methods
    - Loading, running, and controlling maps
      There are various methods you can use to load, run, and control maps when you use APIs with HCL Link.
      - Loading and running maps
        Use the following methods to load specific maps, refresh maps when the maps have changed, and run maps.
        mpiMapLoadFile
        The C API uses different methods to load, run, and control maps, including mpiMapLoadFile.
        mpiMapLoadMemory
        The C API uses different methods to load, run, and control maps, including mpiMapLoadMemory.
        mpiMapRefresh
        The C API uses different methods to load, run, and control maps, including mpiMapLoadRefresh.
        mpiMapReloadFile
        The C API uses different methods to load, run, and control maps, including mpiMapReloadFile.
        mpiMapReloadMemory
        The C API uses different methods to load, run, and control maps, including mpiMapReloadMemory.
        mpiMapRun
        The C API uses different methods to load, run, and control maps, including mpiMapRun.
        mpiMapUnload
        The C API uses different methods to load, run, and control maps, including mpiMapUnload.
      - Controlling and monitoring maps
        These methods allow map execution to be controlled from another thread and to report map progress.
      - Initialization and termination methods
        The following methods initialize the environment required for running maps and clean up the environment after the map run is complete.
      - Callbacks
        An API application uses callback to receive logging messages on a per-map basis or for global logging based on HCL Link initialization.
      - C API examples
        The examples included with the C API are located in the following directory: install_dir\examples\dk\dtxpi\c
    - Custom adapters
      The custom adapters interface makes it possible for users to develop adapters with as much functionality as those provided with the product.
  - Python API
    Use the Python API to create, edit, and run maps and schemas from a Python program. For details, see the documentation installed in install_dir/python/api/hip/docs/html/index.html. Examples of the Python API are installed in install_dir/python/api/examples. Documentation for the Python API examples is available in install_dir/python/api/docs/html/examples.html.
  - Java API
    The Java API interfaces enable you to create, edit, and run maps and schemas from a Java™ program.
  - Java Tools
    The Java™ Tools provide objects and JNI utilities that you can use to get information about your map instances.

mpiMapRun

The C API uses different methods to load, run, and control maps, including mpiMapRun.

MPIRC mpiMapRun (HMPIMAP  hMap)

Inputs

hMap: Map object

Outputs

None

Returns

Success status