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)