<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<refentry id="create-audit-module-1">
<!-- @(#)create-audit-module.1 1.9 07/04/25 SMI; -->
<refmeta><refentrytitle>create-audit-module</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-audit-module</primary></indexterm>
<indexterm><primary>adds an audit-module</primary></indexterm>
<refname>create-audit-module</refname><refpurpose>adds an audit-module</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-audit-module </command>  <option role="double-dash">classname
</option> <replaceable>classname</replaceable>&synopsis-common;
 [<option role="double-dash">property</option>(name=value)[:name=value]*]
 [<option role="double-dash">target</option> <replaceable>target_name</replaceable>] <replaceable>
audit_module_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></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 role="options"><title></title>
<variablelist termlength="medium">
<varlistentry><term><option role="double-dash">classname</option></term>
<listitem><para>Java class which implements this audit module.</para>
</listitem>
</varlistentry>&options-common;
<varlistentry><term><option role="double-dash">property</option></term>
<listitem><para>optional attributes name/value pairs of provider implementation
specific attributes.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>Specifies the target on which you are creating the audit module.
Valid values are</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for creating the audit module. <literal>server</literal> is
the name of the default server instance and is the default value for this
option. </para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the audit module.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a particular cluster as the target for creating the audit module.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular server instance as the target<?Pub Caret> for creating the audit
module.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></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 role="examples"><title></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 role="exit-status"><title></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 role="see-also"><title></title>
<para><olink targetdoc="ASREFMAN" targetptr="delete-audit-module-1">delete-audit-module(1)
</olink>, <olink targetdoc="ASREFMAN" targetptr="list-audit-modules-1">list-audit-modules(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000004203 0>
