Using linkage options for WebSphere MQ run-time library selection

Use an EGL linkage options part to indicate which runtime library you want to use.

The WebSphere® MQ reusable parts shipped with EGL include sample linkage options parts for all supported environments. The following table shows which linkage options part to use in each environment. You can use the linkage options parts directly, or copy the entries in the parts to your own linkage options, if you need to specify entries for other program calls.

Table 1. Linkage options for WebSphere MQ programs
Environment WebSphere MQ library description WebSphere MQ library Wrapper DLL name Linkage options
Windows® WebSphere MQ manager mqm.lib csomqm32 mqm32.lkg
Windows WebSphere MQ client mqic32.lib csomqc32 mqic32.lkg
AIX® WebSphere MQ manager libmqm.a csomqm libmqm.lkg
AIX WebSphere MQ client libmqic.a csomqic libmqic.lkg
AIX WebSphere MQ manager, threaded environment libmqm_r.a csomqmr libmqm_r.lkg
AIX WebSphere MQ client, threaded environment libmqic_r.a csomqicr libmqic_r.lkg
HP-UX WebSphere MQ manager libmqm.sl csomqm libmqm.lkg
HP-UX WebSphere MQ client libmqic.sl csomqic libmqic.lkg
HP-UX WebSphere MQ manager, threaded environment libmqm_r.sl csomqicr libmqm_r.lkg
HP-UX WebSphere MQ client, threaded environment libmqic_r.sl csomqmr libmqic_r.lkg
Solaris WebSphere MQ manager libmqm.so csomqm libmqm.lkg
Solaris WebSphere MQ client libmqic.so csomqic libmqic.lkg

If you are testing or running with an WebSphere MQ manager, non-threaded library, specify the linkage options part as a test or generation option. If you are testing or running with an WebSphere MQ client or threaded library, you must also move the part to a file and set the CSOLINKTBL environment variable to the file name.

Generated Java™ programs require a special format for the linkage options entry. The entry should look like the following example:
:calllink applname=elaq* library=mqWrapperDllNname linktype=csocall
              parmform=commptr remotecomtype=direct remoteapptype=nonvg 
              contable=javaConversionTableName
mqWrapperDllNname
The wrapper dll name for your run-time environment from the table.
javaConversionTableName
The java conversion table for your language and the system on which the program is running.

Refer to the EGL Generation Guide for help in determining which conversion table to choose.


Feedback