A send can fail with an EWOULDBLOCK error, which can have different root causes. One cause for a persisted source is exceeding flight size. This example shows how to determine if flight size is the cause of an EWOULDBLOCK error.
Example UMP source application that demonstrates how a persisted source can failover to a backup store
+
+
+
+
Notices
+
This software and documentation are provided only under a separate license
+agreement containing restrictions on use and disclosure.
+No part of this document may be reproduced or transmitted in any form,
+by any means (electronic, photocopying, recording or otherwise)
+without prior consent of Informatica LLC.
+
+
Portions of this software and/or documentation are subject to copyright
+held by third parties.
+Required third party notices are included with the product.
+
+
The information in this documentation is subject to change without notice.
+If you find any problems in this documentation, please report them to us in
+writing at Informatica LLC 2100 Seaport Blvd. Redwood City, CA 94063.
+
+
Informatica products are warranted according to the terms and conditions
+of the agreements under which they are provided.
+ INFORMATICA LLC PROVIDES THE INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR
+CONDITION OF NON-INFRINGEMENT.
+
diff --git a/cancelling_timers/c/cancelling_timers.c b/cancelling_timers/c/cancelling_timers.c
index cbc5bc5..494aaba 100644
--- a/cancelling_timers/c/cancelling_timers.c
+++ b/cancelling_timers/c/cancelling_timers.c
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* cancelling_timers.c - see http://ultramessaging.github.io/UMExamples/cancelling_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -26,18 +45,17 @@
typedef enum {PENDING, FIRED, CANCELED} state_type_e;
typedef struct app_timer_s {
- int id;
- state_type_e state;
- int sync;
+ int id;
+ state_type_e state;
+ int sync;
} app_timer_s;
-int wait = 1;
/* Timer callback function */
int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
struct app_timer_s *my_timer = (struct app_timer_s *)clientd;
- if (my_timer->state != PENDING) {
+ if (my_timer->state != PENDING) {
fprintf(stderr, "ERROR: Timer executed and should have been cancelled\n");
exit(1);
}
@@ -45,7 +63,8 @@ int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
fprintf(stderr, "ERROR: This timer should have been cancelled by now\n");
return 0;
-}
+} /* sample_timer_handler */
+
int cancel_timer_cb(lbm_context_t *ctx, const void *clientd)
{
@@ -57,22 +76,19 @@ int cancel_timer_cb(lbm_context_t *ctx, const void *clientd)
my_timer->sync = 0;
return 0;
-}
+} /* cancel_timer_cb */
+
-main()
+int main(int argc, char **argv)
{
lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
app_timer_s my_timer;
+ int err;
my_timer.sync = 0;
/* Initialize context atrributes and create context */
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
my_timer.state = PENDING;
@@ -96,10 +112,11 @@ main()
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/cancelling_timers/c/cancelling_timers.sldoc.html b/cancelling_timers/c/cancelling_timers.sldoc.html
index 8caae35..7013d4f 100644
--- a/cancelling_timers/c/cancelling_timers.sldoc.html
+++ b/cancelling_timers/c/cancelling_timers.sldoc.html
@@ -32,12 +32,12 @@
diff --git a/cancelling_timers/c/cancelling_timers_c.slsrc b/cancelling_timers/c/cancelling_timers_c.slsrc
index 72a30dd..e2919c2 100644
--- a/cancelling_timers/c/cancelling_timers_c.slsrc
+++ b/cancelling_timers/c/cancelling_timers_c.slsrc
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* cancelling_timers.c - see http://ultramessaging.github.io/UMExamples/cancelling_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
/* =semlit,block,includes=*/
#include
@@ -31,22 +50,19 @@
/* =semlit,block,struct_app_timer=*/
typedef enum {PENDING, FIRED, CANCELED} state_type_e;
typedef struct app_timer_s {
- int id;
- state_type_e state;
- int sync;
+ int id;
+ state_type_e state;
+ int sync;
} app_timer_s;
/* =semlit,endblock,struct_app_timer=*/
-/* =semlit,block,int_wait=*/
-int wait = 1;
-/* =semlit,endblock,int_wait=*/
-/* Timer callback function */
/* =semlit,block,timer_cb=*/
+/* Timer callback function */
int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
struct app_timer_s *my_timer = (struct app_timer_s *)clientd;
- if (my_timer->state != PENDING) {
+ if (my_timer->state != PENDING) {
fprintf(stderr, "ERROR: Timer executed and should have been cancelled\n");
exit(1);
}
@@ -54,9 +70,10 @@ int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
fprintf(stderr, "ERROR: This timer should have been cancelled by now\n");
return 0;
-}
+} /* sample_timer_handler */
/* =semlit,endblock,timer_cb=*/
+
/* =semlit,block,cancel_cb=*/
int cancel_timer_cb(lbm_context_t *ctx, const void *clientd)
{
@@ -68,24 +85,21 @@ int cancel_timer_cb(lbm_context_t *ctx, const void *clientd)
my_timer->sync = 0;
return 0;
-}
+} /* cancel_timer_cb */
/* =semlit,endblock,cancel_cb=*/
-main()
+
+int main(int argc, char **argv)
{
lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
app_timer_s my_timer;
+ int err;
my_timer.sync = 0;
/* Initialize context atrributes and create context */
/* =semlit,block,ctx_create=*/
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
/* =semlit,endblock,ctx_create=*/
@@ -116,10 +130,11 @@ main()
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/cancelling_timers/c/cancelling_timers_c.slsrc.html b/cancelling_timers/c/cancelling_timers_c.slsrc.html
index de0394a..f54cf49 100644
--- a/cancelling_timers/c/cancelling_timers_c.slsrc.html
+++ b/cancelling_timers/c/cancelling_timers_c.slsrc.html
@@ -18,110 +18,146 @@
/* cancelling_timers.c - see http://ultramessaging.github.io/UMExamples/cancelling_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -149,15 +185,14 @@
typedef enum {PENDING, FIRED, CANCELED} state_type_e;
typedef struct app_timer_s {
- int id;
- state_type_e state;
- int sync;
+ int id;
+ state_type_e state;
+ int sync;
} app_timer_s;
- int wait = 1;
- /* Timer callback function */
- int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
+ /* Timer callback function */
+ int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
struct app_timer_s *my_timer = (struct app_timer_s *)clientd;
if (my_timer->state != PENDING) {
@@ -168,7 +203,8 @@
fprintf(stderr, "ERROR: This timer should have been cancelled by now\n");
return 0;
- }
+ } /* sample_timer_handler */
+
int cancel_timer_cb(lbm_context_t *ctx, const void *clientd)
{
@@ -180,22 +216,19 @@
my_timer->sync = 0;
return 0;
- }
+ } /* cancel_timer_cb */
+
- main()
+ int main(int argc, char **argv)
{
lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
app_timer_s my_timer;
+ int err;
my_timer.sync = 0;
/* Initialize context atrributes and create context */
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
my_timer.state = PENDING;
@@ -219,13 +252,14 @@
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.c b/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.c
index 984f4bf..c051aaf 100644
--- a/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.c
+++ b/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.c
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* check_flight_size_ewouldblock.c - see http://ultramessaging.github.io/UMExamples/check_flight_size_ewouldblock/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,18 +34,27 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
#define DEFAULT_APP_FLIGHT_SIZE 500 /* Used for checking flight size */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_topic_t *topic; /* Topic object */
- lbm_src_t *src; /* Source object */
- lbm_src_topic_attr_t * tattr; /* Source topic attribute object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int inflight; /* Object used for checking inflight counters */
+ lbm_context_t *ctx; /* Context object */
+ lbm_topic_t *topic; /* Topic object */
+ lbm_src_t *src; /* Source object */
+ lbm_src_topic_attr_t * tattr; /* Source topic attribute object */
+ int inflight; /* Object used for checking inflight counters */
char flight[4];
- int err; /* Used for checking API return codes */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -39,71 +67,44 @@ main()
}
#endif
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
sprintf(flight, "%d", DEFAULT_APP_FLIGHT_SIZE);
- if (lbm_src_topic_attr_str_setopt(tattr, "ume_flight_size", flight) != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "ume_flight_size", flight);
+ EX_LBM_CHK(err);
/* Assuming there is a store running on the localhost at port 29999 */
- if (lbm_src_topic_attr_str_setopt(tattr, "ume_store", "127.0.0.1:29999") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "ume_store", "127.0.0.1:29999");
+ EX_LBM_CHK(err);
err = lbm_src_topic_alloc(&topic, ctx, "test.topic", tattr);
- if (err)
- {
- printf("lbm_src_topic_alloc - line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
err = lbm_src_create(&src, ctx, topic, NULL, NULL, NULL);
- if (err)
- {
- printf("lbm_src_create - line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
while(1)
{
- if (lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK) == LBM_FAILURE)
+ err = lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK);
+ if (err == LBM_FAILURE)
{
if (lbm_errnum() == LBM_EWOULDBLOCK)
- {
- if (lbm_src_get_inflight(src, LBM_FLIGHT_SIZE_TYPE_UME, &inflight, NULL, NULL) == 0)
+ {
+ err = lbm_src_get_inflight(src, LBM_FLIGHT_SIZE_TYPE_UME, &inflight, NULL, NULL);
+ EX_LBM_CHK(err);
+
+ /* Is inflight counter is equal to the configured flight size? */
+ if (inflight == DEFAULT_APP_FLIGHT_SIZE)
{
- /* Check to see if the inflight counter is equal to the configured flight size */
- if (inflight == DEFAULT_APP_FLIGHT_SIZE)
- {
- /* Print alert */
- printf("ALERT: Source is blocked on flight size: %d\n", inflight);
- }
+ printf("ALERT: Source is blocked on flight size: %d\n", inflight);
}
}
}
}
-}
-
+ return 0;
+} /* main */
diff --git a/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.sldoc b/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.sldoc
index f2e06b6..e2b6785 100644
--- a/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.sldoc
+++ b/check_flight_size_ewouldblock/c/check_flight_size_ewouldblock.sldoc
@@ -7,8 +7,8 @@
=semlit,include,../intro.sldoc=
There is one program source file, and a store configuration XML:
A sample application that handles all UMP receiver callbacks and logs important data
+
+
+
+
Notices
+
This software and documentation are provided only under a separate license
+agreement containing restrictions on use and disclosure.
+No part of this document may be reproduced or transmitted in any form,
+by any means (electronic, photocopying, recording or otherwise)
+without prior consent of Informatica LLC.
+
+
Portions of this software and/or documentation are subject to copyright
+held by third parties.
+Required third party notices are included with the product.
+
+
The information in this documentation is subject to change without notice.
+If you find any problems in this documentation, please report them to us in
+writing at Informatica LLC 2100 Seaport Blvd. Redwood City, CA 94063.
+
+
Informatica products are warranted according to the terms and conditions
+of the agreements under which they are provided.
+ INFORMATICA LLC PROVIDES THE INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR
+CONDITION OF NON-INFRINGEMENT.
+
diff --git a/dump_attributes/c/dump_attributes.c b/dump_attributes/c/dump_attributes.c
index 1cc9546..9e20201 100644
--- a/dump_attributes/c/dump_attributes.c
+++ b/dump_attributes/c/dump_attributes.c
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* dump_attributes.c - see http://ultramessaging.github.io/UMExamples/dump_attributes/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,23 +34,32 @@
#include
-main()
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_topic_t *topic_2; /* pointer to topic object */
- lbm_src_t *src_1; /* pointer to source object */
- lbm_src_t *src_2; /* pointer to source object */
- lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
- lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_topic_t *topic_2; /* pointer to topic object */
+ lbm_src_t *src_1; /* pointer to source object */
+ lbm_src_t *src_2; /* pointer to source object */
+ lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
+ lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
+ lbm_context_attr_t * cattr; /* pointer to context attribute object */
lbm_config_option_t *configs_option_ptr; /* pointer to configuration options returned from lib*/
- lbm_uint16_t res_port; /* Int to set resolver port */
- lbm_uint16_t des_port; /* Int to set lbtrm destination port */
- int err; /* return status of lbm functions (true=error) */
- int entries; /* Int used to count number of config entries */
- int idx; /* Int used to iterate across config entries */
-
+ lbm_uint16_t res_port; /* Int to set resolver port */
+ lbm_uint16_t des_port; /* Int to set lbtrm destination port */
+ int entries; /* Int used to count number of config entries */
+ int idx; /* Int used to iterate across config entries */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -45,116 +73,70 @@ main()
#endif
/* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_create(&cattr);
+ EX_LBM_CHK(err);
/* Setting the resolver address using the string method */
- if (lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:resolver_multicast_address: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12");
+ EX_LBM_CHK(err);
/* Setting the resolver port using the data-type value method */
res_port = 12345;
- if (lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_context_attr_setopt:resolver_mutlicast_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Creating the context */
err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr_1);
+ EX_LBM_CHK(err);
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+ EX_LBM_CHK(err);
/* Setting the lbtrm destination port via the direct value set method */
des_port = 14001;
- if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Initialized the second source attributes as a copy of the first */
- if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+ EX_LBM_CHK(err);
/* Now modify the destination port for this second source to put the publisher on a different transport */
des_port = 14002;
- if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the second topic */
err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
- /* each lbm object (ctx, src, rcv) has a different number of configuration */
- /* attributes. To allocate the array, call the corresponding *_option_size */
- /* function and allocate enough memory to contain the return strings */
+ EX_LBM_CHK(err);
+ /* each lbm object (ctx, src, rcv) has a different number of configuration
+ * attributes. To allocate the array, call the corresponding *_option_size
+ * function and allocate enough memory to contain the return strings. */
entries = lbm_context_attr_option_size();
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the context */
- if (LBM_FAILURE == lbm_context_dump(ctx, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_context_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_context_dump(ctx, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -163,6 +145,7 @@ main()
/* done with context attributes so free the allocated memory */
free(configs_option_ptr);
+
/* each lbm object (ctx, src, rcv) has a different number of configuration */
/* options to allocate the array, call the corresponding *_option_size */
/* function and allocate enough memory to contain the return strings */
@@ -170,11 +153,8 @@ main()
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the first source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_1, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_1, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -184,11 +164,8 @@ main()
/* note that configs_option_ptr can be reused for multiple sources without being freed. */
/* Get the attributes for the second source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_2, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_2, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -197,17 +174,24 @@ main()
/* done with source attributes so free the allocated memory */
free(configs_option_ptr);
+
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr_1);
- lbm_src_topic_attr_delete(tattr_2);
+ err = lbm_src_topic_attr_delete(tattr_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_delete(tattr_2);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src_1);
- lbm_src_delete(src_2);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(src_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_delete(src_2);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/dump_attributes/c/dump_attributes.sldoc.html b/dump_attributes/c/dump_attributes.sldoc.html
index df37e8d..700f74f 100644
--- a/dump_attributes/c/dump_attributes.sldoc.html
+++ b/dump_attributes/c/dump_attributes.sldoc.html
@@ -34,43 +34,26 @@
Initialization
object is used to configure a sources attributes.
-00079 /* Initializing the source attribute object */
-00080 if (lbm_src_topic_attr_create(&tattr_1) != 0)
-00081 {
-00082 fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
-00083 exit(1);
-00084 }
-00085
-00086 /* Setting the transport via the source topic string method */
-00087 if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0)
-00088 {
-00089 fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
-00090 exit(1);
-00091 }
-00092
-00093 /* Setting the lbtrm destination port via the direct value set method */
-00094 des_port = 14001;
-00095 if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
-00096 {
-00097 fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
-00098 exit(1);
-00099 }
-00100
-00101 /* Allocating the topic */
-00102 err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
-00103 if (err)
-00104 {
-00105 printf("line %d: %s\n", __LINE__, lbm_errmsg());
-00106 exit(1);
-00107 }
-00108
-00109 /* Creating the source */
-00110 err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
-00111 if (err)
-00112 {
-00113 printf("line %d: %s\n", __LINE__, lbm_errmsg());
-00114 exit(1);
-00115 }
+00095 /* Initializing the source attribute object */
+00096 err = lbm_src_topic_attr_create(&tattr_1);
+00097 EX_LBM_CHK(err);
+00098
+00099 /* Setting the transport via the source topic string method */
+00100 err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+00101 EX_LBM_CHK(err);
+00102
+00103 /* Setting the lbtrm destination port via the direct value set method */
+00104 des_port = 14001;
+00105 err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+00106 EX_LBM_CHK(err);
+00107
+00108 /* Allocating the topic */
+00109 err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
+00110 EX_LBM_CHK(err);
+00111
+00112 /* Creating the source */
+00113 err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
+00114 EX_LBM_CHK(err);
@@ -81,36 +64,22 @@
Initialization
in the attributes that will be dumped later.
-00116 /* Initialized the second source attributes as a copy of the first */
-00117 if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0)
-00118 {
-00119 fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
-00120 exit(1);
-00121 }
-00122
-00123 /* Now modify the destination port for this second source to put the publisher on a different transport */
-00124 des_port = 14002;
-00125 if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
-00126 {
-00127 fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
-00128 exit(1);
-00129 }
-00130
-00131 /* Allocating the second topic */
-00132 err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
-00133 if (err)
-00134 {
-00135 printf("line %d: %s\n", __LINE__, lbm_errmsg());
-00136 exit(1);
-00137 }
-00138
-00139 /* Creating the source */
-00140 err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
-00141 if (err)
-00142 {
-00143 printf("line %d: %s\n", __LINE__, lbm_errmsg());
-00144 exit(1);
-00145 }
+00115 /* Initialized the second source attributes as a copy of the first */
+00116 err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+00117 EX_LBM_CHK(err);
+00118
+00119 /* Now modify the destination port for this second source to put the publisher on a different transport */
+00120 des_port = 14002;
+00121 err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+00122 EX_LBM_CHK(err);
+00123
+00124 /* Allocating the second topic */
+00125 err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
+00126 EX_LBM_CHK(err);
+00127
+00128 /* Creating the source */
+00129 err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
+00130 EX_LBM_CHK(err);
@@ -131,26 +100,23 @@
Dump Context Attributes
numbers of attributes.
-00146 /* each lbm object (ctx, src, rcv) has a different number of configuration */
-00147 /* attributes. To allocate the array, call the corresponding *_option_size */
-00148 /* function and allocate enough memory to contain the return strings */
-00149 entries = lbm_context_attr_option_size();
-00150 configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
-00151
-00152 /* Get the attributes for the context */
-00153 if (LBM_FAILURE == lbm_context_dump(ctx, &entries, configs_option_ptr))
-00154 {
-00155 fprintf(stderr, "lbm_context_dump error: %s\n", lbm_errmsg());
-00156 return;
-00157 }
-00158
-00159 /* iterate through the returned array and print each option */
-00160 for (idx = 0; idx < entries; ++idx) {
-00161 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
-00162 }
-00163
-00164 /* done with context attributes so free the allocated memory */
-00165 free(configs_option_ptr);
+00131 /* each lbm object (ctx, src, rcv) has a different number of configuration
+00132 * attributes. To allocate the array, call the corresponding *_option_size
+00133 * function and allocate enough memory to contain the return strings. */
+00134 entries = lbm_context_attr_option_size();
+00135 configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
+00136
+00137 /* Get the attributes for the context */
+00138 err = lbm_context_dump(ctx, &entries, configs_option_ptr);
+00139 EX_LBM_CHK(err);
+00140
+00141 /* iterate through the returned array and print each option */
+00142 for (idx = 0; idx < entries; ++idx) {
+00143 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
+00144 }
+00145
+00146 /* done with context attributes so free the allocated memory */
+00147 free(configs_option_ptr);
@@ -167,26 +133,23 @@
Dump Source Attributes
Finally, it can be filled by the lbm_*_dump function.
-00166 /* each lbm object (ctx, src, rcv) has a different number of configuration */
-00167 /* options to allocate the array, call the corresponding *_option_size */
-00168 /* function and allocate enough memory to contain the return strings */
-00169 entries = lbm_src_topic_attr_option_size();
-00170 configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
-00171
-00172 /* Get the attributes for the first source */
-00173 if (LBM_FAILURE == lbm_src_topic_dump(src_1, &entries, configs_option_ptr))
-00174 {
-00175 fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
-00176 return;
-00177 }
-00178
-00179 /* iterate through the returned array and print each option */
-00180 for (idx = 0; idx < entries; ++idx) {
-00181 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
-00182 }
-00183
-00184 /* note that configs_option_ptr can be reused for multiple sources without being freed. */
-00185
+00149 /* each lbm object (ctx, src, rcv) has a different number of configuration */
+00150 /* options to allocate the array, call the corresponding *_option_size */
+00151 /* function and allocate enough memory to contain the return strings */
+00152 entries = lbm_src_topic_attr_option_size();
+00153 configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
+00154
+00155 /* Get the attributes for the first source */
+00156 err = lbm_src_topic_dump(src_1, &entries, configs_option_ptr);
+00157 EX_LBM_CHK(err);
+00158
+00159 /* iterate through the returned array and print each option */
+00160 for (idx = 0; idx < entries; ++idx) {
+00161 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
+00162 }
+00163
+00164 /* note that configs_option_ptr can be reused for multiple sources without being freed. */
+00165
@@ -197,20 +160,17 @@
Dump Source Attributes
no longer be used. Therefore it can & should be freed.
-00186 /* Get the attributes for the second source */
-00187 if (LBM_FAILURE == lbm_src_topic_dump(src_2, &entries, configs_option_ptr))
-00188 {
-00189 fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
-00190 return;
-00191 }
-00192
-00193 /* iterate through the returned array and print each option */
-00194 for (idx = 0; idx < entries; ++idx) {
-00195 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
-00196 }
-00197
-00198 /* done with source attributes so free the allocated memory */
-00199 free(configs_option_ptr);
+00166 /* Get the attributes for the second source */
+00167 err = lbm_src_topic_dump(src_2, &entries, configs_option_ptr);
+00168 EX_LBM_CHK(err);
+00169
+00170 /* iterate through the returned array and print each option */
+00171 for (idx = 0; idx < entries; ++idx) {
+00172 printf("%s[%d]: %s = %s\n", configs_option_ptr[idx].type, idx, configs_option_ptr[idx].oname, configs_option_ptr[idx].val);
+00173 }
+00174
+00175 /* done with source attributes so free the allocated memory */
+00176 free(configs_option_ptr);
diff --git a/dump_attributes/c/dump_attributes_c.slsrc b/dump_attributes/c/dump_attributes_c.slsrc
index 7c5e4de..a63448f 100644
--- a/dump_attributes/c/dump_attributes_c.slsrc
+++ b/dump_attributes/c/dump_attributes_c.slsrc
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* dump_attributes.c - see http://ultramessaging.github.io/UMExamples/dump_attributes/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,23 +34,32 @@
#include
-main()
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_topic_t *topic_2; /* pointer to topic object */
- lbm_src_t *src_1; /* pointer to source object */
- lbm_src_t *src_2; /* pointer to source object */
- lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
- lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_topic_t *topic_2; /* pointer to topic object */
+ lbm_src_t *src_1; /* pointer to source object */
+ lbm_src_t *src_2; /* pointer to source object */
+ lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
+ lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
+ lbm_context_attr_t * cattr; /* pointer to context attribute object */
lbm_config_option_t *configs_option_ptr; /* pointer to configuration options returned from lib*/
- lbm_uint16_t res_port; /* Int to set resolver port */
- lbm_uint16_t des_port; /* Int to set lbtrm destination port */
- int err; /* return status of lbm functions (true=error) */
- int entries; /* Int used to count number of config entries */
- int idx; /* Int used to iterate across config entries */
-
+ lbm_uint16_t res_port; /* Int to set resolver port */
+ lbm_uint16_t des_port; /* Int to set lbtrm destination port */
+ int entries; /* Int used to count number of config entries */
+ int idx; /* Int used to iterate across config entries */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -45,121 +73,75 @@ main()
#endif
/* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_create(&cattr);
+ EX_LBM_CHK(err);
/* Setting the resolver address using the string method */
- if (lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:resolver_multicast_address: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12");
+ EX_LBM_CHK(err);
/* Setting the resolver port using the data-type value method */
res_port = 12345;
- if (lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_context_attr_setopt:resolver_mutlicast_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Creating the context */
err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
/*=semlit,block,src_create=*/
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr_1);
+ EX_LBM_CHK(err);
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+ EX_LBM_CHK(err);
/* Setting the lbtrm destination port via the direct value set method */
des_port = 14001;
- if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/*=semlit,endblock,src_create=*/
/*=semlit,block,src_create2=*/
/* Initialized the second source attributes as a copy of the first */
- if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+ EX_LBM_CHK(err);
/* Now modify the destination port for this second source to put the publisher on a different transport */
des_port = 14002;
- if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the second topic */
err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/*=semlit,endblock,src_create2=*/
/*=semlit,block,dump_ctx_attr=*/
- /* each lbm object (ctx, src, rcv) has a different number of configuration */
- /* attributes. To allocate the array, call the corresponding *_option_size */
- /* function and allocate enough memory to contain the return strings */
+ /* each lbm object (ctx, src, rcv) has a different number of configuration
+ * attributes. To allocate the array, call the corresponding *_option_size
+ * function and allocate enough memory to contain the return strings. */
entries = lbm_context_attr_option_size();
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the context */
- if (LBM_FAILURE == lbm_context_dump(ctx, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_context_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_context_dump(ctx, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -169,6 +151,7 @@ main()
/* done with context attributes so free the allocated memory */
free(configs_option_ptr);
/*=semlit,endblock,dump_ctx_attr=*/
+
/*=semlit,block,dump_src_attr=*/
/* each lbm object (ctx, src, rcv) has a different number of configuration */
/* options to allocate the array, call the corresponding *_option_size */
@@ -177,11 +160,8 @@ main()
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the first source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_1, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_1, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -193,11 +173,8 @@ main()
/*=semlit,endblock,dump_src_attr=*/
/*=semlit,block,dump_src_attr2=*/
/* Get the attributes for the second source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_2, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_2, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -207,17 +184,24 @@ main()
/* done with source attributes so free the allocated memory */
free(configs_option_ptr);
/*=semlit,endblock,dump_src_attr2=*/
+
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr_1);
- lbm_src_topic_attr_delete(tattr_2);
+ err = lbm_src_topic_attr_delete(tattr_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_delete(tattr_2);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src_1);
- lbm_src_delete(src_2);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(src_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_delete(src_2);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/dump_attributes/c/dump_attributes_c.slsrc.html b/dump_attributes/c/dump_attributes_c.slsrc.html
index 0651c7f..7901ced 100644
--- a/dump_attributes/c/dump_attributes_c.slsrc.html
+++ b/dump_attributes/c/dump_attributes_c.slsrc.html
@@ -94,22 +94,22 @@
00076
00077
00078
-00079
-00080
-00081
-00082
-00083
-00084
-00085
-00086
-00087
-00088
-00089
-00090
-00091
-00092
-00093
-00094
+00079
+00080
+00081
+00082
+00083
+00084
+00085
+00086
+00087
+00088
+00089
+00090
+00091
+00092
+00093
+00094
000950009600097
@@ -130,7 +130,7 @@
001120011300114
-00115
+00115001160011700118
@@ -146,90 +146,93 @@
001280012900130
-00131
-00132
-00133
-00134
-00135
-00136
-00137
-00138
-00139
-00140
-00141
-00142
-00143
-00144
-00145
+00131
+00132
+00133
+00134
+00135
+00136
+00137
+00138
+00139
+00140
+00141
+00142
+00143
+00144
+001450014600147
-00148
-00149
-00150
-00151
-00152
-00153
-00154
-00155
-00156
-00157
-00158
-00159
-00160
-00161
-00162
-00163
-00164
-00165
-00166
-00167
-00168
-00169
-00170
-00171
-00172
-00173
-00174
-00175
-00176
-00177
-00178
-00179
-00180
-00181
-00182
-00183
-00184
-00185
-00186
-00187
-00188
-00189
-00190
-00191
-00192
-00193
-00194
-00195
-00196
-00197
-00198
-00199
-00200
-00201
-00202
-00203
-00204
-00205
-00206
-00207
-00208
-00209
-00210
-00211
-00212
-00213
-
/* dump_attributes.c - see http://ultramessaging.github.io/UMExamples/dump_attributes/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -246,23 +249,32 @@
#include <lbm/lbm.h>
- main()
+ /* Example error checking macro. Include after each UM call. */
+ #define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+ } while (0)
+
+
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_topic_t *topic_2; /* pointer to topic object */
- lbm_src_t *src_1; /* pointer to source object */
- lbm_src_t *src_2; /* pointer to source object */
- lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
- lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_topic_t *topic_2; /* pointer to topic object */
+ lbm_src_t *src_1; /* pointer to source object */
+ lbm_src_t *src_2; /* pointer to source object */
+ lbm_src_topic_attr_t *tattr_1; /* pointer to source attribute object */
+ lbm_src_topic_attr_t *tattr_2; /* pointer to source attribute object */
+ lbm_context_attr_t * cattr; /* pointer to context attribute object */
lbm_config_option_t *configs_option_ptr; /* pointer to configuration options returned from lib*/
- lbm_uint16_t res_port; /* Int to set resolver port */
- lbm_uint16_t des_port; /* Int to set lbtrm destination port */
- int err; /* return status of lbm functions (true=error) */
- int entries; /* Int used to count number of config entries */
- int idx; /* Int used to iterate across config entries */
-
+ lbm_uint16_t res_port; /* Int to set resolver port */
+ lbm_uint16_t des_port; /* Int to set lbtrm destination port */
+ int entries; /* Int used to count number of config entries */
+ int idx; /* Int used to iterate across config entries */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -276,116 +288,70 @@
#endif
/* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_create(&cattr);
+ EX_LBM_CHK(err);
/* Setting the resolver address using the string method */
- if (lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:resolver_multicast_address: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12");
+ EX_LBM_CHK(err);
/* Setting the resolver port using the data-type value method */
res_port = 12345;
- if (lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_context_attr_setopt:resolver_mutlicast_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Creating the context */
err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr_1);
+ EX_LBM_CHK(err);
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+ EX_LBM_CHK(err);
/* Setting the lbtrm destination port via the direct value set method */
des_port = 14001;
- if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Initialized the second source attributes as a copy of the first */
- if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+ EX_LBM_CHK(err);
/* Now modify the destination port for this second source to put the publisher on a different transport */
des_port = 14002;
- if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the second topic */
err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
- /* each lbm object (ctx, src, rcv) has a different number of configuration */
- /* attributes. To allocate the array, call the corresponding *_option_size */
- /* function and allocate enough memory to contain the return strings */
+ EX_LBM_CHK(err);
+ /* each lbm object (ctx, src, rcv) has a different number of configuration
+ * attributes. To allocate the array, call the corresponding *_option_size
+ * function and allocate enough memory to contain the return strings. */
entries = lbm_context_attr_option_size();
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the context */
- if (LBM_FAILURE == lbm_context_dump(ctx, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_context_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_context_dump(ctx, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -394,6 +360,7 @@
/* done with context attributes so free the allocated memory */
free(configs_option_ptr);
+
/* each lbm object (ctx, src, rcv) has a different number of configuration */
/* options to allocate the array, call the corresponding *_option_size */
/* function and allocate enough memory to contain the return strings */
@@ -401,11 +368,8 @@
configs_option_ptr = malloc(entries * sizeof(lbm_config_option_t));
/* Get the attributes for the first source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_1, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_1, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -415,11 +379,8 @@
/* note that configs_option_ptr can be reused for multiple sources without being freed. */
/* Get the attributes for the second source */
- if (LBM_FAILURE == lbm_src_topic_dump(src_2, &entries, configs_option_ptr))
- {
- fprintf(stderr, "lbm_src_topic_dump error: %s\n", lbm_errmsg());
- return;
- }
+ err = lbm_src_topic_dump(src_2, &entries, configs_option_ptr);
+ EX_LBM_CHK(err);
/* iterate through the returned array and print each option */
for (idx = 0; idx < entries; ++idx) {
@@ -428,20 +389,27 @@
/* done with source attributes so free the allocated memory */
free(configs_option_ptr);
+
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr_1);
- lbm_src_topic_attr_delete(tattr_2);
+ err = lbm_src_topic_attr_delete(tattr_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_delete(tattr_2);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src_1);
- lbm_src_delete(src_2);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(src_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_delete(src_2);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/event_q_rcv/c/event_q_rcv.c b/event_q_rcv/c/event_q_rcv.c
index 2072cf1..e24ebc8 100644
--- a/event_q_rcv/c/event_q_rcv.c
+++ b/event_q_rcv/c/event_q_rcv.c
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* event_q_rcv.c - see http://ultramessaging.github.io/UMExamples/event_q_rcv/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,6 +34,16 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
/* Received message handler (passed into lbm_rcv_create()) */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
@@ -28,17 +57,16 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
return 0;
-}
+} /* rcv_handle_msg */
+
-main()
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_rcv_t *rcv; /* pointer to source object */
- lbm_topic_t *rtopic; /* pointer to receiver topic object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- int err; /* return status of lbm functions (true=error) */
- lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_rcv_t *rcv; /* pointer to source object */
+ lbm_topic_t *rtopic; /* pointer to receiver topic object */
+ lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -51,57 +79,38 @@ main()
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Create an event queue and associate it with a callback */
err = lbm_event_queue_create(&evq, NULL, NULL, NULL);
- if (err == LBM_FAILURE) {
- fprintf(stderr, "lbm_event_queue_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
+ EX_LBM_CHK(err);
+
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, evq);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
- /* This runs the eventQ for 10 seconds. This means for the next 10 seconds */
- /* all of the sources events will be processed on this thread. */
- if (lbm_event_dispatch(evq, 10000) == LBM_FAILURE) {
+ /* This runs the eventQ for 10 seconds. This means for the next 10 seconds
+ * all of the sources events will be processed on this thread. Normally,
+ * this is done on a separate, application-created thread. */
+ err = lbm_event_dispatch(evq, 10000);
+ if (err == LBM_FAILURE) {
fprintf(stderr, "lbm_event_dispatch returned error: %s\n", lbm_errmsg());
}
/* Finished with all LBM functions, delete the source and context object. */
- lbm_rcv_delete(rcv);
- lbm_context_delete(ctx);
- lbm_event_queue_delete(evq);
+ err = lbm_rcv_delete(rcv);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
+ err = lbm_event_queue_delete(evq);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/event_q_rcv/c/event_q_rcv.sldoc.html b/event_q_rcv/c/event_q_rcv.sldoc.html
index d61a68e..e977850 100644
--- a/event_q_rcv/c/event_q_rcv.sldoc.html
+++ b/event_q_rcv/c/event_q_rcv.sldoc.html
@@ -22,7 +22,7 @@
Creating the Event Queue
The eventQ is initialized by calling lbm_event_queue_create with no other arguments:
/* event_q_rcv.c - see http://ultramessaging.github.io/UMExamples/event_q_rcv/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -140,6 +168,16 @@
#include <lbm/lbm.h>
+ /* Example error checking macro. Include after each UM call. */
+ #define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+ } while (0)
+
+
/* Received message handler (passed into lbm_rcv_create()) */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
@@ -153,17 +191,16 @@
break;
}
return 0;
- }
+ } /* rcv_handle_msg */
+
- main()
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_rcv_t *rcv; /* pointer to source object */
- lbm_topic_t *rtopic; /* pointer to receiver topic object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- int err; /* return status of lbm functions (true=error) */
- lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_rcv_t *rcv; /* pointer to source object */
+ lbm_topic_t *rtopic; /* pointer to receiver topic object */
+ lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -176,60 +213,41 @@
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Create an event queue and associate it with a callback */
err = lbm_event_queue_create(&evq, NULL, NULL, NULL);
- if (err == LBM_FAILURE) {
- fprintf(stderr, "lbm_event_queue_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
+ EX_LBM_CHK(err);
+
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, evq);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
- /* This runs the eventQ for 10 seconds. This means for the next 10 seconds */
- /* all of the sources events will be processed on this thread. */
- if (lbm_event_dispatch(evq, 10000) == LBM_FAILURE) {
+ /* This runs the eventQ for 10 seconds. This means for the next 10 seconds
+ * all of the sources events will be processed on this thread. Normally,
+ * this is done on a separate, application-created thread. */
+ err = lbm_event_dispatch(evq, 10000);
+ if (err == LBM_FAILURE) {
fprintf(stderr, "lbm_event_dispatch returned error: %s\n", lbm_errmsg());
}
/* Finished with all LBM functions, delete the source and context object. */
- lbm_rcv_delete(rcv);
- lbm_context_delete(ctx);
- lbm_event_queue_delete(evq);
+ err = lbm_rcv_delete(rcv);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
+ err = lbm_event_queue_delete(evq);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/event_q_src/c/event_q_src.c b/event_q_src/c/event_q_src.c
index c65452c..bdb647f 100644
--- a/event_q_src/c/event_q_src.c
+++ b/event_q_src/c/event_q_src.c
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* event_q_src.c
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,6 +34,16 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
/* Source event handler. the UM library passes all per-source events */
/* back to the application. This will by default execute on the context */
/* thread. Therefore there should be no blocking calls made. If you must */
@@ -39,17 +68,17 @@ int handle_src_event(lbm_src_t *src, int event, void *ed, void *cd)
break;
}
return 0;
-}
+} /* handle_src_event */
+
-main()
+int main(int argc, char **argv)
{
lbm_context_t *ctx; /* pointer to context object */
lbm_topic_t *topic_1; /* pointer to topic object */
lbm_src_t *src; /* pointer to source object */
lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- int err; /* return status of lbm functions (true=error) */
lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -62,68 +91,48 @@ main()
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Create an event queue and associate it with a callback */
- if (lbm_event_queue_create(&evq, NULL, NULL, NULL) == LBM_FAILURE) {
- fprintf(stderr, "lbm_event_queue_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_event_queue_create(&evq, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src, ctx, topic_1, handle_src_event, NULL, evq);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* This runs the eventQ for 10 seconds. This means for the next 10 seconds */
/* all of the sources events will be processed on this thread. */
- if(lbm_event_dispatch(evq, 10000) == LBM_FAILURE) {
+ err = lbm_event_dispatch(evq, 10000);
+ if (err == LBM_FAILURE) {
fprintf(stderr, "lbm_event_dispatch returned error: %s\n", lbm_errmsg());
}
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr);
+ err = lbm_src_topic_attr_delete(tattr);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src);
- lbm_context_delete(ctx);
- lbm_event_queue_delete(evq);
+ err = lbm_src_delete(src);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
+ err = lbm_event_queue_delete(evq);
+ EX_LBM_CHK(err);
+
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/event_q_src/c/event_q_src.sldoc.html b/event_q_src/c/event_q_src.sldoc.html
index e11d44a..c54e612 100644
--- a/event_q_src/c/event_q_src.sldoc.html
+++ b/event_q_src/c/event_q_src.sldoc.html
@@ -22,7 +22,7 @@
Creating the Event Queue
The easiest way to creant an event queue is to initialize it by calling lbm_event_queue_create with no arguments.
/* event_q_src.c
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -162,6 +190,16 @@
#include <lbm/lbm.h>
+ /* Example error checking macro. Include after each UM call. */
+ #define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+ } while (0)
+
+
/* Source event handler. the UM library passes all per-source events */
/* back to the application. This will by default execute on the context */
/* thread. Therefore there should be no blocking calls made. If you must */
@@ -186,17 +224,17 @@
break;
}
return 0;
- }
+ } /* handle_src_event */
+
- main()
+ int main(int argc, char **argv)
{
lbm_context_t *ctx; /* pointer to context object */
lbm_topic_t *topic_1; /* pointer to topic object */
lbm_src_t *src; /* pointer to source object */
lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- int err; /* return status of lbm functions (true=error) */
lbm_event_queue_t *evq = NULL; /* pointer to eventQ handle */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -209,71 +247,51 @@
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Create an event queue and associate it with a callback */
- if (lbm_event_queue_create(&evq, NULL, NULL, NULL) == LBM_FAILURE) {
- fprintf(stderr, "lbm_event_queue_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_event_queue_create(&evq, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src, ctx, topic_1, handle_src_event, NULL, evq);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* This runs the eventQ for 10 seconds. This means for the next 10 seconds */
/* all of the sources events will be processed on this thread. */
- if(lbm_event_dispatch(evq, 10000) == LBM_FAILURE) {
+ err = lbm_event_dispatch(evq, 10000);
+ if (err == LBM_FAILURE) {
fprintf(stderr, "lbm_event_dispatch returned error: %s\n", lbm_errmsg());
}
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr);
+ err = lbm_src_topic_attr_delete(tattr);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src);
- lbm_context_delete(ctx);
- lbm_event_queue_delete(evq);
+ err = lbm_src_delete(src);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
+ err = lbm_event_queue_delete(evq);
+ EX_LBM_CHK(err);
+
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/handle_burst/c/handle_burst.c b/handle_burst/c/handle_burst.c
index 38567d6..c14de67 100644
--- a/handle_burst/c/handle_burst.c
+++ b/handle_burst/c/handle_burst.c
@@ -1,4 +1,23 @@
-/* handle_burst.c - http://ultramessaging.github.io/UMExamples */
+/* handle_burst.c - see http://ultramessaging.github.io/UMExamples/handle_burst/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
#if defined(_MSC_VER)
@@ -16,21 +35,21 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
+
/* Used to track the last sequence number received */
int last_sqn = 0;
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_DATA:
last_sqn = msg->sequence_number;
@@ -51,15 +70,15 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
}
return 0;
-}
+} /* rcv_handle_msg */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -78,7 +97,7 @@ main()
/* Create receiver for receiving request and sending response */
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -95,4 +114,5 @@ main()
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+ return 0;
} /* main */
diff --git a/handle_burst/c/handle_burst.sldoc.html b/handle_burst/c/handle_burst.sldoc.html
index 95d18d3..9712872 100644
--- a/handle_burst/c/handle_burst.sldoc.html
+++ b/handle_burst/c/handle_burst.sldoc.html
@@ -44,15 +44,15 @@
Context and Receiver Creation
Standard context and receiver creation, with a minimal amount of options set:
diff --git a/handle_burst/c/handle_burst_c.slsrc b/handle_burst/c/handle_burst_c.slsrc
index a042f23..d72392d 100644
--- a/handle_burst/c/handle_burst_c.slsrc
+++ b/handle_burst/c/handle_burst_c.slsrc
@@ -1,4 +1,23 @@
-/* handle_burst.c - http://ultramessaging.github.io/UMExamples */
+/* handle_burst.c - see http://ultramessaging.github.io/UMExamples/handle_burst/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
/* =semlit,block,includes=*/
#include
@@ -18,23 +37,23 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
+
/* Used to track the last sequence number received */
/* =semlit,block,last=*/
int last_sqn = 0;
/* =semlit,endblock,last=*/
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
/* =semlit,block,data=*/
case LBM_MSG_DATA:
@@ -61,15 +80,15 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
}
return 0;
-}
+} /* rcv_handle_msg */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ int err;
/* =semlit,block,windows=*/
#if defined(_WIN32)
@@ -91,7 +110,7 @@ main()
/* Create receiver for receiving request and sending response */
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -109,4 +128,5 @@ main()
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+ return 0;
} /* main */
diff --git a/handle_burst/c/handle_burst_c.slsrc.html b/handle_burst/c/handle_burst_c.slsrc.html
index 650d746..438558d 100644
--- a/handle_burst/c/handle_burst_c.slsrc.html
+++ b/handle_burst/c/handle_burst_c.slsrc.html
@@ -18,103 +18,142 @@
/* handle_burst.c - see http://ultramessaging.github.io/UMExamples/handle_burst/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
#if defined(_MSC_VER)
@@ -132,21 +171,21 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
+
/* Used to track the last sequence number received */
int last_sqn = 0;
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_DATA:
last_sqn = msg->sequence_number;
@@ -167,15 +206,15 @@
}
return 0;
- }
+ } /* rcv_handle_msg */
- main()
+
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -194,7 +233,7 @@
/* Create receiver for receiving request and sending response */
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -211,6 +250,7 @@
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+ return 0;
} /* main */
diff --git a/index.html b/index.html
index 8504a38..6257d38 100644
--- a/index.html
+++ b/index.html
@@ -1,10 +1,17 @@
-
-
-UMExamples - Learning the Ultra Messaging API by example
-
+UMExamples - Learning the Ultra Messaging API by example
+
+
-
-
Ultra Messaging Examples (UMExamples) is a documentation suite aimed at
providing high quality educational samples for the Informatica Ultra Messaging
@@ -20,7 +27,8 @@
A send can fail with an EWOULDBLOCK error, which can have different root causes. One cause for a persisted source is exceeding flight size. This example shows how to determine if flight size is the cause of an EWOULDBLOCK error.
Example UMP source application that demonstrates how a persisted source can failover to a backup store
-
-
+
+
+
+
Notices
+
This software and documentation are provided only under a separate license
+agreement containing restrictions on use and disclosure.
+No part of this document may be reproduced or transmitted in any form,
+by any means (electronic, photocopying, recording or otherwise)
+without prior consent of Informatica LLC.
+
+
Portions of this software and/or documentation are subject to copyright
+held by third parties.
+Required third party notices are included with the product.
+
+
The information in this documentation is subject to change without notice.
+If you find any problems in this documentation, please report them to us in
+writing at Informatica LLC 2100 Seaport Blvd. Redwood City, CA 94063.
+
+
Informatica products are warranted according to the terms and conditions
+of the agreements under which they are provided.
+ INFORMATICA LLC PROVIDES THE INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR
+CONDITION OF NON-INFRINGEMENT.
+
+
diff --git a/infa_logo.png b/infa_logo.png
new file mode 100644
index 0000000..e3d8b45
Binary files /dev/null and b/infa_logo.png differ
diff --git a/java_index.html b/java_index.html
index 904d3e8..8e0be37 100644
--- a/java_index.html
+++ b/java_index.html
@@ -1,9 +1,17 @@
-
-
-UMExamples - Java Language
-
+UMExamples - Java Language
+
+
-
+
+
A sample application that handles all UMP receiver callbacks and logs important data
+
+
+
+
Notices
+
This software and documentation are provided only under a separate license
+agreement containing restrictions on use and disclosure.
+No part of this document may be reproduced or transmitted in any form,
+by any means (electronic, photocopying, recording or otherwise)
+without prior consent of Informatica LLC.
+
+
Portions of this software and/or documentation are subject to copyright
+held by third parties.
+Required third party notices are included with the product.
+
+
The information in this documentation is subject to change without notice.
+If you find any problems in this documentation, please report them to us in
+writing at Informatica LLC 2100 Seaport Blvd. Redwood City, CA 94063.
+
+
Informatica products are warranted according to the terms and conditions
+of the agreements under which they are provided.
+ INFORMATICA LLC PROVIDES THE INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR
+CONDITION OF NON-INFRINGEMENT.
+
diff --git a/late_join/c/late_join.c b/late_join/c/late_join.c
index 2986fe2..378cdf9 100644
--- a/late_join/c/late_join.c
+++ b/late_join/c/late_join.c
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* late_join.c - see http://ultramessaging.github.io/UMExamples/late_join/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,6 +34,16 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
/* Received message handler (passed into lbm_rcv_create()) */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
@@ -27,7 +56,7 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
else
printf("Normal Message. SQN: %d\n", msg->sequence_number);
- //some processing
+ /* some processing */
break;
case LBM_MSG_BOS:
printf("Beggining of transport.\n");
@@ -40,18 +69,18 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
return 0;
-}
+} /* rcv_handle_msg */
+
-main()
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_src_t *early_src; /* pointer to source object */
- lbm_rcv_t *late_rcv; /* pointer to receiver object */
- lbm_topic_t *rtopic; /* pointer to receiver topic object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- int err; /* return status of lbm functions (true=error) */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_src_t *early_src; /* pointer to source object */
+ lbm_rcv_t *late_rcv; /* pointer to receiver object */
+ lbm_topic_t *rtopic; /* pointer to receiver topic object */
+ lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -64,91 +93,58 @@ main()
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
+
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
+
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr, "late_join", "1") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
- if (lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1")
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_src_topic_attr_str_setopt(tattr, "late_join", "1");
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1");
+ EX_LBM_CHK(err);
+
/* Allocating the source topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
- /* Creating the source */
+ /* Creating the source */
err = lbm_src_create(&early_src, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Wait for topic resolution to happen */
- Sleep(1);
+ SLEEP(1);
- /* Send a message... we should expect no one to get it because we haven't created the receiver
- yet. */
+ /* Send a message... we should expect no one to get it because we haven't
+ * created the receiver yet. */
err = lbm_src_send(early_src, "Hello!", 6, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&late_rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
SLEEP(100000);
- /* Finished with all LBM functions, delete the receiver and context object. */
- /* Delete the source topic attribute objects */
- lbm_src_topic_attr_delete(tattr);
+ /* Finished with all LBM functions, delete the receiver and context object.
+ * Delete the source topic attribute objects. */
+ err = lbm_src_topic_attr_delete(tattr);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(early_src);
- lbm_rcv_delete(late_rcv);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(early_src);
+ EX_LBM_CHK(err);
+ err = lbm_rcv_delete(late_rcv);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
-
+ return 0;
+} /* main */
diff --git a/late_join/c/late_join.sldoc.html b/late_join/c/late_join.sldoc.html
index 4c1d3ce..d538a34 100644
--- a/late_join/c/late_join.sldoc.html
+++ b/late_join/c/late_join.sldoc.html
@@ -20,11 +20,8 @@
Enabling Late Join
Sources by default have late join disabled. To enable late join the application must do two things. The first is to enable late-join. This can be done as follows:
that the receiver can miss the first few messages published. This is because it takes a non-zero amount of time to resolve the source and join the underlying transport.
-00110 err = lbm_src_create(&early_src, ctx, topic_1, NULL, NULL, NULL);
-00111 if (err)
-00112 {
-00113 printf("line %d: %s\n", __LINE__, lbm_errmsg());
-00114 exit(1);
-00115 }
-00116
-00117 /* Wait for topic resolution to happen */
-00118 Sleep(1);
-00119
-00120 /* Send a message... we should expect no one to get it because we haven't created the receiver
-00121 yet. */
-00122 err = lbm_src_send(early_src, "Hello!", 6, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
+00115 err = lbm_src_create(&early_src, ctx, topic_1, NULL, NULL, NULL);
+00116 EX_LBM_CHK(err);
+00117
+00118 /* Wait for topic resolution to happen */
+00119 SLEEP(1);
+00120
+00121 /* Send a message... we should expect no one to get it because we haven't
+00122 * created the receiver yet. */
+00123 err = lbm_src_send(early_src, "Hello!", 6, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
@@ -68,7 +58,7 @@
Creating the receiver and receiving late join
the default does not have to be changed. Therefore, the receiver is simply created:
diff --git a/late_join/c/late_join_c.slsrc b/late_join/c/late_join_c.slsrc
index f67d708..0cb0882 100644
--- a/late_join/c/late_join_c.slsrc
+++ b/late_join/c/late_join_c.slsrc
@@ -1,4 +1,23 @@
-/* Example on setting Ultra Messaging attributes */
+/* late_join.c - see http://ultramessaging.github.io/UMExamples/late_join/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,10 +34,20 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
/* Received message handler (passed into lbm_rcv_create()) */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- /* =semlit,block,callback= */
+ /* =semlit,block,callback= */
switch (msg->type) {
case LBM_MSG_DATA:
if (msg->flags & LBM_MSG_FLAG_RETRANSMIT)
@@ -28,7 +57,7 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
else
printf("Normal Message. SQN: %d\n", msg->sequence_number);
- //some processing
+ /* some processing */
/* =semlit,endblock,callback= */
break;
case LBM_MSG_BOS:
@@ -42,18 +71,18 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
return 0;
-}
+} /* rcv_handle_msg */
+
-main()
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_src_t *early_src; /* pointer to source object */
- lbm_rcv_t *late_rcv; /* pointer to receiver object */
- lbm_topic_t *rtopic; /* pointer to receiver topic object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- int err; /* return status of lbm functions (true=error) */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_src_t *early_src; /* pointer to source object */
+ lbm_rcv_t *late_rcv; /* pointer to receiver object */
+ lbm_topic_t *rtopic; /* pointer to receiver topic object */
+ lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -66,101 +95,68 @@ main()
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
+
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
+
/* Setting the transport via the source topic string method */
/* =semlit,block,enable_lj= */
- if (lbm_src_topic_attr_str_setopt(tattr, "late_join", "1") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "late_join", "1");
+ EX_LBM_CHK(err);
/* =semlit,endblock,enable_lj= */
/* =semlit,block,configure_lj= */
- if (lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1")
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1");
+ EX_LBM_CHK(err);
/* =semlit,endblock,configure_lj= */
-
+
/* Allocating the source topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
- /* Creating the source */
- /* =semlit,block,source= */
+ /* Creating the source */
+ /* =semlit,block,source= */
err = lbm_src_create(&early_src, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Wait for topic resolution to happen */
- Sleep(1);
+ SLEEP(1);
- /* Send a message... we should expect no one to get it because we haven't created the receiver
- yet. */
+ /* Send a message... we should expect no one to get it because we haven't
+ * created the receiver yet. */
err = lbm_src_send(early_src, "Hello!", 6, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
/* =semlit,endblock,source= */
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* =semlit,block,receiver= */
err = lbm_rcv_create(&late_rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
/* =semlit,endblock,receiver= */
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
SLEEP(100000);
- /* Finished with all LBM functions, delete the receiver and context object. */
- /* Delete the source topic attribute objects */
- lbm_src_topic_attr_delete(tattr);
+ /* Finished with all LBM functions, delete the receiver and context object.
+ * Delete the source topic attribute objects. */
+ err = lbm_src_topic_attr_delete(tattr);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
/* =semlit,block,cleanup= */
- lbm_src_delete(early_src);
- lbm_rcv_delete(late_rcv);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(early_src);
+ EX_LBM_CHK(err);
+ err = lbm_rcv_delete(late_rcv);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
/* =semlit,endblock,cleanup= */
#if defined(_MSC_VER)
WSACleanup();
#endif
-}
-
+ return 0;
+} /* main */
diff --git a/late_join/c/late_join_c.slsrc.html b/late_join/c/late_join_c.slsrc.html
index e878172..e34edba 100644
--- a/late_join/c/late_join_c.slsrc.html
+++ b/late_join/c/late_join_c.slsrc.html
@@ -36,16 +36,16 @@
00018
00019
00020
-00021
-00022
-00023
-00024
-00025
-00026
-00027
-00028
-00029
-00030
+00021
+00022
+00023
+00024
+00025
+00026
+00027
+00028
+00029
+00030
00031
00032
00033
@@ -65,16 +65,16 @@
00047
00048
00049
-00050
-00051
-00052
-00053
-00054
-00055
-00056
-00057
-00058
-00059
+00050
+00051
+00052
+00053
+00054
+00055
+00056
+00057
+00058
+00059
00060
00061
00062
@@ -105,31 +105,31 @@
00087
00088
00089
-00090
-00091
-00092
-00093
-00094
-00095
-00096
-00097
-00098
-00099
+00090
+00091
+00092
+00093
+00094
+00095
+00096
+00097
+00098
+00099
00100
00101
00102
00103
00104
-00105
-00106
-00107
-00108
+00105
+00106
+00107
+00108
00109
-00110
-00111
-00112
-00113
-00114
+00110
+00111
+00112
+00113
+00114
001150011600117
@@ -138,39 +138,54 @@
001200012100122
-00123
+00123
00124
00125
00126
00127
-00128
+00128
00129
00130
00131
-00132
+00132
00133
00134
00135
00136
00137
00138
-00139
-00140
-00141
-00142
-00143
-00144
+00139
+00140
+00141
+00142
+00143
+00144
00145
-00146
-00147
-00148
+00146
+00147
+00148
00149
00150
-00151
-00152
-00153
-00154
-
/* Example on setting Ultra Messaging attributes */
+
/* late_join.c - see http://ultramessaging.github.io/UMExamples/late_join/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -187,6 +202,16 @@
#include <lbm/lbm.h>
+ /* Example error checking macro. Include after each UM call. */
+ #define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+ } while (0)
+
+
/* Received message handler (passed into lbm_rcv_create()) */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
@@ -199,7 +224,7 @@
else
printf("Normal Message. SQN: %d\n", msg->sequence_number);
- //some processing
+ /* some processing */
break;
case LBM_MSG_BOS:
printf("Beggining of transport.\n");
@@ -212,18 +237,18 @@
break;
}
return 0;
- }
+ } /* rcv_handle_msg */
+
- main()
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_topic_t *topic_1; /* pointer to topic object */
- lbm_src_t *early_src; /* pointer to source object */
- lbm_rcv_t *late_rcv; /* pointer to receiver object */
- lbm_topic_t *rtopic; /* pointer to receiver topic object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- int err; /* return status of lbm functions (true=error) */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic_1; /* pointer to topic object */
+ lbm_src_t *early_src; /* pointer to source object */
+ lbm_rcv_t *late_rcv; /* pointer to receiver object */
+ lbm_topic_t *rtopic; /* pointer to receiver topic object */
+ lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -236,94 +261,61 @@
}
#endif
- /* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
/* Creating the context */
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
+
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
+
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr, "late_join", "1") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
- if (lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1")
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
-
+ err = lbm_src_topic_attr_str_setopt(tattr, "late_join", "1");
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_str_setopt(tattr, "retransmit_retention_size_threshold", "1");
+ EX_LBM_CHK(err);
+
/* Allocating the source topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
- /* Creating the source */
+ /* Creating the source */
err = lbm_src_create(&early_src, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Wait for topic resolution to happen */
- Sleep(1);
+ SLEEP(1);
- /* Send a message... we should expect no one to get it because we haven't created the receiver
- yet. */
+ /* Send a message... we should expect no one to get it because we haven't
+ * created the receiver yet. */
err = lbm_src_send(early_src, "Hello!", 6, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
- /* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&late_rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
SLEEP(100000);
- /* Finished with all LBM functions, delete the receiver and context object. */
- /* Delete the source topic attribute objects */
- lbm_src_topic_attr_delete(tattr);
+ /* Finished with all LBM functions, delete the receiver and context object.
+ * Delete the source topic attribute objects. */
+ err = lbm_src_topic_attr_delete(tattr);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(early_src);
- lbm_rcv_delete(late_rcv);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(early_src);
+ EX_LBM_CHK(err);
+ err = lbm_rcv_delete(late_rcv);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
-
+ return 0;
+ } /* main */
diff --git a/load_config/c/load_config.c b/load_config/c/load_config.c
index 04da4fe..07456c3 100644
--- a/load_config/c/load_config.c
+++ b/load_config/c/load_config.c
@@ -1,4 +1,23 @@
-/* load_config.c - http://ultramessaging.github.io/UMExamples */
+/* load_config.c - see http://ultramessaging.github.io/UMExamples/load_config/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -26,13 +45,16 @@
#define LBM_CONFIG_XML_FILE "../xml_config.xml"
#define LBM_APPLICATION_NAME "processA"
-main()
+
+int main(int argc, char **argv)
{
- int err; /* Used for checking API return codes */
+ int err;
err = lbm_config((const char *)LBM_CONFIG_FLAT_FILE);
EX_LBM_CHK(err);
err = lbm_config_xml_file((const char *)LBM_CONFIG_XML_FILE, (const char *)LBM_APPLICATION_NAME);
EX_LBM_CHK(err);
-}
+
+ return 0;
+} /* main */
diff --git a/load_config/c/load_config.sldoc.html b/load_config/c/load_config.sldoc.html
index 9f19e6b..8bd5996 100644
--- a/load_config/c/load_config.sldoc.html
+++ b/load_config/c/load_config.sldoc.html
@@ -53,9 +53,9 @@
Define Configuration File Names
of this sample application, they are simply defined as macros
diff --git a/load_config/c/load_config_c.slsrc b/load_config/c/load_config_c.slsrc
index d010a11..b0ed194 100644
--- a/load_config/c/load_config_c.slsrc
+++ b/load_config/c/load_config_c.slsrc
@@ -1,4 +1,23 @@
-/* load_config.c - http://ultramessaging.github.io/UMExamples */
+/* load_config.c - see http://ultramessaging.github.io/UMExamples/load_config/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
/* =semlit,block,includes=*/
#include
@@ -32,10 +51,11 @@
#define LBM_APPLICATION_NAME "processA"
/* =semlit,endblock,define_configs=*/
-main()
+
+int main(int argc, char **argv)
{
/* =semlit,block,vars=*/
- int err; /* Used for checking API return codes */
+ int err;
/* =semlit,endblock,vars=*/
/* =semlit,block,flat_file=*/
@@ -47,4 +67,6 @@ main()
err = lbm_config_xml_file((const char *)LBM_CONFIG_XML_FILE, (const char *)LBM_APPLICATION_NAME);
EX_LBM_CHK(err);
/* =semlit,endblock,xml_file=*/
-}
+
+ return 0;
+} /* main */
diff --git a/load_config/c/load_config_c.slsrc.html b/load_config/c/load_config_c.slsrc.html
index f99bad7..49bc5d6 100644
--- a/load_config/c/load_config_c.slsrc.html
+++ b/load_config/c/load_config_c.slsrc.html
@@ -18,43 +18,84 @@
/* load_config.c - see http://ultramessaging.github.io/UMExamples/load_config/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -82,16 +123,19 @@
#define LBM_CONFIG_XML_FILE "../xml_config.xml"
#define LBM_APPLICATION_NAME "processA"
- main()
+
+ int main(int argc, char **argv)
{
- int err; /* Used for checking API return codes */
+ int err;
err = lbm_config((const char *)LBM_CONFIG_FLAT_FILE);
EX_LBM_CHK(err);
err = lbm_config_xml_file((const char *)LBM_CONFIG_XML_FILE, (const char *)LBM_APPLICATION_NAME);
EX_LBM_CHK(err);
- }
+
+ return 0;
+ } /* main */
diff --git a/logging_callback/c/logging_callback.c b/logging_callback/c/logging_callback.c
index 595cadf..54b52dd 100644
--- a/logging_callback/c/logging_callback.c
+++ b/logging_callback/c/logging_callback.c
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* logging_callback.c - see http://ultramessaging.github.io/UMExamples/logging_callback/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -15,81 +34,74 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
+
/* Logging callback */
int lbm_log_msg(int level, const char *message, void *clientd)
{
- printf("LOG Level %d: %s\n", level, message);
- return 0;
-}
+ printf("LOG Level %d: %s\n", level, message);
+ return 0;
+} /* lbm_log_msg */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* pointer to context object */
- lbm_context_attr_t * cattr; /* pointer to context attribute object */
- lbm_topic_t *topic; /* pointer to topic object */
- lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
- lbm_src_t *src; /* pointer to source object */
- int err; /* return status of lbm functions (true=error) */
+ lbm_context_t *ctx; /* pointer to context object */
+ lbm_topic_t *topic; /* pointer to topic object */
+ lbm_src_topic_attr_t *tattr; /* pointer to source attribute object */
+ lbm_src_t *src; /* pointer to source object */
+ int err;
#if defined(_MSC_VER)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
- /* Setup logging callback */
- if (lbm_log(lbm_log_msg, NULL) == LBM_FAILURE) {
- fprintf(stderr, "lbm_log: %s\n", lbm_errmsg());
- exit(1);
- }
+ /* Setup logging callback */
+ err = lbm_log(lbm_log_msg, NULL);
+ EX_LBM_CHK(err);
- err = lbm_context_create(&ctx, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
/* Setting late_join */
- if (lbm_src_topic_attr_str_setopt(tattr, "late_join", "1") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:late_join: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "late_join", "1");
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic, ctx, "test.topic.1", tattr);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src, ctx, topic, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* At the very least, the following core message should print via the logging callback: */
/* LOG Level 5: Core-5688-539: NOTICE: Source "test.topic.1" has no retention settings (1 message retained max) */
/* Cleanup */
- lbm_src_delete(src);
- lbm_context_delete(ctx);
-}
+ err = lbm_src_delete(src);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
+ return 0;
+} /* main */
diff --git a/logging_callback/c/logging_callback.sldoc.html b/logging_callback/c/logging_callback.sldoc.html
index fc92d20..8bf8309 100644
--- a/logging_callback/c/logging_callback.sldoc.html
+++ b/logging_callback/c/logging_callback.sldoc.html
@@ -50,10 +50,8 @@
completed since the last send, so a short sleep is included:
-00071 /*** Cleanup: delete UM objects. ***/
-00072
-00073 SLEEP(3); /* Linger a bit to allow retransmissions. */
+00089 /*** Cleanup: delete UM objects. ***/
+00090
+00091 SLEEP(3); /* Linger a bit to allow retransmissions. */
@@ -176,11 +176,11 @@
Cleanup
When deleting UM objects, order of deletion is important:
/* multi_context.c - see http://ultramessaging.github.io/UMExamples/multi_context/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -107,33 +147,34 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
#define LBM_CONFIG_XML_FILE "multi_context_config.xml"
#define LBM_APPLICATION_NAME "main"
- main()
+
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx_1; /* Context object */
- lbm_context_attr_t * cattr_1; /* pointer to context attribute object */
- lbm_context_t *ctx_2; /* Context object */
- lbm_context_attr_t * cattr_2; /* pointer to context attribute object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx_1; /* Context object */
+ lbm_context_attr_t * cattr_1; /* pointer to context attribute object */
+ lbm_context_t *ctx_2; /* Context object */
+ lbm_context_attr_t * cattr_2; /* pointer to context attribute object */
+ int err;
#if defined(_WIN32)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
err = lbm_config_xml_file((const char *)LBM_CONFIG_XML_FILE, (const char *)LBM_APPLICATION_NAME);
@@ -159,7 +200,8 @@
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/no_source_notify/c/no_source_notify.c b/no_source_notify/c/no_source_notify.c
index 1ee9508..de9304e 100644
--- a/no_source_notify/c/no_source_notify.c
+++ b/no_source_notify/c/no_source_notify.c
@@ -1,4 +1,23 @@
-/* no_source_notify.c - http://ultramessaging.github.io/UMExamples */
+/* no_source_notify.c - see http://ultramessaging.github.io/UMExamples/no_source_notify/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -17,22 +36,21 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
#define NO_SOURCE_QUERIES "25"
int no_source = 0;
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_NO_SOURCE_NOTIFICATION:
printf("[%s], no sources found for topic after %s queries\n", msg->topic_name, NO_SOURCE_QUERIES);
@@ -43,16 +61,16 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
return 0;
-}
+} /* rcv_handle_msg */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to topics. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -70,13 +88,13 @@ main()
EX_LBM_CHK(err);
err = lbm_rcv_topic_attr_create(&rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_attr_str_setopt(rattr, "resolution_no_source_notification_threshold", NO_SOURCE_QUERIES);
EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -93,4 +111,6 @@ main()
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+
+ return 0;
} /* main */
diff --git a/no_source_notify/c/no_source_notify.sldoc.html b/no_source_notify/c/no_source_notify.sldoc.html
index 84af21f..8e49f26 100644
--- a/no_source_notify/c/no_source_notify.sldoc.html
+++ b/no_source_notify/c/no_source_notify.sldoc.html
@@ -34,14 +34,14 @@
Variables
First there is a macro to define the number of queries threshold before the notification is executed
-00037 case LBM_MSG_NO_SOURCE_NOTIFICATION:
-00038 printf("[%s], no sources found for topic after %s queries\n", msg->topic_name, NO_SOURCE_QUERIES);
-00039 no_source++;
-00040 break;
+00055 case LBM_MSG_NO_SOURCE_NOTIFICATION:
+00056 printf("[%s], no sources found for topic after %s queries\n", msg->topic_name, NO_SOURCE_QUERIES);
+00057 no_source++;
+00058 break;
/* no_source_notify.c - see http://ultramessaging.github.io/UMExamples/no_source_notify/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -131,22 +170,21 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
#define NO_SOURCE_QUERIES "25"
int no_source = 0;
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_NO_SOURCE_NOTIFICATION:
printf("[%s], no sources found for topic after %s queries\n", msg->topic_name, NO_SOURCE_QUERIES);
@@ -157,16 +195,16 @@
break;
}
return 0;
- }
+ } /* rcv_handle_msg */
- main()
+
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to topics. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -184,13 +222,13 @@
EX_LBM_CHK(err);
err = lbm_rcv_topic_attr_create(&rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_topic_attr_str_setopt(rattr, "resolution_no_source_notification_threshold", NO_SOURCE_QUERIES);
EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -207,6 +245,8 @@
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+
+ return 0;
} /* main */
diff --git a/quorum_state/c/quorum_state.c b/quorum_state/c/quorum_state.c
index 6dcc3aa..587afa9 100644
--- a/quorum_state/c/quorum_state.c
+++ b/quorum_state/c/quorum_state.c
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* quorum_state.c - see http://ultramessaging.github.io/UMExamples/quorum_state/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
#include
@@ -22,8 +41,18 @@
# define SLEEP_SEC(x) sleep(x)
#endif
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
int src_ready = 0;
+
/* Source event handler callback (passed into lbm_src_create()) */
int handle_src_event(lbm_src_t *src, int event, void *ed, void *cd)
{
@@ -42,82 +71,56 @@ int handle_src_event(lbm_src_t *src, int event, void *ed, void *cd)
}
}
return 0;
-}
+} /* handle_src_event */
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_topic_t *topic; /* Topic object */
- lbm_src_t *src; /* Source object */
- lbm_src_topic_attr_t * tattr; /* Source topic attribute object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_topic_t *topic; /* Topic object */
+ lbm_src_t *src; /* Source object */
+ lbm_src_topic_attr_t * tattr; /* Source topic attribute object */
+ int err;
#if defined(_WIN32)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
-
- if (lbm_src_topic_attr_create(&tattr) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
-
- /* Assuming there is a store running on the localhost at port 29999 */
- if (lbm_src_topic_attr_str_setopt(tattr, "ume_store", "127.0.0.1:29999") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:ume_store: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
+
+ err = lbm_src_topic_attr_create(&tattr);
+ EX_LBM_CHK(err);
+
+ /* Assuming there is a store running on the localhost at port 29999 */
+ err = lbm_src_topic_attr_str_setopt(tattr, "ume_store", "127.0.0.1:29999");
+ EX_LBM_CHK(err);
/* Need to set store behavior to Quorum-Consensus */
- if (lbm_src_topic_attr_str_setopt(tattr, "ume_store_behavior", "qc") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:ume_store_behavior: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr, "ume_store_behavior", "qc");
+ EX_LBM_CHK(err);
- err = lbm_src_topic_alloc(&topic, ctx, "test.topic", tattr);
- if (err)
- {
- printf("lbm_src_topic_alloc - line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_alloc(&topic, ctx, "test.topic", tattr);
+ EX_LBM_CHK(err);
- err = lbm_src_create(&src, ctx, topic, handle_src_event, NULL, NULL);
- if (err)
- {
- printf("lbm_src_create - line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_create(&src, ctx, topic, handle_src_event, NULL, NULL);
+ EX_LBM_CHK(err);
while(1)
{
if (src_ready)
{
- if (lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK) == LBM_FAILURE)
+ err = lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK);
+ if (err == LBM_FAILURE)
{
- /* Assume EWOULDBLOCK and wait */
+ /* Assume EWOULDBLOCK, wait, and retry. */
SLEEP_SEC(1);
}
}
@@ -128,4 +131,6 @@ main()
SLEEP_SEC(1);
}
}
-}
+
+ return 0;
+} /* main */
diff --git a/quorum_state/c/quorum_state.sldoc.html b/quorum_state/c/quorum_state.sldoc.html
index e35533c..e5f40fe 100644
--- a/quorum_state/c/quorum_state.sldoc.html
+++ b/quorum_state/c/quorum_state.sldoc.html
@@ -35,7 +35,7 @@
Create a state variable
initialize as 0, because the source upon creation will not be in a state where it can send.
-00025 int src_ready = 0;
+00053 int src_ready = 0;
notified via the unresponsive source event; in either case the source cannot send.
-00116 if (src_ready)
-00117 {
-00118 if (lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK) == LBM_FAILURE)
-00119 {
-00120 /* Assume EWOULDBLOCK and wait */
-00121 SLEEP_SEC(1);
-00122 }
-00123 }
-00124 else
-00125 {
-00126 /* Print a warning that the source is not ready and sleep */
-00127 printf("Source is not ready to send (no quorum)\n");
-00128 SLEEP_SEC(1);
-00129 }
+00118 if (src_ready)
+00119 {
+00120 err = lbm_src_send(src, "test", 4, LBM_SRC_NONBLOCK);
+00121 if (err == LBM_FAILURE)
+00122 {
+00123 /* Assume EWOULDBLOCK, wait, and retry. */
+00124 SLEEP_SEC(1);
+00125 }
+00126 }
+00127 else
+00128 {
+00129 /* Print a warning that the source is not ready and sleep */
+00130 printf("Source is not ready to send (no quorum)\n");
+00131 SLEEP_SEC(1);
+00132 }
@@ -218,21 +192,21 @@
Includes
Include files for this application. Notice the Windows specific include files - these are not necessary for Linux only applications
-00108 while (run) { /* loop until response received */
-00109 SLEEP(1);
-00110 }
+00128 while (run) { /* loop until response received */
+00129 SLEEP(1);
+00130 }
/* request_response.c - see http://ultramessaging.github.io/UMExamples/request_response/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -165,17 +206,18 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
__FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
+ exit(1); \
} \
} while (0)
/* Global var used to indicate that the application can exit after response received */
int run = 1;
- /* Callback used to handle request message for receiver */
- int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+
+ /* Callback used to handle request message for receiver */
+ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
int err;
@@ -186,47 +228,47 @@
EX_LBM_CHK(err);
break;
}
- }
+ return 0;
+ } /* rcv_handle_msg */
+
- /* Callback used to handle response message */
- int handle_response(lbm_request_t *req, lbm_msg_t *msg, void *clientd)
+ /* Callback used to handle response message */
+ int handle_response(lbm_request_t *req, lbm_msg_t *msg, void *clientd)
{
- switch (msg->type) {
- case LBM_MSG_RESPONSE:
+ switch (msg->type) {
+ case LBM_MSG_RESPONSE:
printf("LBM_MSG_RESPONSE received\n");
run = 0;
break;
}
- }
+ return 0;
+ } /* handle_response */
- main()
+
+ int main(int argc, char **argv)
{
lbm_context_t *ctx; /* Context object */
lbm_topic_t *stopic; /* Source Topic object */
lbm_src_t *src; /* Source object */
lbm_src_topic_attr_t * tattr; /* Source topic attribute object */
- lbm_context_attr_t * cattr; /* Context attribute object */
lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
lbm_topic_t *rtopic; /* Receiver Topic object */
lbm_request_t *req; /* Request object */
- int err; /* Used for checking API return codes */
+ int err;
#if defined(_WIN32)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
-
+
/* Initialize context atrributes and create context */
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
/* Create receiver for receiving request and sending response */
@@ -239,7 +281,7 @@
/* Create source for sending request */
err = lbm_src_topic_attr_create(&tattr);
EX_LBM_CHK(err);
-
+
err = lbm_src_topic_alloc(&stopic, ctx, "test.topic", tattr);
EX_LBM_CHK(err);
@@ -253,7 +295,7 @@
EX_LBM_CHK(err);
while (run) { /* loop until response received */
- SLEEP(1);
+ SLEEP(1);
}
/* Clean up */
@@ -273,6 +315,8 @@
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
+
+ return 0;
} /* main */
diff --git a/schedule_timers/c/schedule_timers.c b/schedule_timers/c/schedule_timers.c
index bd5d6db..05d3f3e 100644
--- a/schedule_timers/c/schedule_timers.c
+++ b/schedule_timers/c/schedule_timers.c
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* schedule_timers.c - see http://ultramessaging.github.io/UMExamples/schedule_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -24,45 +43,45 @@
} \
} while (0)
-int wait = 1;
+int wait_flag = 1;
+
/* Timer callback function */
int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
printf("Timer executed. Set wait to 0 so application can cleanly exit\n");
- wait = 0;
-}
+ wait_flag = 0;
+
+ return 0;
+} /* sample_timer_handler */
+
-main()
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
- int timer_id; /* Used to get timer id from schedule API */
+ lbm_context_t *ctx; /* Context object */
+ int timer_id; /* Used to get timer id from schedule API */
+ int err;
/* Initialize context atrributes and create context */
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
- if ((timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000)) == -1) {
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", __FILE__, __LINE__, lbm_errmsg());
- exit(1);
- }
+ /* Be careful! lbm_schedule_timer() returns >0 on success. */
+ timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000);
+ EX_LBM_CHK(timer_id);
/* Now wait for callback to end the wait and close the application */
- while (wait)
+ while (wait_flag)
SLEEP(1);
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/schedule_timers/c/schedule_timers.sldoc b/schedule_timers/c/schedule_timers.sldoc
index 268c5ef..d60ae2d 100644
--- a/schedule_timers/c/schedule_timers.sldoc
+++ b/schedule_timers/c/schedule_timers.sldoc
@@ -19,14 +19,14 @@
The callback function defined below is the application callback that will be invoked when the scheduled timer expires. This callback will
be executed on the UM context thread (at least for the purpose of this example it will be executed on the context thread.
=semlit,insert,timer_cb=
-
Note that inside the callback, the global "wait" variable is set to 0, this allows the main thread to stop tight-looping and exit.
+
Note that inside the callback, the global "wait_flag" variable is set to 0, this allows the main thread to stop tight-looping and exit.
be executed on the UM context thread (at least for the purpose of this example it will be executed on the context thread.
-00030 int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
-00031 {
-00032 printf("Timer executed. Set wait to 0 so application can cleanly exit\n");
-00033 wait = 0;
-00034 }
+00049 /* Timer callback function */
+00050 int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
+00051 {
+00052 printf("Timer executed. Set wait to 0 so application can cleanly exit\n");
+00053 wait_flag = 0;
+00054
+00055 return 0;
+00056 } /* sample_timer_handler */
-
Note that inside the callback, the global "wait" variable is set to 0, this allows the main thread to stop tight-looping and exit.
+
Note that inside the callback, the global "wait_flag" variable is set to 0, this allows the main thread to stop tight-looping and exit.
Scheduling the Timer Callback
Here the application is actually scheduling the callback timer, set to be executed in 1000 milliseconds. The return value should be saved
by the application in the event that the application wishes to cancel the timer before it executes. Special care must be taken when cancelling
timer callback, for more information please see
For the purpose of this example application, it is using the global variable "wait" as a semaphore essentially. Once the timer executes, wait
+
For the purpose of this example application, it is using the global variable "wait_flag" as a semaphore essentially. Once the timer executes, wait
will be set to 0 and the application can cleanly exit by deleting the context.
diff --git a/schedule_timers/c/schedule_timers_c.slsrc b/schedule_timers/c/schedule_timers_c.slsrc
index eb3e2f5..f39cd45 100644
--- a/schedule_timers/c/schedule_timers_c.slsrc
+++ b/schedule_timers/c/schedule_timers_c.slsrc
@@ -1,4 +1,23 @@
-/* Code Disclaimer? */
+/* schedule_timers.c - see http://ultramessaging.github.io/UMExamples/schedule_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
/* =semlit,block,includes=*/
#include
@@ -29,54 +48,54 @@
/* =semlit,endblock,error_check=*/
/* =semlit,block,int_wait=*/
-int wait = 1;
+int wait_flag = 1;
/* =semlit,endblock,int_wait=*/
-/* Timer callback function */
+
/* =semlit,block,timer_cb=*/
+/* Timer callback function */
int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
printf("Timer executed. Set wait to 0 so application can cleanly exit\n");
- wait = 0;
-}
+ wait_flag = 0;
+
+ return 0;
+} /* sample_timer_handler */
/* =semlit,endblock,timer_cb=*/
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
- int timer_id; /* Used to get timer id from schedule API */
+ lbm_context_t *ctx; /* Context object */
+ int timer_id; /* Used to get timer id from schedule API */
+ int err;
/* Initialize context atrributes and create context */
/* =semlit,block,ctx_create=*/
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
/* =semlit,endblock,ctx_create=*/
/* =semlit,block,schedule=*/
- if ((timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000)) == -1) {
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", __FILE__, __LINE__, lbm_errmsg());
- exit(1);
- }
+ /* Be careful! lbm_schedule_timer() returns >0 on success. */
+ timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000);
+ EX_LBM_CHK(timer_id);
/* =semlit,endblock,schedule=*/
/* Now wait for callback to end the wait and close the application */
/* =semlit,block,wait=*/
- while (wait)
+ while (wait_flag)
SLEEP(1);
/* =semlit,endblock,wait=*/
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-}
+ return 0;
+} /* main */
diff --git a/schedule_timers/c/schedule_timers_c.slsrc.html b/schedule_timers/c/schedule_timers_c.slsrc.html
index 71245cc..2c45889 100644
--- a/schedule_timers/c/schedule_timers_c.slsrc.html
+++ b/schedule_timers/c/schedule_timers_c.slsrc.html
@@ -18,61 +18,61 @@
/* schedule_timers.c - see http://ultramessaging.github.io/UMExamples/schedule_timers/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -110,48 +148,48 @@
} \
} while (0)
- int wait = 1;
+ int wait_flag = 1;
- /* Timer callback function */
- int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
+
+ /* Timer callback function */
+ int sample_timer_handler(lbm_context_t *ctx, const void *clientd)
{
printf("Timer executed. Set wait to 0 so application can cleanly exit\n");
- wait = 0;
- }
+ wait_flag = 0;
+
+ return 0;
+ } /* sample_timer_handler */
+
- main()
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- int err; /* Used for checking API return codes */
- int timer_id; /* Used to get timer id from schedule API */
+ lbm_context_t *ctx; /* Context object */
+ int timer_id; /* Used to get timer id from schedule API */
+ int err;
/* Initialize context atrributes and create context */
- err = lbm_context_attr_create(&cattr);
- EX_LBM_CHK(err);
-
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
EX_LBM_CHK(err);
- if ((timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000)) == -1) {
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", __FILE__, __LINE__, lbm_errmsg());
- exit(1);
- }
+ /* Be careful! lbm_schedule_timer() returns >0 on success. */
+ timer_id = lbm_schedule_timer(ctx, sample_timer_handler, NULL, NULL, 1000);
+ EX_LBM_CHK(timer_id);
/* Now wait for callback to end the wait and close the application */
- while (wait)
+ while (wait_flag)
SLEEP(1);
/* Clean up */
err = lbm_context_delete(ctx);
EX_LBM_CHK(err);
-
+
#if defined(_MSC_VER)
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
- }
+ return 0;
+ } /* main */
diff --git a/seq_number_callback/c/seq_number_callback.c b/seq_number_callback/c/seq_number_callback.c
index 89e54da..a93e28a 100644
--- a/seq_number_callback/c/seq_number_callback.c
+++ b/seq_number_callback/c/seq_number_callback.c
@@ -1,4 +1,23 @@
-/* seq_number_callback.c - http://ultramessaging.github.io/UMExamples */
+/* seq_number_callback.c - see http://ultramessaging.github.io/UMExamples/seq_number_callback/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
@@ -17,18 +36,17 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_UME_REGISTRATION_SUCCESS_EX:
{
@@ -39,7 +57,7 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
case LBM_MSG_UME_REGISTRATION_COMPLETE_EX:
- {
+ {
lbm_msg_ume_registration_complete_ex_t *reg = (lbm_msg_ume_registration_complete_ex_t *)(msg->data);
printf("[%s][%s] UME registration complete. SQN %x. Flags %x ",
msg->topic_name, msg->source, reg->sequence_number, reg->flags);
@@ -51,31 +69,35 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
}
return 0;
-}
+} /* rcv_handle_msg */
+
int ume_rcv_seqnum_ex(lbm_ume_rcv_recovery_info_ex_func_info_t *info, void *clientd)
{
- printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n",info->low_sequence_number);
+ printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n", info->low_sequence_number);
printf("info->high_sequence_number[%d] is the highest sequence number available in the persisted stores.\n", info->high_sequence_number);
printf("info->low_rxreq_max_sequence_number[%d] is the lowest sequence number to be requested.\n", info->low_rxreq_max_sequence_number);
-
- /* Overwrite this variable to set a new starting sequence number. If the message is available in the store, then the receiver will
- retransmission starting at this sequence number leading up to the high sequence number. If the new starting sequence number has
- yet to be published, the receiver will discard new messages until this sequence number is sent */
+
+ /* Overwrite this variable to set a new starting sequence number.
+ * If the message is available in the store, then the receiver will
+ * retransmission starting at this sequence number leading up to the
+ * high sequence number. If the new starting sequence number has
+ * yet to be published, the receiver will discard new messages until
+ * this sequence number is sent */
info->low_sequence_number = 100;
return 0;
-}
+} /* ume_rcv_seqnum_ex */
+
-main()
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
lbm_ume_rcv_recovery_info_ex_func_t cb; /* Sequence number info callback function */
- int err; /* Used for checking API return codes */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -102,7 +124,7 @@ main()
EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -119,4 +141,5 @@ main()
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-} /* main */
+ return 0;
+} /* main */
diff --git a/seq_number_callback/c/seq_number_callback.sldoc.html b/seq_number_callback/c/seq_number_callback.sldoc.html
index 3fa6fa8..d59108d 100644
--- a/seq_number_callback/c/seq_number_callback.sldoc.html
+++ b/seq_number_callback/c/seq_number_callback.sldoc.html
@@ -66,8 +66,8 @@
Setting the sequence number info callback requires a callback object to be defined:
-00077 lbm_ume_rcv_recovery_info_ex_func_t cb; /* Sequence number info callback function */
+00099 lbm_ume_rcv_recovery_info_ex_func_t cb; /* Sequence number info callback function */
receiver is starting at the correct sequence number.
-00056 int ume_rcv_seqnum_ex(lbm_ume_rcv_recovery_info_ex_func_info_t *info, void *clientd)
-00057 {
-00058 printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n",info->low_sequence_number);
-00059 printf("info->high_sequence_number[%d] is the highest sequence number available in the persisted stores.\n", info->high_sequence_number);
-00060 printf("info->low_rxreq_max_sequence_number[%d] is the lowest sequence number to be requested.\n", info->low_rxreq_max_sequence_number);
-00061
-00062 /* Overwrite this variable to set a new starting sequence number. If the message is available in the store, then the receiver will
-00063 retransmission starting at this sequence number leading up to the high sequence number. If the new starting sequence number has
-00064 yet to be published, the receiver will discard new messages until this sequence number is sent */
-00065 info->low_sequence_number = 100;
-00066
-00067 return 0;
-00068 }
+00075 int ume_rcv_seqnum_ex(lbm_ume_rcv_recovery_info_ex_func_info_t *info, void *clientd)
+00076 {
+00077 printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n", info->low_sequence_number);
+00078 printf("info->high_sequence_number[%d] is the highest sequence number available in the persisted stores.\n", info->high_sequence_number);
+00079 printf("info->low_rxreq_max_sequence_number[%d] is the lowest sequence number to be requested.\n", info->low_rxreq_max_sequence_number);
+00080
+00081 /* Overwrite this variable to set a new starting sequence number.
+00082 * If the message is available in the store, then the receiver will
+00083 * retransmission starting at this sequence number leading up to the
+00084 * high sequence number. If the new starting sequence number has
+00085 * yet to be published, the receiver will discard new messages until
+00086 * this sequence number is sent */
+00087 info->low_sequence_number = 100;
+00088
+00089 return 0;
+00090 } /* ume_rcv_seqnum_ex */
@@ -136,33 +139,32 @@
Handle Message Callback
for debugging any kind of issues with related to message recovery, connectivity issues, and even performance.
diff --git a/seq_number_callback/c/seq_number_callback_c.slsrc b/seq_number_callback/c/seq_number_callback_c.slsrc
index 9d260bb..8d308ee 100644
--- a/seq_number_callback/c/seq_number_callback_c.slsrc
+++ b/seq_number_callback/c/seq_number_callback_c.slsrc
@@ -1,4 +1,23 @@
-/* seq_number_callback.c - http://ultramessaging.github.io/UMExamples */
+/* seq_number_callback.c - see http://ultramessaging.github.io/UMExamples/seq_number_callback/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
/* =semlit,block,includes=*/
#include
@@ -19,19 +38,18 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
-/* Callback used to handle request message for receiver */
+
/* =semlit,block,handle_msg=*/
+/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
switch (msg->type) {
case LBM_MSG_UME_REGISTRATION_SUCCESS_EX:
{
@@ -42,7 +60,7 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
break;
}
case LBM_MSG_UME_REGISTRATION_COMPLETE_EX:
- {
+ {
lbm_msg_ume_registration_complete_ex_t *reg = (lbm_msg_ume_registration_complete_ex_t *)(msg->data);
printf("[%s][%s] UME registration complete. SQN %x. Flags %x ",
msg->topic_name, msg->source, reg->sequence_number, reg->flags);
@@ -54,36 +72,40 @@ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
}
return 0;
-}
+} /* rcv_handle_msg */
/* =semlit,endblock,handle_msg=*/
+
/* =semlit,block,cb=*/
int ume_rcv_seqnum_ex(lbm_ume_rcv_recovery_info_ex_func_info_t *info, void *clientd)
{
- printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n",info->low_sequence_number);
+ printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n", info->low_sequence_number);
printf("info->high_sequence_number[%d] is the highest sequence number available in the persisted stores.\n", info->high_sequence_number);
printf("info->low_rxreq_max_sequence_number[%d] is the lowest sequence number to be requested.\n", info->low_rxreq_max_sequence_number);
-
- /* Overwrite this variable to set a new starting sequence number. If the message is available in the store, then the receiver will
- retransmission starting at this sequence number leading up to the high sequence number. If the new starting sequence number has
- yet to be published, the receiver will discard new messages until this sequence number is sent */
+
+ /* Overwrite this variable to set a new starting sequence number.
+ * If the message is available in the store, then the receiver will
+ * retransmission starting at this sequence number leading up to the
+ * high sequence number. If the new starting sequence number has
+ * yet to be published, the receiver will discard new messages until
+ * this sequence number is sent */
info->low_sequence_number = 100;
return 0;
-}
+} /* ume_rcv_seqnum_ex */
/* =semlit,endblock,cb=*/
-main()
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
/* =semlit,block,cb_var=*/
lbm_ume_rcv_recovery_info_ex_func_t cb; /* Sequence number info callback function */
/* =semlit,endblock,cb_var=*/
- int err; /* Used for checking API return codes */
+ int err;
/* =semlit,block,windows=*/
#if defined(_WIN32)
@@ -116,7 +138,7 @@ main()
/* =semlit,endblock,cb_attr=*/
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -133,4 +155,5 @@ main()
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
-} /* main */
+ return 0;
+} /* main */
diff --git a/seq_number_callback/c/seq_number_callback_c.slsrc.html b/seq_number_callback/c/seq_number_callback_c.slsrc.html
index cac76ec..f784654 100644
--- a/seq_number_callback/c/seq_number_callback_c.slsrc.html
+++ b/seq_number_callback/c/seq_number_callback_c.slsrc.html
@@ -18,50 +18,50 @@
/* seq_number_callback.c - see http://ultramessaging.github.io/UMExamples/seq_number_callback/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -157,18 +199,17 @@
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
- /* Callback used to handle request message for receiver */
- int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
- {
- int err;
+ /* Callback used to handle request message for receiver */
+ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+ {
switch (msg->type) {
case LBM_MSG_UME_REGISTRATION_SUCCESS_EX:
{
@@ -179,7 +220,7 @@
break;
}
case LBM_MSG_UME_REGISTRATION_COMPLETE_EX:
- {
+ {
lbm_msg_ume_registration_complete_ex_t *reg = (lbm_msg_ume_registration_complete_ex_t *)(msg->data);
printf("[%s][%s] UME registration complete. SQN %x. Flags %x ",
msg->topic_name, msg->source, reg->sequence_number, reg->flags);
@@ -191,31 +232,35 @@
}
return 0;
- }
+ } /* rcv_handle_msg */
+
int ume_rcv_seqnum_ex(lbm_ume_rcv_recovery_info_ex_func_info_t *info, void *clientd)
{
- printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n",info->low_sequence_number);
+ printf("info->low_sequence_number[%d] is the starting sequence number as determined by registration consensus.\n", info->low_sequence_number);
printf("info->high_sequence_number[%d] is the highest sequence number available in the persisted stores.\n", info->high_sequence_number);
printf("info->low_rxreq_max_sequence_number[%d] is the lowest sequence number to be requested.\n", info->low_rxreq_max_sequence_number);
-
- /* Overwrite this variable to set a new starting sequence number. If the message is available in the store, then the receiver will
- retransmission starting at this sequence number leading up to the high sequence number. If the new starting sequence number has
- yet to be published, the receiver will discard new messages until this sequence number is sent */
+
+ /* Overwrite this variable to set a new starting sequence number.
+ * If the message is available in the store, then the receiver will
+ * retransmission starting at this sequence number leading up to the
+ * high sequence number. If the new starting sequence number has
+ * yet to be published, the receiver will discard new messages until
+ * this sequence number is sent */
info->low_sequence_number = 100;
return 0;
- }
+ } /* ume_rcv_seqnum_ex */
+
- main()
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
lbm_ume_rcv_recovery_info_ex_func_t cb; /* Sequence number info callback function */
- int err; /* Used for checking API return codes */
+ int err;
#if defined(_WIN32)
/* windows-specific code */
@@ -242,7 +287,7 @@
EX_LBM_CHK(err);
err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
- EX_LBM_CHK(err);
+ EX_LBM_CHK(err);
err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
EX_LBM_CHK(err);
@@ -259,7 +304,8 @@
/* Windows-specific cleanup overhead */
WSACleanup();
#endif
- } /* main */
+ return 0;
+ } /* main */
diff --git a/sequential_mode/c/sequential_mode.c b/sequential_mode/c/sequential_mode.c
index 61c6d4a..0fd880c 100644
--- a/sequential_mode/c/sequential_mode.c
+++ b/sequential_mode/c/sequential_mode.c
@@ -1,6 +1,26 @@
-/* Code Disclaimer? */
+/* sequential_mode.c - see http://ultramessaging.github.io/UMExamples/sequential_mode/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include
+#include
#if defined(_MSC_VER)
/* Windows-only includes */
@@ -15,6 +35,15 @@
#include
+/* Example error checking macro. Include after each UM call. */
+#define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+} while (0)
+
#if defined(_WIN32)
DWORD WINAPI seq_thread(void *arg)
@@ -23,59 +52,47 @@ void *seq_thread(void *arg)
#endif /* _WIN32 */
{
lbm_context_t *ctx = (lbm_context_t *) arg;
+ int err;
while (1)
{
- if (lbm_context_process_events(ctx, 500) == -1)
- {
- printf("ERROR processing context events: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_process_events(ctx, 500);
+ EX_LBM_CHK(err);
}
-}
+} /* seq_thread */
+
-main()
+int main(int argc, char **argv)
{
lbm_context_t *ctx; /* pointer to context object */
lbm_context_attr_t * cattr; /* pointer to context attribute object */
- int err; /* return status of lbm functions (true=error) */
+ int err;
#if defined(_WIN32)
- HANDLE wthrdh;
+ HANDLE wthrdh;
#else
- pthread_t pthids;
+ pthread_t pthids;
#endif /* _WIN32 */
-
#if defined(_MSC_VER)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
-#endif
-
- if (lbm_context_attr_create(&cattr) != 0)
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
{
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
exit(1);
}
+#endif
+
+ err = lbm_context_attr_create(&cattr);
+ EX_LBM_CHK(err);
/* Setting the resolver address using the string method */
- if (lbm_context_attr_str_setopt(cattr, "operational_mode", "sequential") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:operational_mode: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_str_setopt(cattr, "operational_mode", "sequential");
+ EX_LBM_CHK(err);
- err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_create(&ctx, cattr, NULL, NULL);
+ EX_LBM_CHK(err);
#if defined(_WIN32)
if ((wthrdh = CreateThread(NULL, 0, seq_thread, ctx, 0, NULL)) == NULL) {
@@ -89,7 +106,8 @@ main()
}
#endif /* _WIN32 */
- /* Wait forever */
+ /* Wait forever (or until control-c). */
while (1) { }
-}
+ return 0;
+} /* main */
diff --git a/sequential_mode/c/sequential_mode.sldoc.html b/sequential_mode/c/sequential_mode.sldoc.html
index 11d8657..f6a780c 100644
--- a/sequential_mode/c/sequential_mode.sldoc.html
+++ b/sequential_mode/c/sequential_mode.sldoc.html
@@ -53,25 +53,15 @@
Initialize and Create Context
Setting the operational_mode is required to take advantage of the sequential mode of operation.
Declaring these two variables to be used while setting the topic resolution port and LBTRM destination port
-00028 lbm_uint16_t res_port; /* Int to set resolver port */
-00029 lbm_uint16_t des_port; /* Int to set lbtrm destination port */
+00057 lbm_uint16_t res_port; /* Int to set resolver port */
+00058 lbm_uint16_t des_port; /* Int to set lbtrm destination port */
@@ -53,12 +53,9 @@
Initialize Context Attributes
is created.
-00043 /* Initialize the defaults for the context attribute object */
-00044 if (lbm_context_attr_create(&cattr) != 0)
-00045 {
-00046 fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
-00047 exit(1);
-00048 }
+00072 /* Initialize the defaults for the context attribute object */
+00073 err = lbm_context_attr_create(&cattr);
+00074 EX_LBM_CHK(err);
@@ -76,12 +73,9 @@
Setting Context Attribute using the String Method
which configures this applications topic resolution multicast address using the string method.
-00050 /* Setting the resolver address using the string method */
-00051 if (lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12") != 0)
-00052 {
-00053 fprintf(stderr, "lbm_context_attr_str_setopt:resolver_multicast_address: %s\n", lbm_errmsg());
-00054 exit(1);
-00055 }
+00076 /* Setting the resolver address using the string method */
+00077 err = lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12");
+00078 EX_LBM_CHK(err);
@@ -99,13 +93,10 @@
Setting Context Attributes using the Data Type Method
defined previously will use.
-00057 /* Setting the resolver port using the data-type value method */
-00058 res_port = 12345;
-00059 if (lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t)) != 0 )
-00060 {
-00061 fprintf(stderr, "lbm_context_attr_setopt:resolver_mutlicast_port: %s\n", lbm_errmsg());
-00062 exit(1);
-00063 }
+00080 /* Setting the resolver port using the data-type value method */
+00081 res_port = 12345;
+00082 err = lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t));
+00083 EX_LBM_CHK(err);
@@ -113,13 +104,9 @@
Create the Context Using the Attributes
Now create the context using the attributes that were just previously configured. Notice the attributes object as the second parameter
-00083 /* Setting the transport via the source topic string method */
-00084 if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0 )
-00085 {
-00086 fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
-00087 exit(1);
-00088 }
+00096 /* Setting the transport via the source topic string method */
+00097 err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+00098 EX_LBM_CHK(err);
@@ -185,13 +166,10 @@
Setting Source Attribute via Data Type
-00090 /* Setting the lbtrm destination port via the direct value set method */
-00091 des_port = 14001;
-00092 if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0 )
-00093 {
-00094 fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
-00095 exit(1);
-00096 }
+00100 /* Setting the lbtrm destination port via the direct value set method */
+00101 des_port = 14001;
+00102 err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+00103 EX_LBM_CHK(err);
second attribute object. After the copy, alterations can be made prior to the creation of the second source
-00114 /* Initialized the second source attributes as a copy of the first */
-00115 if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0 )
-00116 {
-00117 fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
-00118 exit(1);
-00119 }
+00113 /* Initialized the second source attributes as a copy of the first */
+00114 err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+00115 EX_LBM_CHK(err);
@@ -254,13 +221,11 @@
Change the Multicast Port
-00121 /* Now modify the destination port for this second source to put the publisher on a different transport */
-00122 des_port = 14002;
-00123 if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0 )
-00124 {
-00125 fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
-00126 exit(1);
-00127 }
+00117 /* Now modify the destination port for this second source to put the
+00118 * publisher on a different transport. */
+00119 des_port = 14002;
+00120 err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+00121 EX_LBM_CHK(err);
@@ -268,21 +233,13 @@
Allocate and Create test.topic.2
Just like previously done for the first publisher, allocate the topic with the configured attributes and create the source
Deleting the source attribute objects is a good best practice
-00145 /* Delete the first and second source topic attribute objects */
-00146 lbm_src_topic_attr_delete(tattr_1);
-00147 lbm_src_topic_attr_delete(tattr_2);
+00131 /* Delete the first and second source topic attribute objects */
+00132 err = lbm_src_topic_attr_delete(tattr_1);
+00133 EX_LBM_CHK(err);
+00134 err = lbm_src_topic_attr_delete(tattr_2);
+00135 EX_LBM_CHK(err);
@@ -301,10 +260,13 @@
Delete the Sources and Context
before deleting the context
-00149 /* Finished with all LBM functions, delete the source and context object. */
-00150 lbm_src_delete(src_1);
-00151 lbm_src_delete(src_2);
-00152 lbm_context_delete(ctx);
+00137 /* Finished with all LBM functions, delete the source and context object. */
+00138 err = lbm_src_delete(src_1);
+00139 EX_LBM_CHK(err);
+00140 err = lbm_src_delete(src_2);
+00141 EX_LBM_CHK(err);
+00142 err = lbm_context_delete(ctx);
+00143 EX_LBM_CHK(err);
@@ -312,20 +274,20 @@
Includes
Include files for this application. Notice the Windows specific include files - these are not necessary for Linux only applications
/* Example on setting Ultra Messaging attributes */
+00149
+
/* setting_attributes.c - see http://ultramessaging.github.io/UMExamples/setting_attributes/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
#include <stdio.h>
@@ -191,7 +201,17 @@
#include <lbm/lbm.h>
- main()
+ /* Example error checking macro. Include after each UM call. */
+ #define EX_LBM_CHK(err) do { \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
+ } while (0)
+
+
+ int main(int argc, char **argv)
{
lbm_context_t *ctx; /* pointer to context object */
lbm_topic_t *topic_1; /* pointer to topic object */
@@ -203,7 +223,7 @@
lbm_context_attr_t * cattr; /* pointer to context attribute object */
lbm_uint16_t res_port; /* Int to set resolver port */
lbm_uint16_t des_port; /* Int to set lbtrm destination port */
- int err; /* return status of lbm functions (true=error) */
+ int err;
#if defined(_MSC_VER)
/* windows-specific code */
@@ -217,121 +237,83 @@
#endif
/* Initialize the defaults for the context attribute object */
- if (lbm_context_attr_create(&cattr) != 0)
- {
- fprintf(stderr, "lbm_context_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_create(&cattr);
+ EX_LBM_CHK(err);
/* Setting the resolver address using the string method */
- if (lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12") != 0)
- {
- fprintf(stderr, "lbm_context_attr_str_setopt:resolver_multicast_address: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_str_setopt(cattr, "resolver_multicast_address", "224.10.11.12");
+ EX_LBM_CHK(err);
/* Setting the resolver port using the data-type value method */
res_port = 12345;
- if (lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t)) != 0 )
- {
- fprintf(stderr, "lbm_context_attr_setopt:resolver_mutlicast_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_context_attr_setopt(cattr, "resolver_multicast_port", &res_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Creating the context */
err = lbm_context_create(&ctx, cattr, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Delete the context attribute object */
- lbm_context_attr_delete(cattr);
+ err = lbm_context_attr_delete(cattr);
+ EX_LBM_CHK(err);
/* Initializing the source attribute object */
- if (lbm_src_topic_attr_create(&tattr_1) != 0)
- {
- fprintf(stderr, "lbm_src_topic_attr_create: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_create(&tattr_1);
/* Setting the transport via the source topic string method */
- if (lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm") != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_str_setopt:transport: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_str_setopt(tattr_1, "transport", "lbtrm");
+ EX_LBM_CHK(err);
/* Setting the lbtrm destination port via the direct value set method */
des_port = 14001;
- if (lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_1, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the topic */
err = lbm_src_topic_alloc(&topic_1, ctx, "test.topic.1", tattr_1);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_1, ctx, topic_1, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Initialized the second source attributes as a copy of the first */
- if (lbm_src_topic_attr_dup(&tattr_2, tattr_1) != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_dup: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_dup(&tattr_2, tattr_1);
+ EX_LBM_CHK(err);
- /* Now modify the destination port for this second source to put the publisher on a different transport */
+ /* Now modify the destination port for this second source to put the
+ * publisher on a different transport. */
des_port = 14002;
- if (lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t)) != 0 )
- {
- fprintf(stderr, "lbm_src_topic_attr_setopt:transport_lbtrm_destination_port: %s\n", lbm_errmsg());
- exit(1);
- }
+ err = lbm_src_topic_attr_setopt(tattr_2, "transport_lbtrm_destination_port", &des_port, sizeof(lbm_uint16_t));
+ EX_LBM_CHK(err);
/* Allocating the second topic */
err = lbm_src_topic_alloc(&topic_2, ctx, "test.topic.2", tattr_2);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Creating the source */
err = lbm_src_create(&src_2, ctx, topic_2, NULL, NULL, NULL);
- if (err)
- {
- printf("line %d: %s\n", __LINE__, lbm_errmsg());
- exit(1);
- }
+ EX_LBM_CHK(err);
/* Delete the first and second source topic attribute objects */
- lbm_src_topic_attr_delete(tattr_1);
- lbm_src_topic_attr_delete(tattr_2);
+ err = lbm_src_topic_attr_delete(tattr_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_topic_attr_delete(tattr_2);
+ EX_LBM_CHK(err);
/* Finished with all LBM functions, delete the source and context object. */
- lbm_src_delete(src_1);
- lbm_src_delete(src_2);
- lbm_context_delete(ctx);
+ err = lbm_src_delete(src_1);
+ EX_LBM_CHK(err);
+ err = lbm_src_delete(src_2);
+ EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
WSACleanup();
#endif
- }
-
+ return 0;
+ } /* main */
diff --git a/source_create/c/source_create_c.slsrc b/source_create/c/source_create_c.slsrc
index 03ef0ad..60bb422 100644
--- a/source_create/c/source_create_c.slsrc
+++ b/source_create/c/source_create_c.slsrc
@@ -17,7 +17,7 @@
#include
/* =semlit,endblock,includes=*/
-main()
+int main(int argc, char **argv)
{
/* =semlit,block,variables=*/
lbm_context_t *ctx; /* Context object */
@@ -101,5 +101,6 @@ main()
#if defined(_MSC_VER)
WSACleanup();
#endif
+ return 0;
}
diff --git a/source_notify_callbacks/c/source_notify_callbacks.c b/source_notify_callbacks/c/source_notify_callbacks.c
index 0c8712f..0ee081b 100644
--- a/source_notify_callbacks/c/source_notify_callbacks.c
+++ b/source_notify_callbacks/c/source_notify_callbacks.c
@@ -1,4 +1,24 @@
-/* source_notify_callback.c - http://ultramessaging.github.io/UMExamples */
+/* source_notify_callbacks.c - see http://ultramessaging.github.io/UMExamples/source_notify_callbacks/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
+
#include
#if defined(_MSC_VER)
@@ -13,98 +33,117 @@
#endif
#include
+/* State structure associated with each source the receiver is joined to. */
+typedef struct source_state_s {
+ int msgs_rcvd; /* Track message count from each source. */
+} source_state_t;
+
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
-int new_src_notification_callback(const char *source_name, void *clientd)
+
+void *new_src_notification_callback(const char *source_name, void *clientd)
{
- printf("Delivery Controller Created: %s\n", source_name);
- return 0;
-}
+ source_state_t *source_state = (source_state_t *)malloc(sizeof(source_state_t));
+ source_state->msgs_rcvd = 0;
+
+ printf("Delivery Controller Created: %s\n", source_name);
+ return source_state; /* This will be available in the receive callback as msg->source_clientd. */
+} /* new_src_notification_callback */
+
int src_delete_notification_callback(const char *source_name, void *clientd, void* src_clientd )
{
- printf("Delivery Controller Deleted: %s\n", source_name);
- return 0;
-}
+ free(src_clientd); /* This was created by new_src_notification_callback() */
+
+ printf("Delivery Controller Deleted: %s\n", source_name);
+ return 0;
+} /* src_delete_notification_callback */
+
/* Callback used to handle request message for receiver */
int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
-
- switch (msg->type) {
- case LBM_MSG_BOS:
- printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
- break;
- case LBM_MSG_EOS:
- printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
- break;
- default:
- printf("Other event, type=%x\n", msg->type);
- break;
- }
-
- return 0;
-}
-
-main()
+ source_state_t *source_state = (source_state_t *)msg->source_clientd;
+
+ switch (msg->type) {
+ case LBM_MSG_DATA:
+ source_state->msgs_rcvd ++;
+ printf("[%s][%s], Received message %d\n", msg->topic_name, msg->source, source_state->msgs_rcvd);
+ break;
+ case LBM_MSG_BOS:
+ printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
+ break;
+ case LBM_MSG_EOS:
+ printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
+ break;
+ default:
+ printf("Other event, type=%x\n", msg->type);
+ break;
+ }
+
+ return 0;
+} /* rcv_handle_msg */
+
+
+int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
- lbm_rcv_src_notification_func_t srccb; /* Source notify callback structure */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ lbm_rcv_src_notification_func_t srccb; /* Source notify callback structure */
+ int err;
#if defined(_WIN32)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
- /* Initialize context atrributes and create context */
- err = lbm_context_create(&ctx, NULL, NULL, NULL);
- EX_LBM_CHK(err);
+ /* Initialize context atrributes and create context */
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
- /* Create receiver for receiving request and sending response */
- err = lbm_rcv_topic_attr_create(&rattr);
- EX_LBM_CHK(err);
+ /* Create receiver for receiving request and sending response */
+ err = lbm_rcv_topic_attr_create(&rattr);
+ EX_LBM_CHK(err);
- srccb.create_func = new_src_notification_callback;
- srccb.delete_func = src_delete_notification_callback;
+ srccb.create_func = new_src_notification_callback;
+ srccb.delete_func = src_delete_notification_callback;
- err = lbm_rcv_topic_attr_setopt(rattr, "source_notification_function", &srccb, sizeof(srccb));
- EX_LBM_CHK(err);
+ err = lbm_rcv_topic_attr_setopt(rattr, "source_notification_function", &srccb, sizeof(srccb));
+ EX_LBM_CHK(err);
- err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
+ err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
EX_LBM_CHK(err);
- err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
- EX_LBM_CHK(err);
+ err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
+ EX_LBM_CHK(err);
- while (1) { }
+ /* Wait forever (or until control-c). */
+ while (1) { }
- err = lbm_rcv_delete(rcv);
- EX_LBM_CHK(err);
+ err = lbm_rcv_delete(rcv);
+ EX_LBM_CHK(err);
- err = lbm_context_delete(ctx);
- EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
- /* Windows-specific cleanup overhead */
- WSACleanup();
+ /* Windows-specific cleanup overhead */
+ WSACleanup();
#endif
+ return 0;
} /* main */
diff --git a/source_notify_callbacks/c/source_notify_callbacks.sldoc b/source_notify_callbacks/c/source_notify_callbacks.sldoc
index fdabebe..4391a5c 100644
--- a/source_notify_callbacks/c/source_notify_callbacks.sldoc
+++ b/source_notify_callbacks/c/source_notify_callbacks.sldoc
@@ -12,11 +12,18 @@
Program explanation: source_notify_callbacks.c
+
Per-source State Information
+
As new sources are discovered for the receiver, the user wants to create and maintain some state information
+ associated with that source. In this simple example, just keep a per-source count of messages received.
+ =semlit,insert,state=
Delivery Controller Create Callback
Here the user callback for the delivery controller being created is defined. This function will execute every
time a source is detected (when a source's topic advertisement is received by the receiver's context) that the
- receiver is interested in. This callback will execute before a BOS would because BOS required data on the transport
- to be received, unlike this function which just requires a TIR on an interested source.
+ receiver is interested in.
+ UM expects the function to return a pointer to the state information, which
+ will subsequently be passed to the receive callback as msg->source_clientd.
+ This callback will execute before a BOS would because BOS required data on the transport
+ to be received, unlike this function which just requires a TIR on an interested source.
=semlit,insert,create_cb=
Delivery Controller Delete Callback
This is the user callback for when the delivery controller is deleted. A delivery controller would be deleted
diff --git a/source_notify_callbacks/c/source_notify_callbacks.sldoc.html b/source_notify_callbacks/c/source_notify_callbacks.sldoc.html
index e28f56c..7d0644a 100644
--- a/source_notify_callbacks/c/source_notify_callbacks.sldoc.html
+++ b/source_notify_callbacks/c/source_notify_callbacks.sldoc.html
@@ -7,7 +7,8 @@
Example index
Receiver Source Notification Callbacks (Create and Delete)
This example demonstrates how to configure and code the callbacks for when a receiver creates and deletes a
- delivery controller for a specific source.
+ delivery controller for a specific source. This is typically done in support of maintaining per-source
+ state information.
Like many other callback function in UM, the source notification is configured via a receiver attribute,
+
+00036 /* State structure associated with each source the receiver is joined to. */
+00037 typedef struct source_state_s {
+00038 int msgs_rcvd; /* Track message count from each source. */
+00039 } source_state_t;
+
+
+
Delivery Controller Create Callback
Here the user callback for the delivery controller being created is defined. This function will execute every
time a source is detected (when a source's topic advertisement is received by the receiver's context) that the
- receiver is interested in. This callback will execute before a BOS would because BOS required data on the transport
- to be received, unlike this function which just requires a TIR on an interested source.
+ receiver is interested in.
+ UM expects the function to return a pointer to the state information, which
+ will subsequently be passed to the receive callback as msg->source_clientd.
+ This callback will execute before a BOS would because BOS required data on the transport
+ to be received, unlike this function which just requires a TIR on an interested source.
-00025 int new_src_notification_callback(const char *source_name, void *clientd)
-00026 {
-00027 printf("Delivery Controller Created: %s\n", source_name);
-00028 return 0;
-00029 }
+00051 void *new_src_notification_callback(const char *source_name, void *clientd)
+00052 {
+00053 source_state_t *source_state = (source_state_t *)malloc(sizeof(source_state_t));
+00054 source_state->msgs_rcvd = 0;
+00055
+00056 printf("Delivery Controller Created: %s\n", source_name);
+00057 return source_state; /* This will be available in the receive callback as msg->source_clientd. */
+00058 } /* new_src_notification_callback */
@@ -65,11 +83,13 @@
Delivery Controller Delete Callback
to rely on this callback versus EOS, because this callback is guaranteed if no data has been received for the topic.
-00031 int src_delete_notification_callback(const char *source_name, void *clientd, void* src_clientd )
-00032 {
-00033 printf("Delivery Controller Deleted: %s\n", source_name);
-00034 return 0;
-00035 }
+00061 int src_delete_notification_callback(const char *source_name, void *clientd, void* src_clientd )
+00062 {
+00063 free(src_clientd); /* This was created by new_src_notification_callback() */
+00064
+00065 printf("Delivery Controller Deleted: %s\n", source_name);
+00066 return 0;
+00067 } /* src_delete_notification_callback */
@@ -77,24 +97,29 @@
Standard Receive Callback
This is the standard receiver callback where messages are processed, as well as events like BOS and EOS
-00038 int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
-00039 {
-00040 int err;
-00041
-00042 switch (msg->type) {
-00043 case LBM_MSG_BOS:
-00044 printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
-00045 break;
-00046 case LBM_MSG_EOS:
-00047 printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
-00048 break;
-00049 default:
-00050 printf("Other event, type=%x\n", msg->type);
-00051 break;
-00052 }
-00053
-00054 return 0;
-00055 }
+00070 /* Callback used to handle request message for receiver */
+00071 int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+00072 {
+00073 source_state_t *source_state = (source_state_t *)msg->source_clientd;
+00074
+00075 switch (msg->type) {
+00076 case LBM_MSG_DATA:
+00077 source_state->msgs_rcvd ++;
+00078 printf("[%s][%s], Received message %d\n", msg->topic_name, msg->source, source_state->msgs_rcvd);
+00079 break;
+00080 case LBM_MSG_BOS:
+00081 printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
+00082 break;
+00083 case LBM_MSG_EOS:
+00084 printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
+00085 break;
+00086 default:
+00087 printf("Other event, type=%x\n", msg->type);
+00088 break;
+00089 }
+00090
+00091 return 0;
+00092 } /* rcv_handle_msg */
@@ -112,7 +137,7 @@
Declare Notify Structure
must be used to set the user callbacks which have been defined above.
/* source_notify_callbacks.c - see http://ultramessaging.github.io/UMExamples/source_notify_callbacks/c/index.html
+ *
+ * Copyright (c) 2005-2017 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
+
#include <stdio.h>
#if defined(_MSC_VER)
@@ -141,100 +200,119 @@
#endif
#include <lbm/lbm.h>
+ /* State structure associated with each source the receiver is joined to. */
+ typedef struct source_state_s {
+ int msgs_rcvd; /* Track message count from each source. */
+ } source_state_t;
+
/* Example error checking macro. Include after each UM call. */
#define EX_LBM_CHK(err) do { \
- if ((err) < 0) { \
- fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
- __FILE__, __LINE__, lbm_errmsg()); \
- exit(1); \
- } \
+ if ((err) < 0) { \
+ fprintf(stderr, "%s:%d, lbm error: '%s'\n", \
+ __FILE__, __LINE__, lbm_errmsg()); \
+ exit(1); \
+ } \
} while (0)
- int new_src_notification_callback(const char *source_name, void *clientd)
+
+ void *new_src_notification_callback(const char *source_name, void *clientd)
{
- printf("Delivery Controller Created: %s\n", source_name);
- return 0;
- }
+ source_state_t *source_state = (source_state_t *)malloc(sizeof(source_state_t));
+ source_state->msgs_rcvd = 0;
+
+ printf("Delivery Controller Created: %s\n", source_name);
+ return source_state; /* This will be available in the receive callback as msg->source_clientd. */
+ } /* new_src_notification_callback */
+
int src_delete_notification_callback(const char *source_name, void *clientd, void* src_clientd )
{
- printf("Delivery Controller Deleted: %s\n", source_name);
- return 0;
- }
+ free(src_clientd); /* This was created by new_src_notification_callback() */
+
+ printf("Delivery Controller Deleted: %s\n", source_name);
+ return 0;
+ } /* src_delete_notification_callback */
+
- /* Callback used to handle request message for receiver */
- int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+ /* Callback used to handle request message for receiver */
+ int rcv_handle_msg(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
{
- int err;
+ source_state_t *source_state = (source_state_t *)msg->source_clientd;
- switch (msg->type) {
- case LBM_MSG_BOS:
- printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
- break;
- case LBM_MSG_EOS:
- printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
- break;
- default:
- printf("Other event, type=%x\n", msg->type);
- break;
- }
+ switch (msg->type) {
+ case LBM_MSG_DATA:
+ source_state->msgs_rcvd ++;
+ printf("[%s][%s], Received message %d\n", msg->topic_name, msg->source, source_state->msgs_rcvd);
+ break;
+ case LBM_MSG_BOS:
+ printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
+ break;
+ case LBM_MSG_EOS:
+ printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
+ break;
+ default:
+ printf("Other event, type=%x\n", msg->type);
+ break;
+ }
- return 0;
- }
+ return 0;
+ } /* rcv_handle_msg */
- main()
+
+ int main(int argc, char **argv)
{
- lbm_context_t *ctx; /* Context object */
- lbm_context_attr_t * cattr; /* Context attribute object */
- lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
- lbm_topic_t *rtopic; /* Receiver Topic object */
- lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
- lbm_rcv_src_notification_func_t srccb; /* Source notify callback structure */
- int err; /* Used for checking API return codes */
+ lbm_context_t *ctx; /* Context object */
+ lbm_rcv_t *rcv; /* Receive object: for subscribing to messages. */
+ lbm_topic_t *rtopic; /* Receiver Topic object */
+ lbm_rcv_topic_attr_t * rattr; /* Receiver attribute object */
+ lbm_rcv_src_notification_func_t srccb; /* Source notify callback structure */
+ int err;
#if defined(_WIN32)
- /* windows-specific code */
- WSADATA wsadata;
- int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
- if (wsStat != 0)
- {
- printf("line %d: wsStat=%d\n",__LINE__,wsStat);
- exit(1);
- }
+ /* windows-specific code */
+ WSADATA wsadata;
+ int wsStat = WSAStartup(MAKEWORD(2,2), &wsadata);
+ if (wsStat != 0)
+ {
+ printf("line %d: wsStat=%d\n",__LINE__,wsStat);
+ exit(1);
+ }
#endif
- /* Initialize context atrributes and create context */
- err = lbm_context_create(&ctx, NULL, NULL, NULL);
- EX_LBM_CHK(err);
+ /* Initialize context atrributes and create context */
+ err = lbm_context_create(&ctx, NULL, NULL, NULL);
+ EX_LBM_CHK(err);
- /* Create receiver for receiving request and sending response */
- err = lbm_rcv_topic_attr_create(&rattr);
- EX_LBM_CHK(err);
+ /* Create receiver for receiving request and sending response */
+ err = lbm_rcv_topic_attr_create(&rattr);
+ EX_LBM_CHK(err);
- srccb.create_func = new_src_notification_callback;
- srccb.delete_func = src_delete_notification_callback;
+ srccb.create_func = new_src_notification_callback;
+ srccb.delete_func = src_delete_notification_callback;
- err = lbm_rcv_topic_attr_setopt(rattr, "source_notification_function", &srccb, sizeof(srccb));
- EX_LBM_CHK(err);
+ err = lbm_rcv_topic_attr_setopt(rattr, "source_notification_function", &srccb, sizeof(srccb));
+ EX_LBM_CHK(err);
- err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
+ err = lbm_rcv_topic_lookup(&rtopic, ctx, "test.topic", rattr);
EX_LBM_CHK(err);
- err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
- EX_LBM_CHK(err);
+ err = lbm_rcv_create(&rcv, ctx, rtopic, rcv_handle_msg, NULL, NULL);
+ EX_LBM_CHK(err);
- while (1) { }
+ /* Wait forever (or until control-c). */
+ while (1) { }
- err = lbm_rcv_delete(rcv);
- EX_LBM_CHK(err);
+ err = lbm_rcv_delete(rcv);
+ EX_LBM_CHK(err);
- err = lbm_context_delete(ctx);
- EX_LBM_CHK(err);
+ err = lbm_context_delete(ctx);
+ EX_LBM_CHK(err);
#if defined(_MSC_VER)
- /* Windows-specific cleanup overhead */
- WSACleanup();
+ /* Windows-specific cleanup overhead */
+ WSACleanup();
#endif
+ return 0;
} /* main */
diff --git a/source_notify_callbacks/dotnet/source_notify_callbacks.sldoc.html b/source_notify_callbacks/dotnet/source_notify_callbacks.sldoc.html
index d51fa29..dc3a112 100644
--- a/source_notify_callbacks/dotnet/source_notify_callbacks.sldoc.html
+++ b/source_notify_callbacks/dotnet/source_notify_callbacks.sldoc.html
@@ -7,7 +7,8 @@
Example index
Receiver Source Notification Callbacks (Create and Delete)
This example demonstrates how to configure and code the callbacks for when a receiver creates and deletes a
- delivery controller for a specific source.
+ delivery controller for a specific source. This is typically done in support of maintaining per-source
+ state information.
Like many other callback function in UM, the source notification is configured via a receiver attribute,
Example index
Receiver Source Notification Callbacks (Create and Delete)
This example demonstrates how to configure and code the callbacks for when a receiver creates and deletes a
- delivery controller for a specific source.
+ delivery controller for a specific source. This is typically done in support of maintaining per-source
+ state information.
Like many other callback function in UM, the source notification is configured via a receiver attribute,
=semlit,tooltip,../../tooltips/receiver_source_notification_function.txt,source_notification_function=which
must be set programatically so that the appropriate function pointers can be provided.
@@ -19,5 +20,4 @@
to help debug networking issues. However, this callback is not great at telling the application that a specific topic
ready to start receiving messages. Instead, the application can use the source_notification_callback which is
demonstrated in this sample application. The source_notification_callback can enable a user callback to be executed
- when delivery controller is created for a topic and a separate callback for when a delivery controller is deleted.
-
+ when delivery controller is created for a topic and a separate callback for when a delivery controller is deleted.
diff --git a/source_notify_callbacks/java/source_notify_callbacks.sldoc.html b/source_notify_callbacks/java/source_notify_callbacks.sldoc.html
index 2ff05a8..5b3227d 100644
--- a/source_notify_callbacks/java/source_notify_callbacks.sldoc.html
+++ b/source_notify_callbacks/java/source_notify_callbacks.sldoc.html
@@ -7,7 +7,8 @@
Example index
Receiver Source Notification Callbacks (Create and Delete)
This example demonstrates how to configure and code the callbacks for when a receiver creates and deletes a
- delivery controller for a specific source.
+ delivery controller for a specific source. This is typically done in support of maintaining per-source
+ state information.
diff --git a/src_rsp/c/src_rsp.sldoc b/src_rsp/c/src_rsp.sldoc
new file mode 100644
index 0000000..a98ef37
--- /dev/null
+++ b/src_rsp/c/src_rsp.sldoc
@@ -0,0 +1,197 @@
+
+
+
+ Source-based Request/Response
+
+
+ Example index
+
+
How to use sources to send requests and responses.
+
+
There are two source files associated with this example:
+
+
=semlit,srcfile,client_c.slsrc,client.c=
+ - (right-click and save as "client.c").
+
=semlit,srcfile,server_c.slsrc,server.c=
+ - (right-click and save as "server.c").
+
+
+
The UM "request/response" feature provides a convenient, easy-to-code
+ method for a classic server program to respond to a request sent by a client.
+ The feature takes care of routing the server's response message back to
+ the client that sent the request.
+ It also associates response messages with the corresponding request
+ messages, even if multiple messages are outstanding.
+ See Request-Response Sample.
+
+
However, there are advantages for the server to use a normal UM
+ source to send response messages:
+
+
Choice of transport types.
+ UM responses are always sent with TCP.
+
+
Reliability settings for non-TCP transports are under user control.
+ Can be configured to recover messages after long network outages.
+
+
Extra layer of reliability.
+ The "OTR" feature can recover messages unrecoverably lost by the
+ transport.
+ Also, the source can be made persistent for even greater reliability.
+
+
Better application visibility.
+ Receivers get BOS, EOS, and unrecoverable loss events, and for
+ unicast transport types, sources get connect and disconnect events.
+
+
UDP-based transport types can give lower latency.
+
+
+
This sample program uses an LBT-RU source to return response messages
+ to the requesting client program.
+
+
Overall Approach
+
+
Clients use a UM source to send a request to a server, and the server
+ uses a UM receiver to receive it.
+ The server then uses a UM source to send a response back to only the
+ client that sent the request, and that client uses a UM receiver to
+ receive it.
+ This sample allows and arbitrary number of client programs to come and
+ go, without the server being pre-configured to know about them.
+
+
When a client program initializes, it creates a source to send
+ requests and a receiver to receive responses.
+ The client then exchanges handshakes with the server to register with it,
+ and to verify round-trip connectivity.
+ This verification avoids initial message loss during topic resolution.
+
+
Registration
+
+
The client uses the server's well-known request topic to create
+ the source.
+
+ =semlit,insert,server_name=
+
. . .
+ =semlit,insert,req_src_create=
+
+
The client needs a unique topic to receive is responses.
+ Using the process PID is an easy, but non-robust method (two
+ clients on different machines can have the same PID).
+
+ =semlit,insert,client_name=
+
. . .
+ =semlit,insert,rsp_rcv_create=
+
+
Registration: Client Side
+
+
The registration message that the client sends to the server is
+ all-ascii, consisting of lower-case 'r' followed by a null-terminated
+ topic name on which the client receives responses.
+
+ =semlit,insert,register_msg=
+
+
The client sends registration messages repeatedly in a loop, with
+ exponential backoff delays.
+ For example, if the server is not running, the client sends registration
+ attempts at 1, 2, 4, 8, ... milliseconds, to a maximum of 1 second.
+
+ =semlit,insert,register_loop=
+
+
The loop exits when the client receives a registration response.
+
+ =semlit,insert,register_done=
+
+
Registration: Server Side
+
+
The server makes use of source notification create/delete callbacks
+ to manage client state.
+ The callbacks are configured as part of creation of the server's
+ main receiver.
+
+ =semlit,insert,src_notif_setopt=
+
+
Then, when the receiver discovers a new client's source,
+ start_client_source() is called.
+ That function only creates the state structure associated with the
+ new client.
+
+ =semlit,insert,start_client=
+
+
When the client sends its registration message, it is received by
+ the server, which uses it to create the source used for sending
+ responses.
+ The state structure created above is passed to the receiver
+ callback in msg->source_clientd.
+
+ =semlit,insert,do_reg0=
+
+
Registration requests start with the character 'r'.
+
+ =semlit,insert,do_reg1=
+
. . .
+ =semlit,insert,do_reg2=
+
+
The response source is created in a special way.
+ It is an LBT-RU transport type, with a fixed port number (the choice
+ of 12070 was arbitrary).
+ This means that all clients' sources are mapped to the same LBT-RU
+ transport session.
+
+ =semlit,insert,rsp_src_config=
+
+
To prevent each client's responses from being sent to all clients,
+ source-side filtering is enabled.
+
+ =semlit,insert,rsp_src_config2=
+
+
On successful source creation, the client state is filled in.
+ But no reply is sent to the client.
+ This is because the client has not yet had a chance to discover and
+ join the new source, so any message sent at this point would not
+ be delivered.
+
+ =semlit,insert,rsp_src_created=
+
+
The server could set some kind of timer to send its reply, but
+ to simplify this code, we just wait for the client to retry.
+ When the next registration request comes in, we send the OK
+ message.
+ Thus, it will always take at least 2 tries to register.
+
+ =semlit,insert,rsp_src_ok=
+
+
Request/Response
+
+
This example does not contain the code necessary to associate responses
+ with their requests.
+ However, the simple protocol was designed to allow this to be added.
+ A request message consists of an 8-ascii-byte header followed by the
+ application message content.
+ The first byte of the header is the character 'R' to indicate a request
+ message.
+ The other 7 bytes are currently just set to ascii '0' characters, but
+ could be used as a request ID.
+ When the server responds to requests, it uses the same header it
+ received, so the client can maintain a table of outstanding requests.
+ This logic is not included in this example.
+
+
Request: Client Side
+
+
In this example, the send buffer for requests is declared as an
+ arbitrary large buffer.
+ The header is initialized once.
+
+ =semlit,insert,req_buf=
+
+
For this simple example, 5 requests are sent.
+
+ =semlit,insert,req_sends=
+
+
Response: Server Side
+
+
When the server receives the request, it sends a response.
+
+ =semlit,insert,do_req1=
+
. . .
+ =semlit,insert,do_req2=
+
+
diff --git a/src_rsp/c/src_rsp.sldoc.html b/src_rsp/c/src_rsp.sldoc.html
new file mode 100644
index 0000000..5f2de63
--- /dev/null
+++ b/src_rsp/c/src_rsp.sldoc.html
@@ -0,0 +1,484 @@
+
+
+
+ Source-based Request/Response
+
+
+ Example index
+
+
How to use sources to send requests and responses.
+
+
There are two source files associated with this example:
+
+
client.c
+ - (right-click and save as "client.c").
+
server.c
+ - (right-click and save as "server.c").
+
+
+
The UM "request/response" feature provides a convenient, easy-to-code
+ method for a classic server program to respond to a request sent by a client.
+ The feature takes care of routing the server's response message back to
+ the client that sent the request.
+ It also associates response messages with the corresponding request
+ messages, even if multiple messages are outstanding.
+ See Request-Response Sample.
+
+
However, there are advantages for the server to use a normal UM
+ source to send response messages:
+
+
Choice of transport types.
+ UM responses are always sent with TCP.
+
+
Reliability settings for non-TCP transports are under user control.
+ Can be configured to recover messages after long network outages.
+
+
Extra layer of reliability.
+ The "OTR" feature can recover messages unrecoverably lost by the
+ transport.
+ Also, the source can be made persistent for even greater reliability.
+
+
Better application visibility.
+ Receivers get BOS, EOS, and unrecoverable loss events, and for
+ unicast transport types, sources get connect and disconnect events.
+
+
UDP-based transport types can give lower latency.
+
+
+
This sample program uses an LBT-RU source to return response messages
+ to the requesting client program.
+
+
Overall Approach
+
+
Clients use a UM source to send a request to a server, and the server
+ uses a UM receiver to receive it.
+ The server then uses a UM source to send a response back to only the
+ client that sent the request, and that client uses a UM receiver to
+ receive it.
+ This sample allows and arbitrary number of client programs to come and
+ go, without the server being pre-configured to know about them.
+
+
When a client program initializes, it creates a source to send
+ requests and a receiver to receive responses.
+ The client then exchanges handshakes with the server to register with it,
+ and to verify round-trip connectivity.
+ This verification avoids initial message loss during topic resolution.
+
+
Registration
+
+
The client uses the server's well-known request topic to create
+ the source.
The client needs a unique topic to receive is responses.
+ Using the process PID is an easy, but non-robust method (two
+ clients on different machines can have the same PID).
The registration message that the client sends to the server is
+ all-ascii, consisting of lower-case 'r' followed by a null-terminated
+ topic name on which the client receives responses.
The client sends registration messages repeatedly in a loop, with
+ exponential backoff delays.
+ For example, if the server is not running, the client sends registration
+ attempts at 1, 2, 4, 8, ... milliseconds, to a maximum of 1 second.
+
+
+
+00161 backoff_delay = 1; /* In milliseconds. */
+00162 MSLEEP(backoff_delay); /* Let TR complete. */
+00163 while (server.state == 0) {
+00164 try_cnt ++;
+00165 err = lbm_src_send(server.src, register_msg,
+00166 strlen(register_msg) + 1, LBM_MSG_FLUSH | LBM_SRC_BLOCK);
+00167 EX_LBM_CHK(err);
+00168 printf("Sent '%s' to %s\n", register_msg, server.topic_name);
+00169
+00170 /* Exponential backoff, to max of 1 sec. */
+00171 backoff_delay *= 2; /* Exponential backoff to max of 1 sec. */
+00172 if (backoff_delay > 1000) {
+00173 backoff_delay = 1000;
+00174 }
+00175 MSLEEP(backoff_delay); /* Wait for server response. */
+00176 }
+00177 printf("Took %d tries to register with server.\n", try_cnt);
+
+
+
+
+
The loop exits when the client receives a registration response.
+
+
+
+00070 case LBM_MSG_DATA: /* Received a message from the client. */
+00071 printf("Received %ld bytes on topic %s: '%.*s'\n",
+00072 (long)msg->len, msg->topic_name, (int)msg->len, msg->data);
+00073
+00074 if (msg->len > 1 && msg->data[0] == 'r') {
+00075 /* Should check for success. */
+00076 server->state = 1; /* Registered. */
+00077 }
+
+
+
+
+
Registration: Server Side
+
+
The server makes use of source notification create/delete callbacks
+ to manage client state.
+ The callbacks are configured as part of creation of the server's
+ main receiver.
Then, when the receiver discovers a new client's source,
+ start_client_source() is called.
+ That function only creates the state structure associated with the
+ new client.
When the client sends its registration message, it is received by
+ the server, which uses it to create the source used for sending
+ responses.
+ The state structure created above is passed to the receiver
+ callback in msg->source_clientd.
Registration requests start with the character 'r'.
+
+
+
+00153 case LBM_MSG_DATA: /* Received a message from the client. */
+00154 printf("Received %ld bytes on topic %s: '%.*s'\n",
+00155 (long)msg->len, msg->topic_name, (int)msg->len, msg->data);
+00156
+00157 /* Register message. */
+00158 if (msg->len > 1 && msg->data[0] == 'r') {
+00159 handle_register(client, &msg->data[1]);
+00160 }
+
+
+
+
. . .
+
+
+00075 void handle_register(client_t *client, const char *client_resp_name)
+00076 {
+00077 int err;
+00078 /* This work should probably be passed to a separate worker thread, but
+00079 * I'll do it here to simplify the code. */
+00080
+00081 if (client->state == 1) {
+00082 printf("Source '%s' re-confirmed\n", client->topic_name);
+00083 /* Reply to client. */
+00084 err = lbm_src_send(client->resp_src, "rOK", 4, LBM_MSG_FLUSH | LBM_SRC_NONBLOCK);
+00085 EX_LBM_CHK(err);
+00086 }
+00087 else if (client->state == 0) {
+00088 lbm_src_topic_attr_t * src_attr;
+00089 lbm_topic_t *lbm_topic;
+00090
+00091 /* Create source to send responses to client. */
+00092 err = lbm_src_topic_attr_create(&src_attr);
+00093 EX_LBM_CHK(err);
+00094 err = lbm_src_topic_attr_str_setopt(src_attr, "transport", "lbt-ru");
+00095 EX_LBM_CHK(err);
+00096 err = lbm_src_topic_attr_str_setopt(src_attr, "transport_lbtru_port", "12070");
+00097 EX_LBM_CHK(err);
+00098 err = lbm_src_topic_attr_str_setopt(src_attr,
+00099 "transport_source_side_filtering_behavior", "inclusion");
+00100 EX_LBM_CHK(err);
+00101 err = lbm_src_topic_alloc(&lbm_topic, client->ctx, client_resp_name, src_attr);
+00102 EX_LBM_CHK(err);
+00103 /* The following create can fail if a new client joins with the same
+00104 * response topic name as an existing client. Should handle this cleanly. */
+00105 err = lbm_src_create(&client->resp_src, client->ctx, lbm_topic,
+00106 NULL, NULL, NULL);
+00107 if (err) {
+00108 printf("Source '%s' failed; %s\n", client_resp_name, lbm_errmsg());
+00109 }
+00110 else {
+00111 client->state = 1;
+00112 client->topic_name = strdup(client_resp_name);
+00113 NULL_CHK(client->topic_name);
+00114 printf("Source '%s' created\n", client->topic_name);
+00115 }
+00116
+00117 err = lbm_src_topic_attr_delete(src_attr);
+00118 EX_LBM_CHK(err);
+00119 }
+00120 } /* handle_register */
+
+
+
+
+
The response source is created in a special way.
+ It is an LBT-RU transport type, with a fixed port number (the choice
+ of 12070 was arbitrary).
+ This means that all clients' sources are mapped to the same LBT-RU
+ transport session.
On successful source creation, the client state is filled in.
+ But no reply is sent to the client.
+ This is because the client has not yet had a chance to discover and
+ join the new source, so any message sent at this point would not
+ be delivered.
The server could set some kind of timer to send its reply, but
+ to simplify this code, we just wait for the client to retry.
+ When the next registration request comes in, we send the OK
+ message.
+ Thus, it will always take at least 2 tries to register.
This example does not contain the code necessary to associate responses
+ with their requests.
+ However, the simple protocol was designed to allow this to be added.
+ A request message consists of an 8-ascii-byte header followed by the
+ application message content.
+ The first byte of the header is the character 'R' to indicate a request
+ message.
+ The other 7 bytes are currently just set to ascii '0' characters, but
+ could be used as a request ID.
+ When the server responds to requests, it uses the same header it
+ received, so the client can maintain a table of outstanding requests.
+ This logic is not included in this example.
+
+
Request: Client Side
+
+
In this example, the send buffer for requests is declared as an
+ arbitrary large buffer.
+ The header is initialized once.
+00123 void handle_req(client_t *client, req_hdr_t *req_hdr, const char *req_msg, size_t len)
+00124 {
+00125 int err;
+00126
+00127 /* This work should probably be passed to a separate worker thread, but
+00128 * I'll do it here to simplify the code. */
+00129
+00130 /* Responses copy the header from the request. */
+00131 memcpy(&client->send_buf[0], (char *)req_hdr, sizeof(req_hdr_t));
+00132 /* Response message is put after the header. */
+00133 char *response_msg = &client->send_buf[sizeof(req_hdr_t)];
+00134
+00135 /* Do the work of the request and put the response in response_msg.
+00136 * (For this sample, just echo back the request.) */
+00137 strcpy(response_msg, req_msg);
+00138
+00139 /* Reply to client. */
+00140 err = lbm_src_send(client->resp_src, client->send_buf,
+00141 strlen(client->send_buf) + 1, LBM_MSG_FLUSH | LBM_SRC_NONBLOCK);
+00142 EX_LBM_CHK(err);
+00143 printf("sent response to '%s'.\n", client->topic_name);
+00144 } /* handle_req */
+
+
+
+
+
+
diff --git a/ss_frag/README.txt b/ss_frag/README.txt
new file mode 100644
index 0000000..edea64d
--- /dev/null
+++ b/ss_frag/README.txt
@@ -0,0 +1,3 @@
+Summary=A sample application that demonstrates application-level message fragmentation/reassembly for Smart Source.
+
+Description=
diff --git a/ss_frag/c/blank.html b/ss_frag/c/blank.html
new file mode 100644
index 0000000..0841bfc
--- /dev/null
+++ b/ss_frag/c/blank.html
@@ -0,0 +1 @@
+Click a source line number to see the line in context.
diff --git a/ss_frag/c/index.html b/ss_frag/c/index.html
new file mode 100644
index 0000000..a36528e
--- /dev/null
+++ b/ss_frag/c/index.html
@@ -0,0 +1,6 @@
+
+
+
diff --git a/ss_frag/c/ss_frag.c b/ss_frag/c/ss_frag.c
new file mode 100644
index 0000000..408d31c
--- /dev/null
+++ b/ss_frag/c/ss_frag.c
@@ -0,0 +1,459 @@
+/* ss_frag.c - see http://ultramessaging.github.io/UMExamples/ss_frag/c/index.html
+ *
+ * Copyright (c) 2005-2018 Informatica Corporation. All Rights Reserved.
+ * Permission is granted to licensees to use
+ * or alter this software for any purpose, including commercial applications,
+ * according to the terms laid out in the Software License Agreement.
+ *
+ * This source code example is provided by Informatica for educational
+ * and evaluation purposes only.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INFORMATICA DISCLAIMS ALL WARRANTIES
+ * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF
+ * NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ * PURPOSE. INFORMATICA DOES NOT WARRANT THAT USE OF THE SOFTWARE WILL BE
+ * UNINTERRUPTED OR ERROR-FREE. INFORMATICA SHALL NOT, UNDER ANY CIRCUMSTANCES, BE
+ * LIABLE TO LICENSEE FOR LOST PROFITS, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR
+ * INDIRECT DAMAGES ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE
+ * TRANSACTIONS CONTEMPLATED HEREUNDER, EVEN IF INFORMATICA HAS BEEN APPRISED OF
+ * THE LIKELIHOOD OF SUCH DAMAGES.
+ */
+
+#include
+#include
+
+#if defined(_MSC_VER)
+/* Windows-only includes */
+#include
+#define SLEEP(s) Sleep((s)*1000)
+#else
+/* Unix-only includes */
+#include
+#include
+#define SLEEP(s) sleep(s)
+#endif
+
+#include
+
+
+/* Application structure associated with a smart source.
+ */
+typedef struct {
+ lbm_context_t *ctx;
+ lbm_ssrc_t *ssrc;
+ char *msgbuf_plain;
+ char *msgbuf_props;
+ int max_msg_len;
+ lbm_ssrc_send_ex_info_t info_prop;
+ lbm_uint32_t int_value_array[2];
+ char *key_ptr_array[2];
+ char remain_key[8];
+} smart_source_t;
+
+
+/* Receiver state used to reassemble fragmented messages. Used as per-source
+ * clientd.
+ */
+typedef struct {
+ int collecting; /* 1=true, 0=false. */
+ char *reassem_buf;
+ size_t reassem_buf_size;
+ size_t message_len; /* Size of message being reassembled. */
+ size_t offset; /* Current offset within reassem_buf[]. */
+ long num_bad_frags; /* Statistic: bad fragemnts. */
+} rcv_state_t;
+
+
+/*
+ * Simple lbm error handling.
+ */
+
+/* Macro to approximate the basename() function. */
+#define BASENAME(_p) ((strrchr(_p, '/') == NULL) ? (_p) : (strrchr(_p, '/')+1))
+
+/* Pass in an LBM return status. If not success, print error and abort. */
+#define LBM_ERR(_e) do {\
+ if ((_e) != LBM_OK) {\
+ printf("LBM_ERR: at %s:%d (%s)\n",\
+ BASENAME(__FILE__), __LINE__, lbm_errmsg());\
+ fflush(stdout);\
+ abort();\
+ }\
+} while (0)
+
+/* Print error and abort. */
+#define ERR(_s) do {\
+ printf("ERR: at %s:%d (%s)\n",\
+ BASENAME(__FILE__), __LINE__, _s);\
+ fflush(stdout);\
+ abort();\
+} while (0)
+
+
+/* Called by receiver callback when a received messager has the "Remain"
+ * message property, indicating a fragmented message.
+ */
+void handle_msg_frag(lbm_msg_t *msg, rcv_state_t *rcv_state,
+ lbm_int32_t remaining)
+{
+ size_t tot_len;
+
+ if (rcv_state->collecting) {
+ /* Make sure the fragment is OK. */
+ if (remaining >= 0 &&
+ (rcv_state->message_len == (rcv_state->offset + msg->len + remaining)))
+ {
+ /* Collect the fragment. */
+ memcpy(&rcv_state->reassem_buf[rcv_state->offset], msg->data,
+ msg->len);
+ rcv_state->offset += msg->len;
+
+ if (remaining == 0) { /* No more, deliver the data. */
+ printf("PROCESS message, buf[0]=%d, buf[%ld]=%d\n",
+ rcv_state->reassem_buf[0],
+ rcv_state->message_len - 1,
+ rcv_state->reassem_buf[rcv_state->message_len - 1]);
+
+ /* No longer collecting. */
+ rcv_state->collecting = 0;
+ }
+ } /* if fragment OK */
+ else { /* fragment is not ok. */
+ /* Bad fragment (should never happen). */
+ printf("Collect error: bad fragment, remaining=%d, offset=%ld, len=%lu, message_len=%ld\n", remaining, rcv_state->offset, msg->len, rcv_state->message_len);
+ rcv_state->num_bad_frags ++;
+
+ /* Error, stop collecting. */
+ rcv_state->collecting = 0;
+ }
+ }
+
+ else { /* not collecting */
+ /* Not collecting a fragmented message, is this message first frag? */
+ if (remaining < 0) {
+ /* First fragment. */
+ rcv_state->collecting = 1;
+ rcv_state->offset = 0;
+ rcv_state->message_len = msg->len + (- remaining);
+ /* Expand buffer if necessary. */
+ if (rcv_state->message_len > rcv_state->reassem_buf_size) {
+ rcv_state->reassem_buf_size = rcv_state->message_len;
+ rcv_state->reassem_buf = (char *)realloc(rcv_state->reassem_buf,
+ rcv_state->reassem_buf_size);
+ }
+
+ /* Collect data. */
+ memcpy(&rcv_state->reassem_buf[rcv_state->offset], msg->data, msg->len);
+ rcv_state->offset += msg->len;
+ } /* remaining < 0 */
+ else { /* Found middle frag without a first frag; discard. */
+ /* Probably joined stream in middle of message. */
+ printf("info: found middle frag but not collecting, remaining=%d, offset=%ld, len=%lu, message_len=%ld\n", remaining, rcv_state->offset, msg->len, rcv_state->message_len);
+ rcv_state->num_bad_frags ++;
+ }
+ } /* not collecting */
+} /* handle_msg_frag */
+
+
+/* UM receiver callback.
+ */
+int msg_rcv_cb(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+{
+ rcv_state_t *rcv_state = (rcv_state_t *)msg->source_clientd;
+ int err;
+
+ switch (msg->type) {
+ case LBM_MSG_DATA:
+ if (msg->properties == NULL) {
+ /* Fast path (not part of a fragmented messqge). */
+ if (rcv_state->collecting) {
+ /* Error, non-frag, but state is collecting (should never happen). */
+ printf("Collect error non-frag, offset=%ld, len=%lu, message_len=%ld\n", rcv_state->offset, msg->len, rcv_state->message_len);
+ rcv_state->collecting = 0;
+ rcv_state->num_bad_frags ++;
+ }
+
+ /* Deliver data message. */
+ printf("PROCESS message, buf[0]=%d, buf[%ld]=%d\n",
+ msg->data[0],
+ msg->len - 1,
+ msg->data[msg->len - 1]);
+ }
+ else { /* msg properties */
+ lbm_int32_t remaining;
+ size_t prop_size = sizeof(remaining);
+ int prop_type = LBM_MSG_PROPERTY_INT;
+
+ /* Found property, is it for fragmentation? */
+ err = lbm_msg_properties_get(msg->properties, "Remain",
+ &remaining, &prop_type, &prop_size);
+ if (err == LBM_OK) {
+ handle_msg_frag(msg, rcv_state, remaining);
+ }
+ else {
+ printf("handle messages with other properties.\n");
+ }
+ } /* msg properties not null */
+ break;
+
+ case LBM_MSG_UNRECOVERABLE_LOSS:
+ case LBM_MSG_UNRECOVERABLE_LOSS_BURST:
+ if (rcv_state->collecting) {
+ /* Stop collecting after error. */
+ rcv_state->collecting = 0;
+ rcv_state->num_bad_frags ++;
+ }
+
+ default:
+ printf("Non data receiver event, type=%d\n", msg->type);
+ } /* switch msg type */
+
+ return 0;
+} /* msg_rcv_cb */
+
+
+/* Callback when a receiver delivery controller is created for a new source. */
+void *per_src_clientd_create(const char *source_name, void *clientd)
+{
+ rcv_state_t *rcv_state;
+
+ rcv_state = (rcv_state_t *)malloc(sizeof(rcv_state_t));
+
+ rcv_state->reassem_buf_size = 8192;
+ rcv_state->reassem_buf = (char *)malloc(rcv_state->reassem_buf_size);
+ rcv_state->collecting = 0;
+ rcv_state->num_bad_frags = 0;
+
+ return rcv_state;
+} /* per_src_clientd_create */
+
+
+/* Callback when a receiver delivery controller for an ex-source is deleted. */
+int per_src_clientd_delete(const char *source_name, void *clientd,
+ void *src_clientd)
+{
+ rcv_state_t *rcv_state = (rcv_state_t *)src_clientd;
+
+ if (rcv_state->collecting) {
+ /* Error, state is collecting. */
+ printf("Collect error, incomplete fragmented message, offset=%ld, message_len=%ld\n", rcv_state->offset, rcv_state->message_len);
+ }
+ if (rcv_state->num_bad_frags > 0) {
+ printf("Number of bad fragments=%ld\n", rcv_state->num_bad_frags);
+ }
+
+ free(rcv_state->reassem_buf);
+ free(rcv_state);
+
+ return 0;
+} /* per_src_clientd_delete */
+
+
+/* Create a SmartSource, and init associated state.
+ */
+void smart_source_init(smart_source_t *smart_source, lbm_context_t *ctx,
+ char *topic)
+{
+ lbm_topic_t *lbm_topic = NULL;
+ lbm_src_topic_attr_t *src_tattr = NULL;
+ int prop_count;
+ size_t opt_len;
+ int err;
+
+ smart_source->ctx = ctx;
+
+ err = lbm_src_topic_attr_create(&src_tattr);
+ LBM_ERR(err);
+
+ /* Make sure user's config allows at least 1 msg property. */
+ opt_len = sizeof(prop_count);
+ err = lbm_src_topic_attr_getopt(src_tattr,
+ "smart_src_message_property_int_count", &prop_count, &opt_len);
+ LBM_ERR(err);
+ if (prop_count == 0) {
+ /* No props configured, add one. */
+ prop_count = 1;
+ opt_len = sizeof(prop_count);
+ err = lbm_src_topic_attr_setopt(src_tattr,
+ "smart_src_message_property_int_count", &prop_count, opt_len);
+ LBM_ERR(err);
+ }
+
+ /* Find out the user's config for max message length. */
+ opt_len = sizeof(smart_source->max_msg_len);
+ err = lbm_src_topic_attr_getopt(src_tattr,
+ "smart_src_max_message_length", &(smart_source->max_msg_len), &opt_len);
+ LBM_ERR(err);
+
+ err = lbm_src_topic_alloc(&lbm_topic, ctx, topic, src_tattr);
+ LBM_ERR(err);
+
+ err = lbm_ssrc_create(&(smart_source->ssrc), ctx, lbm_topic, NULL, NULL,
+ NULL);
+ LBM_ERR(err);
+
+ err = lbm_src_topic_attr_delete(src_tattr);
+ LBM_ERR(err);
+
+ err = lbm_ssrc_buff_get(smart_source->ssrc, &smart_source->msgbuf_plain, 0);
+ LBM_ERR(err);
+ err = lbm_ssrc_buff_get(smart_source->ssrc, &smart_source->msgbuf_props, 0);
+ LBM_ERR(err);
+
+ /* Set up message property. */
+ smart_source->info_prop.flags = LBM_SSRC_SEND_EX_FLAG_PROPERTIES;
+ smart_source->info_prop.mprop_int_cnt = 1;
+ smart_source->info_prop.mprop_int_vals = smart_source->int_value_array;
+ smart_source->info_prop.mprop_int_keys = &smart_source->key_ptr_array[0];
+ smart_source->key_ptr_array[0] = smart_source->remain_key;
+ strncpy(smart_source->remain_key, "Remain", sizeof(smart_source->remain_key));
+} /* smart_source_init */
+
+
+/* Send a message, fragmenting it if necessary.
+ */
+void smart_source_send(smart_source_t *smart_source, char *buf, size_t len,
+ int flags)
+{
+ int err;
+
+ if (len <= smart_source->max_msg_len) {
+ /* Message fits in one buffer, send it. */
+ memcpy(smart_source->msgbuf_plain, buf, len);
+ err = lbm_ssrc_send_ex(smart_source->ssrc, smart_source->msgbuf_plain,
+ len, 0, NULL);
+ LBM_ERR(err);
+ }
+
+ else { /* Message does not fit in one buffer */
+ int offset;
+ int remaining;
+ int this_len;
+
+ /* Fragment message. */
+ remaining = len;
+ offset = 0;
+
+ this_len = smart_source->max_msg_len;
+ remaining -= this_len;
+ /* Indicate first fragment with negative remainer. */
+ smart_source->int_value_array[0] = - remaining;
+ memcpy(smart_source->msgbuf_props, &buf[offset], this_len);
+ err = lbm_ssrc_send_ex(smart_source->ssrc, smart_source->msgbuf_props,
+ this_len, 0, &(smart_source->info_prop));
+ LBM_ERR(err);
+ offset += this_len;
+
+ /* From now on, need to update the properties. */
+ smart_source->info_prop.flags |= LBM_SSRC_SEND_EX_FLAG_UPDATE_PROPERTY_VALUES;
+
+ /* Send rest of fragments. */
+ while (remaining > 0) {
+ if (remaining > smart_source->max_msg_len) {
+ this_len = smart_source->max_msg_len;
+ }
+ else {
+ this_len = remaining;
+ }
+ remaining -= this_len;
+ smart_source->int_value_array[0] = remaining;
+ memcpy(smart_source->msgbuf_props, &buf[offset], this_len);
+ err = lbm_ssrc_send_ex(smart_source->ssrc, smart_source->msgbuf_props,
+ this_len, 0, &(smart_source->info_prop));
+
+ offset += this_len;
+ } /* while */
+ }
+} /* smart_source_send */
+
+
+int main(int argc, char **argv) {
+ lbm_context_t *rctx = NULL;
+ lbm_context_t *sctx = NULL;
+ lbm_rcv_topic_attr_t *rcv_attr = NULL;
+ lbm_rcv_src_notification_func_t src_notif_func; /* config option */
+ lbm_topic_t *lbm_topic = NULL;
+ lbm_rcv_t *rcv;
+ smart_source_t smart_source;
+ char *send_buff;
+ int err;
+
+ err = lbm_config("test.cfg");
+ LBM_ERR(err);
+
+ /* Create a pair of contexts, one for publisher, the other for subscriber.
+ */
+
+ err = lbm_context_create(&rctx, NULL, NULL, NULL);
+ LBM_ERR(err);
+
+ err = lbm_context_create(&sctx, NULL, NULL, NULL);
+ LBM_ERR(err);
+
+
+ /* Create receiver.
+ */
+
+ err = lbm_rcv_topic_attr_create(&rcv_attr);
+ LBM_ERR(err);
+
+ src_notif_func.create_func = per_src_clientd_create;
+ src_notif_func.delete_func = per_src_clientd_delete;
+ src_notif_func.clientd = NULL; /* Or your own state structure. */
+ err = lbm_rcv_topic_attr_setopt(rcv_attr, "source_notification_function",
+ &src_notif_func, sizeof(src_notif_func));
+ LBM_ERR(err);
+
+ err = lbm_rcv_topic_lookup(&lbm_topic, rctx, "topic_1", rcv_attr);
+ LBM_ERR(err);
+
+ err = lbm_rcv_create(&rcv, rctx, lbm_topic, msg_rcv_cb, NULL, NULL);
+ LBM_ERR(err);
+
+
+ /* Create source.
+ */
+ smart_source_init(&smart_source, sctx, "topic_1");
+
+ send_buff = (char *)malloc(70000); /* Bigger than 64k, for fun. */
+
+ SLEEP(1); /* For topic res. */
+
+
+ /* Send messages.
+ */
+
+ send_buff[0] = 1; send_buff[999] = 1;
+ smart_source_send(&smart_source, send_buff, 1000, LBM_MSG_FLUSH);
+ SLEEP(1);
+
+ send_buff[0] = 2; send_buff[4999] = 2;
+ smart_source_send(&smart_source, send_buff, 5000, LBM_MSG_FLUSH);
+ SLEEP(1);
+
+ send_buff[0] = 3; send_buff[19999] = 3;
+ smart_source_send(&smart_source, send_buff, 20000, LBM_MSG_FLUSH);
+ SLEEP(1);
+
+ send_buff[0] = 4; send_buff[99] = 4;
+ smart_source_send(&smart_source, send_buff, 100, LBM_MSG_FLUSH);
+ SLEEP(1);
+
+ send_buff[0] = 5; send_buff[69999] = 5;
+ smart_source_send(&smart_source, send_buff, 70000, LBM_MSG_FLUSH);
+ SLEEP(1);
+
+
+ /* Shut down.
+ */
+
+ free(send_buff);
+
+ (void)lbm_ssrc_delete(smart_source.ssrc);
+ (void)lbm_rcv_delete(rcv);
+
+ (void)lbm_context_delete(rctx);
+ (void)lbm_context_delete(sctx);
+
+ return 0;
+} /* main */
diff --git a/ss_frag/c/ss_frag.sldoc b/ss_frag/c/ss_frag.sldoc
new file mode 100644
index 0000000..100c0c5
--- /dev/null
+++ b/ss_frag/c/ss_frag.sldoc
@@ -0,0 +1,95 @@
+
+
+
+ Smart Source Message Fragmentation
+
+
+ =semlit,include,../intro.sldoc=
+
There is one program source file and one test configuration file:
+
+
=semlit,srcfile,ss_frag_c.slsrc,ss_frag.c=
+ - (right-click and save as "ss_frag.c") main program.
+=semlit,initialsource,ss_frag_c.slsrc.html=
+
=semlit,srcfile,test_cfg.txt,test.cfg=
+ - (right-click and save as "test.cfg") main program.
+
+
+
The ss_frag.c file contains:
+
+
Source-side code (fragments messages),
+
Receive-side code (reassembles messages),
+
Simple demonstration code.
+
+
Source-Side Code
+
At the heart of the source-side code is the function
+ smart_source_send():
+ =semlit,insert,send_funct=
+
CLICK ON A LINE NUBMER TO SEE THE CODE ON THE RIGHT IN CONTEXT!
+
This function first checks to see if the application message is
+ small enough to fit in a single message. If so, it sends the
+ message without any message properties.
+ =semlit,insert,send_check=
+
For application messages that are too big, they need to be
+ fragmented. The "Remain" message property is set to negative
+ of the remaining size after this fragment is sent.
+ =semlit,insert,send_first=
+
Subsequent fragments are sent, chunk at a time, with
+ a positive "Remain" property.
+ =semlit,insert,send_rest=
+
Send Buffers
+
For efficiency and simplicity, two Smart Source send buffers
+ are used to send messages: msgbuf_plain for small messages
+ with no properties, and msgbuf_props for large fragmented
+ messages that have properties. They are initialized in
+ smart_source_init().
+ =semlit,insert,send_buffs=
+
The message property is also initialized.
+ =semlit,insert,send_props=
+
The source-side code needs to know what the size threshold is for
+ fragmented messages. It determines this by creating a source
+ attribute object, which inherets the user's configuration.
There is also a sanity check to make sure the user configured a
+ message property.
+ =semlit,insert,send_conf_prop=
+
Receiver-Side Code
+
At the heart of the receiver-side code is the receiver application
+ callback function smart_source_send():
+ =semlit,insert,rcv_cb=
+
If there is no message property with the message, it is a small
+ (non-fragmented) message, and can be delivered.
+ It does a sanity check first to make sure there isn't a fragmented
+ message in-progress.
+ =semlit,insert,rcv_no_prop=
+
Otherwise, there is a property, which we make sure is "Remain".
+ =semlit,insert,rcv_tst_prop=
+
Once the message is known to be a fragment, it is passed to the
+ function handle_msg_frag() for reassembly.
+ This function has two states it can be in: collecting (in the middle
+ of a fragmented message), or not collecting (waiting for a negative
+ "Remain" property to indicate the start of a fragmented message).
+
If it is collecting, the newly-received message is validated to make
+ sure it is the expected next fragment.
+ =semlit,insert,rcv_chk_frag=
+
Once validated, the message content is collected.
+ If this is the last fragment in the message ("Remain"==0) then the
+ reassembled message is delivered.
+ =semlit,insert,rcv_collect=
+
First Fragment Processing
+
If handle_msg_frag() is called and the receiver state is
+ not collecting, then the fragment should be the first
+ fragment of a large message ("Remain" negative).
+ =semlit,insert,rcv_first_frag=
+
Start the collection state.
+ =semlit,insert,rcv_start_collect=
+
To keep the algorithm general, if the fragmented message is larger
+ than the currently-allocated reassembly buffer, expand it.
+ =semlit,insert,rcv_expand=
+
Finally, collect the first fragment's data.
+ =semlit,insert,rcv_collect_first=
+
+
diff --git a/ss_frag/c/ss_frag.sldoc.html b/ss_frag/c/ss_frag.sldoc.html
new file mode 100644
index 0000000..09ab8db
--- /dev/null
+++ b/ss_frag/c/ss_frag.sldoc.html
@@ -0,0 +1,352 @@
+
+
+
+ Smart Source Message Fragmentation
+
+
+ Example index
+
Smart Source Message Fragmentation
+
Ultra Messaging has a feature called
+ Smart Sources
+ which provides lower average latency and much lower latency
+ variation (jitter) than traditional UM sources.
+ Smart Sources are able to deliver these benefits by trading off reduced
+ flexibility for simplicity, especially simplicity in memory usage.
+
One area of reduced flexibility is related to message sizes.
+ To avoid dynamic memory allocation/deallocation, Smart Sources require
+ the user to configure the maximum expected message size.
+ Also, Smart Sources do not support fragmentation and reassembly of
+ messages larger than the maximum datagram size.
+ An application message must fit in a single datagram.
+ Finally, users of kernel bypass TCP/IP stacks (like Solarflare's Onload)
+ pay a heavy penalty if IP fragmentation is performed by the kernel.
+ These users typically want to keep each datagram at or below the
+ NIC's MTU size (typically 1500 bytes).
+
However, many applications have a fairly small average message size,
+ but occasionally need to send messages that are much larger.
+ If that worst-case large message size is larger than an MTU,
+ it cannot be efficiently sent using Onload or other kernel bypass stacks.
+
Also, even if IP fragmentation is not a problem,
+ a Smart Sources pre-allocates its retransmission buffers based on the
+ worst-case message size.
+ For applications that normally send small messages but occasionally
+ need to send very large ones,
+ this can lead to a significant memory footprint.
+
One solution to these problems is for an application to configure Smart
+ Source for small messages, and perform message fragmentation and
+ reassembly at the application level.
+ This example program does just that.
+
High-Level Design
+
An integer message property with key name "Remain" is used to manage
+ message fragmentation and reassembly.
+ Small messages may be sent without a property.
+ Messages which exceed a configured threshold will be sent in "chunks",
+ with a message property providing the information needed by the
+ receiver to reassemble the chunks.
+
When the application wants to send a message larger than
+ [smart_src_max_message_length (source)](https://ultramessaging.github.io/currdoc/doc/Config/grpsmartsource.html#smartsrcmaxmessagelengthsource),
+ the first fragment is sent with the "Remain" property is a negative
+ number representing the number of bytes that still need to be sent
+ (not counting the content of that first message).
+ Each subsequent message fragment sent has the "Remain" property as
+ a positive number of the number of bytes remaining
+ after that message.
+
For example, if smart_src_max_message_length is set to 1400 and a
+ 5000 byte message is sent, 4 UM messages will be sent.
+ Here are the message lengths and values for the "Remain" property:
+
+
length=1400, Remain=-3600
+
length=1400, Remain=2200
+
length=1400, Remain=800
+
length=800, Remain=0
+
When the receiver sees Remain=0, it can deliver the reassembled message.
+
+
There is one program source file and one test configuration file:
+
+
ss_frag.c
+ - (right-click and save as "ss_frag.c") main program.
+
+
test.cfg
+ - (right-click and save as "test.cfg") main program.
+
+
+
The ss_frag.c file contains:
+
+
Source-side code (fragments messages),
+
Receive-side code (reassembles messages),
+
Simple demonstration code.
+
+
Source-Side Code
+
At the heart of the source-side code is the function
+ smart_source_send():
+
+
+00313 /* Send a message, fragmenting it if necessary.
+00314 */
+00315 void smart_source_send(smart_source_t *smart_source, char *buf, size_t len,
+00316 int flags)
+00317 {
+
+
+
+
CLICK ON A LINE NUBMER TO SEE THE CODE ON THE RIGHT IN CONTEXT!
+
This function first checks to see if the application message is
+ small enough to fit in a single message. If so, it sends the
+ message without any message properties.
+
+
+00320 if (len <= smart_source->max_msg_len) {
+00321 /* Message fits in one buffer, send it. */
+00322 memcpy(smart_source->msgbuf_plain, buf, len);
+00323 err = lbm_ssrc_send_ex(smart_source->ssrc, smart_source->msgbuf_plain,
+00324 len, 0, NULL);
+00325 LBM_ERR(err);
+00326 }
+
+
+
+
For application messages that are too big, they need to be
+ fragmented. The "Remain" message property is set to negative
+ of the remaining size after this fragment is sent.
For efficiency and simplicity, two Smart Source send buffers
+ are used to send messages: msgbuf_plain for small messages
+ with no properties, and msgbuf_props for large fragmented
+ messages that have properties. They are initialized in
+ smart_source_init().
The source-side code needs to know what the size threshold is for
+ fragmented messages. It determines this by creating a source
+ attribute object, which inherets the user's configuration.
At the heart of the receiver-side code is the receiver application
+ callback function smart_source_send():
+
+
+00158 /* UM receiver callback.
+00159 */
+00160 int msg_rcv_cb(lbm_rcv_t *rcv, lbm_msg_t *msg, void *clientd)
+00161 {
+
+
+
+
If there is no message property with the message, it is a small
+ (non-fragmented) message, and can be delivered.
+ It does a sanity check first to make sure there isn't a fragmented
+ message in-progress.
+
+
+00167 if (msg->properties == NULL) {
+00168 /* Fast path (not part of a fragmented messqge). */
+00169 if (rcv_state->collecting) {
+00170 /* Error, non-frag, but state is collecting (should never happen). */
+00171 printf("Collect error non-frag, offset=%ld, len=%lu, message_len=%ld\n", rcv_state->offset, msg->len, rcv_state->message_len);
+00172 rcv_state->collecting = 0;
+00173 rcv_state->num_bad_frags ++;
+00174 }
+00175
+00176 /* Deliver data message. */
+00177 printf("PROCESS message, buf[0]=%d, buf[%ld]=%d\n",
+00178 msg->data[0],
+00179 msg->len - 1,
+00180 msg->data[msg->len - 1]);
+00181 }
+
+
+
+
Otherwise, there is a property, which we make sure is "Remain".
+
+
+00187 /* Found property, is it for fragmentation? */
+00188 err = lbm_msg_properties_get(msg->properties, "Remain",
+00189 &remaining, &prop_type, &prop_size);
+00190 if (err == LBM_OK) {
+00191 handle_msg_frag(msg, rcv_state, remaining);
+00192 }
+
+
+
+
Once the message is known to be a fragment, it is passed to the
+ function handle_msg_frag() for reassembly.
+ This function has two states it can be in: collecting (in the middle
+ of a fragmented message), or not collecting (waiting for a negative
+ "Remain" property to indicate the start of a fragmented message).
+
If it is collecting, the newly-received message is validated to make
+ sure it is the expected next fragment.
+
+
+00101 if (rcv_state->collecting) {
+00102 /* Make sure the fragment is OK. */
+00103 if (remaining >= 0 &&
+00104 (rcv_state->message_len == (rcv_state->offset + msg->len + remaining)))
+00105 {
+
+
+
+
Once validated, the message content is collected.
+ If this is the last fragment in the message ("Remain"==0) then the
+ reassembled message is delivered.
If handle_msg_frag() is called and the receiver state is
+ not collecting, then the fragment should be the first
+ fragment of a large message ("Remain" negative).
+
+
+00131 else { /* not collecting */
+00132 /* Not collecting a fragmented message, is this message first frag? */
+00133 if (remaining < 0) {
+00134 /* First fragment. */
+
diff --git a/ss_frag/intro.sldoc b/ss_frag/intro.sldoc
new file mode 100644
index 0000000..e8cae58
--- /dev/null
+++ b/ss_frag/intro.sldoc
@@ -0,0 +1,56 @@
+Example index
+
Smart Source Message Fragmentation
+
Ultra Messaging has a feature called
+ Smart Sources
+ which provides lower average latency and much lower latency
+ variation (jitter) than traditional UM sources.
+ Smart Sources are able to deliver these benefits by trading off reduced
+ flexibility for simplicity, especially simplicity in memory usage.
+
One area of reduced flexibility is related to message sizes.
+ To avoid dynamic memory allocation/deallocation, Smart Sources require
+ the user to configure the maximum expected message size.
+ Also, Smart Sources do not support fragmentation and reassembly of
+ messages larger than the maximum datagram size.
+ An application message must fit in a single datagram.
+ Finally, users of kernel bypass TCP/IP stacks (like Solarflare's Onload)
+ pay a heavy penalty if IP fragmentation is performed by the kernel.
+ These users typically want to keep each datagram at or below the
+ NIC's MTU size (typically 1500 bytes).
+
However, many applications have a fairly small average message size,
+ but occasionally need to send messages that are much larger.
+ If that worst-case large message size is larger than an MTU,
+ it cannot be efficiently sent using Onload or other kernel bypass stacks.
+
Also, even if IP fragmentation is not a problem,
+ a Smart Sources pre-allocates its retransmission buffers based on the
+ worst-case message size.
+ For applications that normally send small messages but occasionally
+ need to send very large ones,
+ this can lead to a significant memory footprint.
+
One solution to these problems is for an application to configure Smart
+ Source for small messages, and perform message fragmentation and
+ reassembly at the application level.
+ This example program does just that.
+
High-Level Design
+
An integer message property with key name "Remain" is used to manage
+ message fragmentation and reassembly.
+ Small messages may be sent without a property.
+ Messages which exceed a configured threshold will be sent in "chunks",
+ with a message property providing the information needed by the
+ receiver to reassemble the chunks.
+
When the application wants to send a message larger than
+ [smart_src_max_message_length (source)](https://ultramessaging.github.io/currdoc/doc/Config/grpsmartsource.html#smartsrcmaxmessagelengthsource),
+ the first fragment is sent with the "Remain" property is a negative
+ number representing the number of bytes that still need to be sent
+ (not counting the content of that first message).
+ Each subsequent message fragment sent has the "Remain" property as
+ a positive number of the number of bytes remaining
+ after that message.
+
For example, if smart_src_max_message_length is set to 1400 and a
+ 5000 byte message is sent, 4 UM messages will be sent.
+ Here are the message lengths and values for the "Remain" property:
+
+
length=1400, Remain=-3600
+
length=1400, Remain=2200
+
length=1400, Remain=800
+
length=800, Remain=0
+
When the receiver sees Remain=0, it can deliver the reassembled message.
Unrecoverable Loss Burst (LBM_MSG_UNRECOVERABLE_LOSS_BURST)
See sample handle_burst for more information on handling burst loss
-00046 case LBM_MSG_UNRECOVERABLE_LOSS_BURST:
-00047 printf("[%s][%s][%x], LOST BURST\n", msg->topic_name, msg->source, msg->sequence_number);
-00048 break;
+00066 case LBM_MSG_UNRECOVERABLE_LOSS_BURST:
+00067 printf("[%s][%s][%x], LOST BURST\n", msg->topic_name, msg->source, msg->sequence_number);
+00068 break;
@@ -103,9 +105,9 @@
Beginning of Transport Session (LBM_MSG_BOS)
source information.
-00049 case LBM_MSG_BOS:
-00050 printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
-00051 break;
+00069 case LBM_MSG_BOS:
+00070 printf("[%s][%s], Beginning of Transport Session\n", msg->topic_name, msg->source);
+00071 break;
@@ -114,9 +116,9 @@
End of Transport Session (LBM_MSG_EOS)
be logged with the same information as BOS.
-00052 case LBM_MSG_EOS:
-00053 printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
-00054 break;
+00072 case LBM_MSG_EOS:
+00073 printf("[%s][%s], End of Transport Session\n", msg->topic_name, msg->source);
+00074 break;
@@ -135,9 +137,9 @@
No Source Notification (LBM_MSG_NO_SOURCE_NOTIFICATION)
Logging this callback is entirely up to the developer, however it could also be useful when trying to debug connectivity issues.
-00055 case LBM_MSG_NO_SOURCE_NOTIFICATION:
-00056 printf("[%s], no sources found for topic\n", msg->topic_name);
-00057 break;
+00075 case LBM_MSG_NO_SOURCE_NOTIFICATION:
+00076 printf("[%s], no sources found for topic\n", msg->topic_name);
+00077 break;
