<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY metainfo SYSTEM "metainfo.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-management-rule-1">
<refmeta><refentrytitle>create-management&ndash;rule</refentrytitle><manvolnum>
1</manvolnum>&metainfo;
</refmeta><?Pub Caret>
<refnamediv><indexterm><primary sortas="create-management-rule">create-management-rule &mdash;
creates a new management rule</primary></indexterm><indexterm><primary sortas="creates a management rule">
creates a new management rule &mdash; create-management-rule</primary></indexterm>
<refname>create-management-rule</refname><refpurpose>creates a new management
rule</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-management-rule</command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;ruleenabled=<option role="nodash">true</option></arg>
<arg choice="opt">&Dash;&Dash;ruledescription <replaceable>description</replaceable></arg>
<arg choice="opt">&Dash;&Dash;action <replaceable>action-mbean-name</replaceable></arg>
<arg choice="plain">&Dash;&Dash;eventtype log|timer|trace|monitor|cluster|lifecycle|notification
</arg><arg choice="opt">&Dash;&Dash;eventloglevel FINEST|FINER|FINE|CONFIG|INFO|WARNING|SEVERE|OFF
</arg><arg choice="opt">&Dash;&Dash;recordevent=true</arg><arg choice="opt">&Dash;&Dash;eventdescription<replaceable>
 description</replaceable></arg><arg choice="opt">&Dash;&Dash;eventproperties <arg
choice="plain">(property=value[:<replaceable>property=value</replaceable>]*)
</arg></arg><arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg>
<arg choice="plain"><replaceable>rule-name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-management-rule</command> creates a new management
rule to intelligently self-manage the application server installation and
deployed applications. </para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;ruleenabled </option></term>
<listitem><para>Determines whether the rule is enabled or not. Default value
is true.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;ruledescription </option></term>
<listitem><para>Provides the description of the rule.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;action</option></term>
<listitem><para>The action MBean associated with the event.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;eventtype</option></term>
<listitem><para>Identifies the configured event as one of the predefined event
types.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;eventloglevel</option></term>
<listitem><para> Specifies at what level to record the event occurance in
server log file. Default value is INFO.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;recordevent</option></term>
<listitem><para>Specifies whether the occurance of the event is to be logged
or not. Default value is true. If no action is specified, the event would
be logged.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;eventdescription</option></term>
<listitem><para>A description of the event.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;eventproperties</option></term>
<listitem><para>The properties defined for the event.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;<replaceable>target
</replaceable></option></term><listitem><para>This operand specifies the target
on which you are creating a management rule. Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which creates the management rule
for the default server instance <literal>server</literal> and is the default
value</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the management rule for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
management rule for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
management rule for a particular server instance</para>
</listitem>
</itemizedlist></para>
<para>&se-ee-only;</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>rule_name</replaceable></term><listitem>
<para>The name of the management rule.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>using create-management-rule command to create a monitor event</title>
<screen>asadmin> <userinput>create-management-rule --user admin 
--passwordfile adminpassword.txt --host localhost --port 4848 
--eventtype monitor --eventloglevel FINE 
--eventdescription "monitoring eventproperties" myRule1</userinput>
Command create-management-rule executed successfully</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="narrow">
<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-lifecycle-module-1"><citerefentry><refentrytitle>
delete-management-rule</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-lifecycle-modules-1"><citerefentry><refentrytitle>list-management-rules
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000006348>
