blob: bc75e40b721b710940b7ec21db0508608d091277 [file] [log] [blame]
type=page
status=published
title=list-application-refs
next=list-applications.html
prev=list-admin-objects.html
~~~~~~
= list-application-refs
[[list-application-refs-1]][[GSRFM00147]][[list-application-refs]]
== list-application-refs
Lists the existing application references
[[sthref1300]]
=== Synopsis
[source]
----
asadmin [asadmin-options] list-application-refs [--help]
[--long={false|true}] [target]
----
[[sthref1301]]
=== Description
The `list-application-refs` subcommand lists all application references
in a cluster or an unclustered server instance. This effectively lists
all the modules deployed on the specified target (for example, J2EE
applications, Web modules, and enterprise bean modules).
If multiple versions of a module or application are deployed, this
subcommand lists all versions. To list which version is enabled, set the
`--long` option to `true`. For more information about module and
application versions, see "link:application-deployment-guide/overview.html#GSDPG00324[Module and Application
Versions]" in {productName} Application
Deployment Guide.
The target instance or instances making up the cluster need not be
running or available for this subcommand to succeed.
This subcommand is supported in remote mode only.
[[sthref1302]]
=== Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--long`::
If `true`, displays whether each module or application listed is
enabled. The default is `false`.
[[sthref1303]]
=== Operands
target::
The target for which you are listing the application references. Valid
values are
* `server`- Specifies the default server instance as the target.
`server` is the name of the default server instance and is the default value.
* cluster_name- Specifies a certain cluster as the target.
* instance_name- Specifies a certain server instance as the target.
[[sthref1304]]
=== Examples
[[GSRFM635]][[sthref1305]]
==== Example 1   Listing Application References
The following example lists the application references for the
unclustered server instance `NewServer`.
[source]
----
asadmin> list-application-refs NewServer
ClientSessionMDBApp
MEjbApp
__ejb_container_timer_app
Command list-application-refs executed successfully.
----
[[sthref1306]]
=== Exit Status
0::
command executed successfully
1::
error in executing the command
[[sthref1307]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-application-ref.html#create-application-ref-1[`create-application-ref`(1)],
link:delete-application-ref.html#delete-application-ref-1[`delete-application-ref`(1)]
link:application-deployment-guide.html#GSDPG[{productName} Application Deployment
Guide]