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)) 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), amsrc(5)