== Subscribe Tool ==

*subscribe* is the name of a small tool written in javascript using [http://www.mozilla.org/rhino/ Rhino], for initializing [wiki:JavaMail mail node] subscriptions to a [wiki:SpamZilla/Services/Controller controller].  This tool is temporary and subject to quick deprecation, so the documentation will remain limited.

The subscribe class is distributed in the spamzilla.jar archive.  To use the subscribe tool, simply make sure that spamzilla.jar (And it's dependencies, including axis.jar and js.jar) are in your {{{CLASSPATH}}}.  You may also specify them explicitly through the {{{-classpath}}} java command line option.  subscribe also uses the JavaMail configuration classes, and reads the [wiki:JavaMail/Properties#SubscriptionOptions subscription options] from the spamzilla properties file.

To run the subscribe tool.
{{{
java -Dspamzilla.properties=properties.xml subscribe
}}}

The level of output is dependent upon the current [wiki:JavaMail/Logging log settings], however the entire SOAP Response envelope for each subscription in the configuration file should be printed to standard output.