NAME¶
amsbenchr - Asynchronous Message Service (AMS) benchmarking meter
DESCRIPTION¶
amsbenchr is a test program that simply subscribes to subject
"bench" and receives messages published by amsbenchs until
all messages in the test - as indicated by the count of remaining messages, in
in the first four bytes of each message - have been received. Then it stops
receiving messages, calculates and prints performance statistics, and
terminates.
amsbenchr will register as an application module in the
root unit of the venture identified by application name "amsdemo"
and authority name "test". A configuration server for the local
continuum and a registrar for the root unit of that venture (which may both
be instantiated in a single amsd daemon task) must be running in
order for amsbenchr to commence operations.
EXIT STATUS¶
- -1
- amsbenchr failed, for reasons noted in the ion.log file.
- "0"
- amsbenchr terminated normally.
FILES¶
A MIB initialization file with the applicable default name (see amsrc(5))
must be present.
ENVIRONMENT¶
No environment variables apply.
DIAGNOSTICS¶
The following diagnostics may be issued to the ion.log log file:
- amsbenchr can't register.
- amsbenchr failed to register, for reasons noted in the ion.log
file.
- amsbenchr: subject 'bench' is unknown.
- amsbenchr can't subscribe to test messages; probably an error in
the MIB initialization file.
- amsbenchr can't subscribe.
- amsbenchr failed to subscribe, for reasons noted in the ion.log
file.
- amsbenchr can't get event.
- amsbenchr failed to receive a message, for reasons noted in the
ion.log file.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>