Deployment Configuration Properties

Figure 1. BAR file editor showing deployment configuration properties

Properties promoted to the BAR file are typically one or more node properties that have been promoted up through the flows and subflows or a user defined property (UDP). A user-defined property (UDP) is a property that is defined when a message flow is constructed using the message flow editor and is supported by a specific variable declaration in the ESQL or Java™ code.

The typical properties for application name, application version and database schema shown above are UDPs. An example of UDP definition in the message flow editor is shown in the following figure.

Figure 2. User-Defined Property to define the database schema

In FTM, these UDP values must be used to initialize other code and variables prior to an application interacting with the database or cache APIs so it is important for top level application flows to call the correct initialization functions.

CREATE COMPUTE MODULE IdentifyChannelByName

    DECLARE rEnv REFERENCE TO Environment;
    
    CREATE FUNCTION Main() RETURNS BOOLEAN
    BEGIN
        --------------------------------------------
        -- Call the Core PT Flow Initialization Code
        --------------------------------------------
        CALL INIT_PTF_CONST(rEnv);
        .....
        .....
        RETURN FALSE;

    END;

END MODULE;

In the case of event processing wrapper flows it is not usually necessary to do any specific initialization because the core event processing subflow does this and it is not usual to invoke application code prior to this.

CREATE FUNCTION DB_SCHEMA() 
RETURNS CHAR;

CREATE FUNCTION GetApplication()
RETURNS CHAR;

CREATE FUNCTION GetApplicationId()
RETURNS INTEGER;

CREATE FUNCTION GetAppVer()
RETURNS CHAR;

CREATE FUNCTION IsSpecificAppVersion()
RETURNS BOOLEAN;

CREATE FUNCTION GetAppVerId() 
RETURNS INTEGER;