<!--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;
]>
<!--Arbortext, Inc., 1988-2007, v.4002-->
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="configure-webservice-management-1">
<!-- @(#)configure-webservice-management.1 1.11 07/07/25 SMI; -->
<refmeta><refentrytitle>configure-webservice-management</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="date">16 July 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>configure-webservice-management</primary>
</indexterm><indexterm><primary>sets the monitoring or maxhistorysize attributes
of a deployed webservice</primary></indexterm>
<refname>configure-webservice-management</refname><refpurpose>sets the monitoring
or maxhistorysize attributes of a deployed web service</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>configure-webservice-management </command> &synopsis-common;
 [<option role="double-dash">monitoring</option> = {<replaceable>OFF | LOW | HIGH
</replaceable>}] [<option role="double-dash">maxhistory</option> <replaceable>maxhistory-size
</replaceable>] <replaceable> webservice-end-point</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Use this command to configure the monitoring or the maxhistory attributes
of a deployed webservice.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="wide">&options-common;
<varlistentry><term><option role="double-dash">monitoring</option></term>
<listitem><para>Enables monitoring for webservices. If enabled, tracks operational
statistics, such as the number of requests per second, average response time,
and throughput. Allowed values are:</para>
<itemizedlist>
<listitem><para><literal>LOW</literal>: Enables monitoring for the whole webservice.
No method level monitoring will be done. </para></listitem>
<listitem><para><literal>HIGH</literal>: Message Trace is also enabled in
addition to enabling number of requests per second, average response time,
and throughput attributes.</para></listitem>
<listitem><para><literal>OFF</literal>: Disables monitoring and this is the
default.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">maxhistorysize</option></term>
<listitem><para> indicates the maximum number of monitoring records stored
in history for this web service endpoint. Default value is 25.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>webservice-end-point</replaceable></term>
<listitem><para>name of the webservice endpoint to which the configuration
management attributes are being set. </para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>To turn on monitoring for a webservice endpoint</title>
<screen>asadmin> <userinput>configure-webservice-management --monitoring=LOW 
jaxrpc-simple#jaxrpc-simple.war#HelloIF</userinput>
Command configure-webservice-management executed successfully</screen>
</example>
<example><title>To turn message tracing facility on for a webservice endpoint</title>
<screen>asadmin> <userinput>configure-webservice-management --monitoring=HIGH 
--maxhistorysize=250 jaxrpc-simple#jaxrpc-simple.war#HelloIF</userinput>
Command configure-webservice-management executed successfully</screen>
</example>
<para>Where <filename>jaxrpc-simple#jaxrpc-simple.war#HelloIF</filename> is
the fully qualified name of a webservice endpoint.</para>
</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>
</refentry>
<?Pub *0000004411 0>
