    Solace Corporation Messaging API for C Introductory Sample Programs

INTRODUCTION

   These samples provide a basic introduction to using the Messaging API for
   C in messaging applications. Common uses, such as sending a direct message,  
   receiving a direct message, sending a guaranteed message, and receiving a
   guaranteed message, are described in detail in these samples.

   To clearly illustrate the message API concepts, error checking and handling 
   is not included.  To see advanced samples with robust error handling and 
   checking, see the 'ex/' sample directory.

   Before working with these samples, ensure that you have read and understood
   the  basic  concepts  found in the Solace Corporation Messaging API for Java, 
   C, and .NET User Guide.

SAMPLE DOCUMENTATION

   For a description of each sample and an annotated listing of the source code 
   please see the "C CSMP API Documentation" included in solclient-doc.tar.gz.


HOW TO BUILD THE SAMPLES

   REQUIRED SOFTWARE

   To compile and run the sample applications on Windows systems, ensure that 
   Microsoft Visual Studio 2015 Standard Edition or above is installed and configured 
   on your computer. Be sure you have installed the correct Solace Corporation package 
   based on your installed Visual Studio.

   For  Visual Studio 2015 install solclient_Win_vs2015_<version>.tar.gz

WINDOWS BUILD INSTRUCTIONS

Visual Studio 2015:
   1. Navigate to the 'vs2015' directory.
   2. Open 'c_api_Introduction.sln' in Microsoft Visual Studio.
   3. Change to the relevant build configuration and platform.  Build configurations 
      available  are:
	    a. 'Release' for optimized build
	    b. 'StaticRelease ' for optimized build with a static library (.lib instead of .dll)
	    c. 'Debug' for debug build.
	    d.  'StaticDebug' for debug build with a static library.

      Platform options are:
	    a. Win64 for 64 bit builds.
	    b. Win32 for 32 bit builds.

   4. Build the solution 'c_api_Introduction'.

Visual Studio 2017:
   1. Navigate to the 'vs2015' directory.
   2. Open 'c_api_Introduction.sln' in Microsoft Visual Studio. Note to build vs2015 
      projects with vs2017 the optional component 
      'VC++ 2015.3 v14.00 (v140) toolset for destop' must be installed for vs2017.
   3. Change to the relevant build configuration and platform.  Build configurations
      available  are:
        a. 'Release' for optimized build
        b. 'StaticRelease ' for optimized build with a static library (.lib instead of .dll)
        c. 'Debug' for debug build.
        d.  'StaticDebug' for debug build with a static library.

      Platform options are:
        a. Win64 for 64 bit builds.
        b. Win32 for 32 bit builds.

   4. Build the solution 'c_api_Introduction'.

RUNNING THE EXAMPLES

   All of the supplied examples have command line help. Run the corresponding
   executable with no arguments to display its usage


Copyright 2009-2025 Solace Corporation. All rights reserved.

This software is proprietary software of Solace Corporation and intended only
for use in conjunction with one or more Solace Message Routers.  By using this
software, you are agreeing to the license terms and conditions located at
https://solace.com/license-software.

