The LNK programming interface includes language-specific methods and objects that provide common functionality across multiple environments.
The Link programming interface is an object-oriented approach that enables applications to invoke HCL Link maps, thus removing reliance on command lines.
The Link programming interface is based on map, card, adapter, connection, and stream objects.
An adapter object is created for each card when a map instance object is created.
Properties are defined for all adapter objects, though each adapter can also GET and SET its own adapter-specific properties (for example, QueueManagerName for MQSeries®).
These properties provide high-level information about the adapter object.
The Link programming interface map, card, and adapter object properties define the properties that can be set for each object. Use these methods to GET or SET the object properties.
The Link programming interface objects have a relationship to each other defined by a specific hierarchy.
The Link programming interface methods provide a means to query or modify properties of objects.
The Link programming interface creates a map object instance from the byte array representing a compiled map file. The hierarchies of map, card and adapter objects are created by this method.
The card object is an abstraction of a card in a map.
The alias of the adapter.
The command line that determines the connection parameters and the behavior of the adapter associated with the adapter object.
The context in which the adapter is being called.
The message collection object that is used to pass event messages (MMessage objects) from a Listen call to the application, and from the application to a GET call.
This property MUST be set by an adapter before returning from a GET call. This informs the Resource Manager how many messages have been received and are being returned in the GET. This is used in association with the Quantity and Fetch Unit properties to determine whether the GET should be called again or not.
The return code from the resource to which the adapter communicates upon execution of the input or output adapter.
This is the return error message from the resource to which the adapter communicates upon execution of the input or output adapter.
The type of the adapter object.
This property is used to associate binary data with an adapter object and can be used for various purposes, such as to pass configuration data, specific environment settings, or possibly real time data.
This property is set by an adapter in the Listen method to inform the Resource Manager that the same connection thread should be used in the subsequent corresponding GET call.
The value of a wildcard returned from an event.
The error code from the last operation on the map object.
The error message from the last operation on the map object.
Use the adapter retry properties for adapter objects to define the settings for the retry settings for map execution.
Use the MPIP_ADAPTER_ON_FAILURE property for adapter objects to define the settings for the OnFailure transactional settings for map execution.
Use the MPIP_ADAPTER_ON_SUCCESS property for adapter objects to define the settings for the OnSuccess transactional settings for map execution.
Use the MPIP_ADAPTER_SCOPE property for adapter objects to define the settings for the scope of the transaction for map execution.
Use the MPIP_ADAPTER_WARNINGS property for adapter objects to define the settings for action on adapter warnings for map execution.
Use the aggregation properties for adapter objects to define the settings that determine the number of messages that are returned from an input adapter for map execution.
The adapter object methods are defined by the adapter object.
Use the Link programming interface to load, run and control maps.
The C API enables applications to invoke maps and to develop adapters to use with HCL Link.
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.
The Java API interfaces enable you to create, edit, and run maps and schemas from a Java™ program.
The Java™ Tools provide objects and JNI utilities that you can use to get information about your map instances.