blob: 5fe8b5255ce6f48c0c034e9ff36ef439ecba02cc [file] [log] [blame]
type=page
status=published
title=list-resource-refs
next=list-secure-admin-internal-users.html
prev=list-resource-adapter-configs.html
~~~~~~
= list-resource-refs
[[list-resource-refs-1]][[GSRFM00197]][[list-resource-refs]]
== list-resource-refs
Lists existing resource references
[[sthref1779]]
=== Synopsis
[source]
----
asadmin [asadmin-options] list-resource-refs [--help]
[target]
----
[[sthref1780]]
=== Description
The `list-resource-refs` subcommand lists all resource references in a
cluster or an unclustered server instance. This effectively lists all
the resources (for example, JDBC resources) available in the JNDI tree
of the specified target.
The target instance or instances in the cluster need not be running or
available for this subcommand to succeed.
This subcommand is supported in remote mode only.
[[sthref1781]]
=== 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.
[[sthref1782]]
=== Operands
target::
The target for which you are listing the resource references. Valid
targets are as follows:
`server`;;
Lists the resource references for the default server instance and is
the default target.
cluster_name;;
Lists the resource references for every server instance in the
cluster.
instance_name;;
Lists the resource references for the named unclustered server
instance.
[[sthref1783]]
=== Examples
[[GSRFM707]][[sthref1784]]
==== Example 1   Listing Resource References for a Cluster
This example lists resource references for the cluster `cluster1`.
[source]
----
asadmin> list-resource-refs cluster1
jms/Topic
Command list-resource-refs executed successfully.
----
[[sthref1785]]
=== Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref1786]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-resource-ref.html#create-resource-ref-1[`create-resource-ref`(1)],
link:delete-resource-ref.html#delete-resource-ref-1[`delete-resource-ref`(1)]