---
name: "amsbenchr"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/amsbenchr"
---

# amsbenchr(1)

Asynchronous Message Service (AMS) benchmarking meter

## NAME

amsbenchr - Asynchronous Message Service (AMS) benchmarking meter

## SYNOPSIS

**amsbenchr**

## 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)](/amsrc/5.md)) 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\>

## SEE ALSO

[*amsrc*(5)](/amsrc/5.md)