C native environment

For general information see C Programming Reference, in particular the page Compilation Information, however that page is now a little out of date, and this topic provides an update.

For the native C code base, support is provided for five platforms:
  • PocketPC2000
  • PocketPC2002
  • PocketPC2003
  • WinCE .NET 4.2
  • Windows® 32bit.

Support for the WebSphere® MQ Everyplace® C DLLs on WinCE .NET 4.2 is provided using the Platform Invocation Services provided by the .NET environment.

For PocketPC, binaries are provided for both the device, and the emulator that is available in the Integrated Development Environment Microsoft® Embedded Visual C++. The binaries provided for the devices are compiled for ARM processors.

Binary files

The root of the binary files, as well as the documentation and examples, is the C directory below the directory where you choose to install MQe.

Then in the C directory, the files are located as follows:

PocketPC2000
ARM
DLLs
C\PocketPc2000\arm\bin
LIBs
C\PocketPc2000\arm\lib
Emulator
DLLs
C\PocketPc2000\x86emulator\bin
LIBs
C\PocketPc2000\x86emulator\lib
PocketPC2002
ARM
DLLs
C\PocketPc2002\arm\bin
LIBs
C\PocketPc2002\arm\lib
Emulator
DLLs
C\PocketPc2002\x86emulator\bin
LIBs
C\PocketPc2002\x86emulator\lib
PocketPC2003 and WinCE .NET 4.2
ARM
DLLs
C\PocketPc2003\arm\bin
LIBs
C\PocketPc2003\arm\lib
Emulator
DLLs
C\PocketPc2003\x86emulator\bin
LIBs
C\PocketPc2003\x86emulator\lib
Windows 32bit
DLLs
C\Win32\Native\bin
LIBs
C\Win32\Native\lib
Header files

The header files are common to all the Native platforms, and may be found in the include directory below the installation directory.

MQe_API.h

This is the "root" header file. If this is included all relevant header files will be included for you.

In order to ensure the correct files and definitions are included you must indicate you are running the Native code base as follows:
#define   NATIVE                   // or specify this as an option to the compiler
#include  <published/MQe_API.h>
Linking

You should link against the following two libraries:

HMQ_nativeAPI.lib
// the API library
HMQ_nativeCnst.lib
// the static constant MQeString library

Generally you should include both these files. Then an optimizing linker should remove links to any functions and constants you have not used.

The other MQe libraries are statically and dynamically linked with the main API library and will be included as required.


Terms of use | WebSphere software

(c) Copyright IBM Corporation 2004, 2005. All rights reserved.