pub_initialize

Call this method before any other API in the publisher API, and call it only once. Set the constant startup.version = PUB_STARTUP_VERSION before calling pub_initialize.

Syntax

uint16_t pub_initialize( PUB_STARTUP * startup_settings );

Parameters

• PUB_STARTUP * startup_settings – Contains information needed by the publisher to initialize.
• version – Always set to PUB_STARTUP_VERSION.
• char * config_dir – The directory in which to locate the publisher.xml file.
• char * template_dir – The directory in which to locate RDS templates.
• bool strict_check – A value indicating whether strict checking should be performed on messages being built. True indicates that strict checking should be performed; Sybase suggests that you use this setting during development. False indicates that strict checking is not performed; Sybase recommends this setting for production mode.
• bool own_logger – True if the feed handler has initialized the log file, and false if the publisher should initialize the log file.
• char * component_subtype – A value indicating the type of publisher. For example, “FAST feed handler” or “demo feed handler.” This information is used to identify the type of publisher when displaying information in Operations Console.
• PUB_CALLBACKS * callbacks – Callbacks are used to notify the publisher API caller of events. RAP currently supports only one callback, which is a function to call if the publisher receives a request to shutdown.

  The caller of the publisher API may have to perform activities that need to occur prior to the shutdown of the publisher API. The publisher API invokes this callback function to notify the caller that a request to shut down has been received. The caller is responsible for performing whatever actions need to be taken and then invoking the publisher's shutdown API.

Returns

uint16_t error_code

An error code or ERR_NONE (value 0).