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

# amspub(1)

Asynchronous Message Service (AMS) test driver for VxWorks

## NAME

amspub - Asynchronous Message Service (AMS) test driver for VxWorks

## SYNOPSIS

**amspub** "*application\_name*", "*authority\_name*", "*subject\_name*", "*message\_text*"

## DESCRIPTION

**amspub** is a message publication program designed to test AMS functionality in a VxWorks environment.  When an **amspub** 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*, publishes a single message with content *message\_text* on that subject, unregisters, and terminates.

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 **amspub** to run.

## EXIT STATUS

- \-1

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

- "0"

  **amspub** terminated normally.

## FILES

The **amspub** 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

- amspub can't register.

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

- amspub: subject is unknown

  **amspub** can't publish test messages on the specified subject; possibly an error in the MIB initialization file.

- amspub can't publish message.

  **amspub** failed to publish, for reasons noted in the ion.log file.

## BUGS

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

## SEE ALSO

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