<!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 EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="list-jbi-service-engines-1">
<refmeta><refentrytitle>list-jbi-service-engines</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="list-jbi-service-engines">list-jbi-service-engines &mdash; lists the service engines installed on the specified target</primary></indexterm><indexterm><primary sortas="lists the service engines installed on the specified target">lists the service engines installed
on the specified target &mdash; list-jbi-service-engines</primary></indexterm><refname>list-jbi-service-engines</refname><refpurpose>lists the service engines installed on the specified target</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>list-jbi-service-engines</command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;lifecyclestate <replaceable>shutdown|started|stopped</replaceable></arg><arg choice="opt">&Dash;&Dash;libraryname <replaceable>shared_library_name</replaceable></arg><arg choice="opt">&Dash;&Dash;assemblyname <replaceable>service assembly name</replaceable></arg><arg choice="opt">&Dash;&Dash;target <replaceable>
target</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>list-jbi-service-engines</command> command lists the service engines installed on the specified target. If no filters are specified, the command will list all the installed service engines. </para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;lifecyclestate</option></term><listitem><para>Helps list the service engines based on its current state. For example, if you want to list only those service engines that are started, you can specify &ndash;lifecyclestate started.  By default, all service
engines are listed, regardless of their states. Valid values for this option are:<itemizedlist>
<listitem><para><literal>shutdown</literal>, which lists all the service engines that are currently shutdown on the specified target.</para>
</listitem>
<listitem><para><literal>started</literal>, which lists all the service engines that are in the 'started' state on the specified target.</para>
</listitem>
<listitem><para><literal>stopped</literal>, which lists all the service engines on the specified target that are not running.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;libraryname</option></term><listitem><para>Helps list the service engines that currently use the specified library. </para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;assemblyname</option></term><listitem><para>Helps list the service engines that have a service unit deployed as part of the service assembly unit with the specified service assembly name. </para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term><listitem><para>Specifies the target for which you want to list the JBI service engines. Specify this option only if the service engines are deployed in a multiserver environment with a Domain Administration Server (DAS). If the
service engines are not deployed in a multiserver environment with a DAS, this option is ignored. Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which lists the service engines on the embedded DAS instance. This is the default value.</para>
</listitem>
<listitem><para><literal>domain</literal>, which lists the service engines for the administrative domain itself. Specify <literal>domain</literal> only if you are using the cluster profile.</para><?Pub Caret>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which lists the service engines for every server instance in the cluster.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which lists the service engines for the named unclustered server instance.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the list-jbi-service-engines command</title>
<para>The following command lists the JBI service engines.</para>
<screen>asadmin> <userinput>list-jbi-service-engines --user admin2
--passwordfile passwords.txt --lifecyclestate started 
--assemblyname serviceassembly1 --target server1</userinput>
Command list-jbi-service-engines executed successfully.</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</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="install-jbi-component-1"><citerefentry><refentrytitle>install-jbi-component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="delete-application-ref-1"><citerefentry><refentrytitle>list-jbi-binding-components</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="delete-application-ref-1"><citerefentry><refentrytitle>stop-jbi-component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="delete-application-ref-1"><citerefentry><refentrytitle>shut-down-jbi-component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="delete-application-ref-1"><citerefentry><refentrytitle>uninstall-jbi-component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="upgrade-jbi-component-1"><citerefentry><refentrytitle>upgrade-jbi-component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000006522>
