0001 TPEVSRV(8)
0002 ==========
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tpevsrv - Enduro/X Local Event Broker server.
0009
0010
0011 SYNOPSIS
0012 --------
0013 *tpevsrv*
0014
0015
0016 DESCRIPTION
0017 -----------
0018 This is special ATMI server which manages local event brokerage.
0019 In bridged mode it also ensure that events are delivers to other nodes too i.e.
0020 to other cluster nodes local event brokers, which dispatches events locally
0021 to subscribed servers.
0022 Following special services are advertised by 'tpevsrv':
0023
0024 . @TPEVSUBS - Service for doing local subscription to event receive by server.
0025
0026 . @TPEVUNSUBS - Service for unsubscribing from event (by server).
0027
0028 . @TPEVPOST - Do global posting. This is called actually by 'tppost()'.
0029 It dispatches events to local servers and does bridge calls.
0030
0031 . @TPEVDOPOST - This is local only posting. Used by bridges when they receive remote
0032 event postings.
0033
0034 Subscriptions to events are supported by per ATMI server instance.
0035 Only one instance of server should be present in local Enduro/X instance.
0036
0037 Event server supports dispatch-threads multi-threading model. By default it
0038 uses single thread, but *ndrxconfig.xml(5)* servers settings such as
0039 'mindispatchtreads' and 'maxdispatchtreads' may be used to add some performance
0040 boost for multi-threading.
0041
0042 The typical configuration looks like this (with 5 dispatching threads):
0043
0044 --------------------------------------------------------------------------------
0045
0046 <server name="tpevsrv">
0047 <srvid>10</srvid>
0048 <mindispatchthreads>5</mindispatchthreads>
0049 <maxdispatchthreads>5</maxdispatchthreads>
0050 <sysopt>-e ${NDRX_HOME}/log/tpevsrv.log -r</sysopt>
0051 </server>
0052
0053 --------------------------------------------------------------------------------
0054
0055 Note that any write operations such as sub-scribe or un-subscribe are executed
0056 with exclusive write lock. Postings are executed with shared read lock.
0057
0058 EXIT STATUS
0059 -----------
0060 *0*::
0061 Success
0062
0063 *-1*::
0064 Failure
0065
0066 BUGS
0067 ----
0068 Report bugs to support@mavimax.com
0069
0070 SEE ALSO
0071 --------
0072 *ndrxd(8)*, *ex_overview(guides)*, *ndrxconfig.xml(5)*
0073
0074
0075 COPYING
0076 -------
0077 (C) Mavimax, Ltd
0078
