Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## list(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

#### NAME

list– lists the configurable elements

#### SYNOPSIS

`list` ––user admin_user [––passwordfile filename] [––host host_name] [––port port_number] [––secure|`–s`] [––terse=false] [––echo=false] [––interactive=true] [––help] [––monitor=[true|false]] [dotted_parent_attribute_name]

#### DESCRIPTION

Lists the configurable element. On Solaris, quotes are needed when executing commands with * as the option value or operand.

The dotted notation follows these guidelines:

- Any `list` command that has a dotted name that is not followed by a wildcard (*) will get, as its result, the current node's immediate children. For example, `list` `--monitor` `server` lists all immediate children belonging to the server node.

- Any `list` command that has a dotted name followed by a wildcard(*) will get, as its result, a hierarchical tree of children nodes from the current node. For example, `list` `--monitor` `server.applications.*` will list all children of applications and their subsequent child nodes and so on.

- Any `list` command that has a dotted name preceded or followed by a wildcard (*) of the form *dotted name or dotted * name or dotted name* will get, as its result, all nodes and their children matching the regular expression created by the provided matching pattern.

#### OPTIONS

`–u` `––user`

  The authorized domain application server administrative username.

`–w` `––password`

  The `––password` option is deprecated. Use `––passwordfile` instead.

`––passwordfile`

  This option replaces the `–– password` option. Using the `––password` option on the command line or through the environment is deprecated. The `––passwordfile` option specifies the name of a file containing the password entries in a specified format. The entry for the password must have the AS_ADMIN_ prefix followed by the password name in capital letters. For example, to specify the domain application server password, use an entry with the following format: `AS_ADMIN_PASSWORD`=password, where password is the actual administrator password. Other passwords that can be specified include AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD, AS_ADMIN_SAVEDMASTERPASSWORD, AS_ADMIN_MQPASSWORD, AS_ADMIN_ALIASPASSWORD, and so on.

`–H` `––host`

  The machine name where the domain application server is running. The default value is localhost.

`–p` `––port`

  The port number of the domain application server listening for administration requests. The default port number for Enterprise Edition is 4849.

`–s` `––secure`

  If set to true, uses SSL/TLS to communicate with the domain application server.

`–t` `––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

`–e` `––echo`

  Setting to true will echo the command line statement on the standard output. Default is false.

`–I` `––interactive`

  If set to true (default), only the required password options are prompted.

`–h` `––help`

  Displays the help text for the command.

`--monitor`

  defaults to false; if set to false, the configurable attribute values are returned. If set to true, the monitorable attribute values are returned.

#### OPERANDS

dotted_parent_element_name

  configurable or monitorable element name.

#### EXAMPLES

##### Example 1 Using `list` to view all dotted-name prefixes

    asadmin> list --user admin --passwordfile password.txt
    --port 5001 "*"
    server
    server.admin-service
    server.admin-service.das-config
    server.application-ref.MEjbApp
    server.application-ref.__ejb_container_timer_app
    server.application-ref.adminapp
    server.application-ref.admingui
    server.application-ref.com_sun_web_ui
    server.applications
    server.applications.j2ee-application.MEjbApp
    server.applications.j2ee-application.__ejb_container_timer_app
    server.applications.web-module.adminapp
    server.applications.web-module.admingui
    server.applications.web-module.com_sun_web_ui
    server.ejb-container
    server.http-service
    server.http-service.http-listener.admin-listener
    server.http-service.http-listener.http-listener-1
    server.http-service.http-listener.http-listener-2
    server.iiop-service
    server.iiop-service.iiop-listener.SSL
    server.iiop-service.iiop-listener.SSL.ssl
    server.iiop-service.iiop-listener.SSL_MUTUALAUTH
    server.iiop-service.iiop-listener.SSL_MUTUALAUTH.ssl
    server.iiop-service.iiop-listener.orb-listener-1
    server.iiop-service.orb
    server.java-config
    server.jms-service
    server.jms-service.jms-host.default_JMS_host
    server.log-service
    server.log-service.module-log-levels
    server.mdb-container
    server.monitoring-service
    server.monitoring-service.module-monitoring-levels
    server.resource-ref.jdbc/PointBase
    server.resource-ref.jdbc/__TimerPool
    server.resources
    server.resources.jdbc-connection-pool.PointBasePool
    server.resources.jdbc-connection-pool.__TimerPool
    server.resources.jdbc-resource.jdbc/PointBase
    server.resources.jdbc-resource.jdbc/__TimerPool
    server.security-service
    server.security-service.audit-module.default
    server.security-service.auth-realm.certificate
    server.security-service.auth-realm.file
    server.security-service.jacc-provider.default
    server.thread-pools
    server.thread-pools.thread-pool.thread-pool-1
    server.transaction-service
    server.virtual-server.__asadmin
    server.virtual-server.server
    server.web-container

##### Example 2 Using `list` for an application

    asadmin> list --user admin --passwordfile password.txt
    --host localhost --port 4848 server.applications.j2ee-application
    server.applications.j2ee-application.MEjbApp
    server.applications.j2ee-application._ejb_container_timer_app
    server.applications.j2ee-application.stateless-simple

##### Example 3 Using `list` for a web module

    asadmin> list --user admin --passwordfile password.txt
    --host localhost --port 4848 server.applications.web-module
    server.applications.web-module.adminapp
    server.applications.web-module.adminguip
    server.applications.web-module.com_sun_web_ui

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

get(1), set(1)

J2EE SDK 1.4 Last Revised 31 Jan 2005

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates