164/461

## list-components

lists deployed components

Synopsis

    list-components [--help]
    [--long={false|true}] [--resources] [--subcomponents]
    [--type type] [target]

Description

Note:

The `list-components` subcommand is deprecated. Use the `list-applications` subcommand instead.

The `list-components` subcommand lists all deployed Java EE components.

If the `--type` option is not specified, all components are listed. If the type option is specified, you must specify a type. The possible types are listed in the Options section in this help page.

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 "Module and Application Versions" in Oracle GlassFish Server Application Deployment Guide.

This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--long`

  If `true`, displays whether each module or application listed is enabled. The default is `false`.

`--resources`

  Lists the application-scoped resources for each component. If the `--subcomponents` option is also used, lists the application-scoped resources for each component within an application.

`--subcomponents`

  Lists the subcomponents of each component. The subcomponents listed depend on the component type. For example, for a Java EE application (EAR file), modules are listed. For a web application, servlets and JSP pages are listed. For an EJB module, EJB subcomponents are listed.

`--type`

  Specifies the type of the components that are to be listed. The options are as follows:

  - `application`

  - `appclient`

  - `connector`

  - `ejb`

  - `web`

  - `webservice`

  If no type is specified, all components are listed.

Operands

target

  This is the name of the target upon which the subcommand operates. The valid values are:

  `server`

    Lists the components for the default server instance `server` and is the default value.

  `domain`

    Lists the components for the domain.

  cluster_name

    Lists the components for the cluster.

  instance_name

    Lists the components for a particular stand-alone server instance.

Examples

Example 1 Listing Components

  This example lists the connector components. (`cciblackbox-tx.rar` was deployed.)

      asadmin> list-components --type connector
      cciblackbox-tx <connector>
      Command list-components executed successfully

Exit Status

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

list-applications(1), show-component-status(1)

asadmin(1M)

Oracle GlassFish Server Application Deployment Guide