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)