NAME

       amsstop - Asynchronous Message Service (AMS) message space shutdown utility

SYNOPSIS

       amsstop application_name authority_name

DESCRIPTION

       amsstop is a utility program that terminates the operation of all registrars and all
       application modules running in the message space which is that portion of the indicated
       AMS venture that is operating in the local continuum.  If one of the amsd tasks that are
       functioning as registrars for this venture is also functioning as the configuration server
       for the local continuum, then that configuration server is also terminated.

       application_name and authority_name must identify an AMS venture that is known to operate
       in the local continuum, as noted in the MIB for the amsstop application module.

       A message space can only be shut down by amsstop if the subject "amsstop" is defined in
       the MIBs of all modules in the message spaces.

EXIT STATUS

       "0" amsstop terminated normally.

       "1" An anomalous exit status, indicating that amsstop was unable to register and therefore
           failed to shut down its message space, for reasons noted in the ion.log file.

FILES

       A MIB initialization file with the applicable default name (see amsrc(5) and amsxml(5))
       must be present.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       The following diagnostics may be issued to the ion.log log file:

       amsstop can't register.
           This message indicates that amsstop was unable to register, possibly because the
           "amsstop" role is not defined in the MIB initialization file.

       amsstop subject undefined.
           This message indicates that amsstop was unable to stop the message space because the
           "amsstop" subject is not defined in the MIB initialization file.

       amsstop can't publish 'amsstop' message.
           This message indicates that amsstop was unable to publish a message on subject
           'amsstop' for reasons noted in the ion.log log file.

BUGS

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

SEE ALSO

       amsrc(5)