<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-audit-module-1">
<refmeta><refentrytitle>create-audit-module</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-audit-module">create-audit-module &mdash;
adds an audit-module</primary></indexterm><indexterm><primary sortas="adds an audit-module">
adds an audit-module &mdash; create-audit-module</primary></indexterm><refname>
create-audit-module</refname><refpurpose>adds an audit-module</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-audit-module </command><arg choice="plain">&Dash;&Dash;classname <replaceable>
classname</replaceable></arg>&synopsis-common;
<arg>&Dash;&Dash;property(name=value)[:name=value]*</arg><?Pub Caret><arg>&Dash;&Dash;target <replaceable>
target_name</replaceable></arg><arg choice="plain"><replaceable>audit_module_name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Adds the named audit module for the plug-in module that implements the
audit capabilities. This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">&Dash;&Dash;classname</option></term>
<listitem><para>Java class which implements this audit module.</para>
</listitem></varlistentry>&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;property</option></term>
<listitem><para>optional attributes name/value pairs of provider implementation
specific attributes.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>Specifies the target on which you are creating the audit module.
Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the audit module
for the default server instance <literal>server</literal> and is the default
value</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the audit module for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
audit module for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
audit module for a particular server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>audit_module_name</replaceable></term><listitem>
<para>name of this audit module.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-audit-module command</title>
<screen>asadmin> <userinput>create-audit-module --user admin1 --passwordfile password.txt 
--host pigeon --port 5001 --classname com.sun.appserv.auditmodule 
--property defaultuser=admin:Password=admin sampleAuditModule</userinput>
Command create-audit-module executed successfully</screen>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-audit-module-1"><citerefentry><refentrytitle>
delete-audit-module</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-audit-modules-1"><citerefentry><refentrytitle>list-audit-modules
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004322>
