Configuration: Autopub

The autopub module permits the Transformer (which is an active datasource) to be run in either a pure broadcast mode, or in a hybrid active/broadcast mode.

For example, most DataSource peers in a solution may be connected in an active mode, requesting what data is required, but a datasource that performs logging of all data requires all data within the Transformer to be sent to it.

Due to the active nature of the rest of the system it is not possible to pre-configure the logging datasource with knowledge of all the symbols (and doing so in anycase would not accurately reflect the current requests), in this situation, the autopub module could be used to automatically publish all requested objects to the logging datasource.

Loading Autopub

To load the autopub module add the following to transformer.conf

add-module  autopub

Options

Configuration group add-autopub

Start an autopub group.

Format:

add-autopub
    id          [value]
    peer-label  [value]
    add-symbol  [value]
    add-regex   [value]
    send-only-if-primary
    send-only-once
    distribute-on-peer-up
    listener-flags [value]
    disable-by-default
end-autopub

add-regex

Type: String Array
Default: None

Regex pattern

add-symbol

Type: String Array
Default: None

Individual symbol

peer-label

Type: String Array
Default: None

Peer label to send the data to

id

Type: String
Default: None

Unique identifier

send-only-if-primary

Type: Boolean
Default: FALSE

Only publish if this transformer is primary

send-only-once

Type: Boolean
Default: FALSE

If this option is configured then the update will only be sent once even though multiple peers are configured.

This could be useful in a failover situation where a peer may only become available if an existing peer has failed.

distribute-on-peer-up

Type: Boolean
Default: FALSE

When the peers defined come up, send matching symbols to them

listener-flags

Type: Integer
Default: 0
Acceptable Values:

Name	Value	Desc
none	0	No modifier flags
accessory	1	Subscription should be accessory which does not prevent a discard from happening

Modifier flags for the listener

disable-by-default

Type: Boolean
Default: FALSE

Disable publishing symbols in this group until they are explicitly enabled