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