HELICS_APP-BROKER(1)

NAME
helics_app-broker - intermediary or root in the HELICS hierarchy

SYNOPSIS

helics_app broker [-v|--version] [-h|-?|--help]
    [--quiet] [--config-file <file>] [-t|--core|--type|--coretype <type>]
    [-f|-m|--federates|--minfederates|--minfed <num>]
    [-n|--name|--identifier <name>] [--maxiter|--maxiterations <num>]
    [--minbroker|--minbrokers|--minbrokercount <num>]
    [--key|--broker_key <key>] [--no_ping|--slow_responding]
    [--conservative_time_policy|--restrictive_time_policy]
    [--local|--ipv4|--ipv6|--all|--external] [--brokeraddress <address>]
    [--reuse_address] [--broker <identifier>] [--brokername <name>]
    [--maxsize <buffer size>] [--maxcount <num msgs>] [--networkretries <num>]
    [--osport|--use_os_port] [--autobroker] [--brokerinit <init str>]
    [--client|--server] [-p|--port <num>] [--brokerport <num>] [--localport <num>]
    [--portstart <num>] [--interface|--localinterface <network interface>] [--root]
    [--force_logging_flush] [--logfile <file>] [--loglevel <level>]
    [--fileloglevel <level>] [--consoleloglevel <level>] [--dumplog]
    [--tick <time(ms)>] [--disable_timer|--no_tick] [--timeout <time(ms)>]
    [--networktimeout <time(ms)>]

DESCRIPTION

The broker application functions as an intermediary or root in the HELICS hierarchy. The broker can be run through helics_app or helics_broker.

OPTIONS

-v, --version
    Prints the HELICS version used.

-h, -?, --help
    Prints usage, options, and available subcommands.

--config-file <file>
    The base command line argument configuration file. A file named helics_config.ini is the default.

--quiet
    Silence most printed output.

--root
    Specify that the broker is a root.

-t, --type, --core, --coretype <type>
    The type of core to use. Options include zmq (default), zmqss, tcp, tcpss, udp, ipc, mpi, and test.

  Network Connections

--local, --ipv4, --ipv6, --all, --external
    Specify the external interface to use, the default is --local.

--brokeraddress <address>
    Location of the broker to use (e.g. ip address or hostname).

--reuse_address
    Allow the server to reuse a bound address. Mostly useful for the TCP core.

--broker <identifier>
    Identifier for the broker, either the name or network address. Use --broker_address or --brokername to explicitly set the network address or name to search for the broker first by name.

--brokername <name>
    The name of the broker to use.

--maxsize <buffer size>
    The message buffer size to use. The default size is 4096.

--maxcount <num msgs>
    The maximum number of messages to have in a queue. The default is 256.

--networkretries <num>
    The maximum number of network retries. The default is 5.

--osport, --use_os_port
    Specify that ports should be allocated by the host operating system.

--autobroker
    Allow a broker to automatically be created if one is not available.

--brokerinit <init str>
    The initialization string for the broker.

--client, --server
    Specify that the network connection should be a server (wait for connection) or client (making a connection).

-p, --port <num>
    The port number to use. For automatically picking a port, use -1.

--interface, --localinterface <network interface>
    The local interface to use for the receive ports. Useful if on systems that have multiple network cards.

--brokerport <num>
    The port number to use to connect with the broker.

--localport <num>
    The port number for the local receive port. Use -1 to pick automatically, or -999 to have the os assign a port.

--portstart <num>
    Starting port for automatic port definitions.

  All Core/Broker Types

-f, -m, --minfed, --federates, --minfederates <num>
    The minimum number of federates that will be connecting to the broker.

-n, --name, --identifier <name>
    The name used to identify the broker.

--maxiter, --maxiterations <num>
    The maximum number of iterations allowed for a timestep. Default is 10000 iterations.

--minbroker, --minbrokers, --minbrokercount <num>
    The minimum number of core/brokers that need to be connected.

--key, --broker_key <key>
    Specify a key to use to verify all connections to/from a broker.

--no_ping, --slow_responding
    Specify that a broker might be slow or unresponsive to ping requests from other brokers.

--terminate_on_error
    Specify that a broker should treat all errors as global errors and terminate the co-simulation if an error is encountered

--restrictive_time_policy, --conservative_time_policy
    Specify that a broker should use a conservative time policy in the time coordinator.

  TCP Broker/Core

--connections <connections>
    Target link connections.

--no_outgoing_connection
    Disable outgoing connections.

  MPI Broker/Core

--broker, --broker_address <mpi rank:tag>
    A broker "rank:tag" to connect to.

--rank, --broker_rank <mpi rank>
    MPI rank of a broker using MPI to connect to.

--tag, --broker_tag <mpi tag>
    MPI tag of a broker using MPI to connect to.

  Timeout

--tick <time(ms)>
    Heartbeat time in ms, if there is no broker communication for 2 ticks then secondary actions are taken. Can be entered as a time like 10s or 45ms. Default unit is ms.

--no_tick, --disable_timer
    Disables the timeout timer. Cannot be re-enabled later.

--timeout <time(ms)>
    Time to wait to establish a network connection, or for a connection to communicate. Can be entered as a time like 10s or 45ms. Default unit is ms.

--networktimeout <time(ms)>
    Time to wait for a broker connection. Can be entered as a time like 10s or 45ms. Default unit is ms.

--errortimeout <time(ms)>
    Time to wait after an error has occurred before disconnecting. Can be entered as a time like 10s or 45ms. Default unit is ms.

SEE ALSO

helics_broker(1)