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)]