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 <https://github.com/nasa-jpl/ION-DTN/issues>
SEE ALSO
amspub(1), amsrc(5)