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

# amssub(1)

Asynchronous Message Service (AMS) test message receiver for VxWorks

## NAME

amssub - Asynchronous Message Service (AMS) test message receiver for VxWorks

## SYNOPSIS

**amssub** "*application\_name*", "*authority\_name*", "*subject\_name*"

## DESCRIPTION

**amssub** is a message reception program designed to test AMS functionality in a VxWorks environment.  When an **amssub** task is started, it registers as an application module in the root unit of the venture identified by *application\_name* and *authority\_name*, looks up the subject number for *subject\_name*, subscribes to that subject, and begins receiving and printing messages on that subject until terminated by **amsstop**.

A configuration server for the local continuum and a registrar for the root unit of the indicated venture (which may both be instantiated in a single **amsd** daemon task) must be running in order for **amssub** to run.

## EXIT STATUS

- \-1

  **amssub** terminated with an error as noted in the ion.log file.

- "0"

  **amssub** terminated normally.

## FILES

The **amssub** source code is in the amspubsub.c source file.

A MIB initialization file with the applicable default name (see [*amsrc*(5)](/amsrc/5.md)) must be present.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

- amssub can't register.

  **amssub** failed to register, for reasons noted in the ion.log file.

- amssub: subject is unknown

  **amssub** can't subscribe to messages on the specified subject; possibly an error in the MIB initialization file.

- amssub can't subscribe.

  **amssub** failed to subscribe, for reasons noted in the ion.log file.

- amssub can't get event.

  **amssub** failed to receive message, for reasons noted in the ion.log file.

## BUGS

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

## SEE ALSO

[*amspub*(1)](/amspub/1.md), [*amsrc*(5)](/amsrc/5.md)