NAME

       amsbenchs - Asynchronous Message Service (AMS) benchmarking driver

SYNOPSIS

       amsbenchs count size

DESCRIPTION

       amsbenchs is a test program that simply publishes count messages of size bytes each on
       subject "bench", then waits while all published messages are transmitted, terminating when
       the user uses ^C to interrupt the program.  The remaining number of messages to be
       published in the test is written into the first four octets of each message.

       amsbenchs 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
       amsbenchs to commence operations.

EXIT STATUS

       -1  amsbenchs failed, for reasons noted in the ion.log file.

       "0" amsbenchs 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:

       No memory for amsbenchs.
           Insufficient available memory for a message content buffer of the indicated size.

       amsbenchs can't register.
           amsbenchs failed to register, for reasons noted in the ion.log file.

       amsbenchs can't set event manager.
           amsbenchs failed to start its background event management thread, for reasons noted in
           the ion.log file.

       amsbenchs: subject 'bench' is unknown.
           amsbenchs can't publish test messages; probably an error in the MIB initialization
           file.

       amsbenchs can't publish message.
           amsbenchs failed to publish, for reasons noted in the ion.log file.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       amsrc(5)