Structuring Programs

These steps outline the main structural components of most application programs that communicate using TIBCO FTL.

Note: For Go program structure, see Structuring Programs in Go.
    Procedure
    Task A Initializing TIBCO FTL Objects
  1. Create a realm object by connecting to an FTL server. (C programs must first open the top-level FTL object, and then a realm object.)
    2. Task B Defining Callbacks
  2. Define callbacks to process inbound messages.
  3. Define callbacks to process advisory messages, as needed.
  4. Define callbacks to handle out-of-band notifications.
  5. Define callbacks for timer events, timer completion, and queue completion, as needed.
    6. Task C Sending Messages
  6. Define methods to construct outbound messages.
  7. Instantiate endpoints as publisher objects.
  8. Arrange to call the send methods of publishers.

    Programs usually call send methods in the context of a data-generation loop, or in the context of message callbacks, or both. (You can use timer callbacks to implement a data-generation loop.)

    9. Task D Receiving Messages
  9. Instantiate endpoints as subscriber objects. (With a durable, supply a name property.)
  10. Create event queues, and add each subscriber to an event queue.
  11. Start a loop to dispatch event queues.
    12. Task E Recovery and Clean-Up
  12. Recover from administrative disable (see Recovery of a Disabled Process Restart versus Reopen the Realm).
  13. Exit cleanly (see Clean-Up).