cjlistapp (list applications)

Format

For all applications

cjlistapp [server-name] [-nameserver provider-URL]

For an EJB-JAR or WAR file contained in an application

cjlistapp [server-name] [-nameserver provider-URL] 
     -name J2EE-application-name -type {ejb|war}
     [-resname display-name]

For a RAR file included in an application

cjlistapp [server-name] [-nameserver provider-URL] 
     -name J2EE-application-name -type rar
     [-spec | -resname display-name -outbound| -resname display-name -inbound| -resname display-name -listenertype message-listener-type-name]

To Page Top

Function

For all applications

This command outputs the list of names, status, and modes of all the J2EE applications to the standard output. For an application in the exploded archive format, the application directory path is also output to the standard output. Also, in the case of WAR applications, the context root is output to the standard output.

For the EJB-JAR or WAR files included in an application

This command outputs the list of EJB-JAR or WAR files included in the J2EE application as the standard output.

If -resname is specified, the list of resources included in the EJB-JAR file (Session Bean, Entity Bean, or Message-driven Bean) or the list of resources contained in the WAR file (servlet/JSP, or filter) are output as the standard output.

For the RAR files included in an application

This command outputs the list of RAR files included in the J2EE application as the standard output.

If -spec is specified, the version of the connector architecture specification for RAR file is output as the standard output.

If you specify -resname and -outbound Connector 1.5 resource adapter, a list of connection definition identifiers for the outbound resource adapter included in the RAR file will output as the standard output. You cannot specify -resname and -outbound in the Connector 1.0 resource adapter.

If you specify -resname and -inbound in the Connector 1.5 resource adapter, a list of the types of message listeners of the inbound resource adapter included in the RAR file will output as the standard output. You cannot specify -resname and -inbound in Connector 1.0 resource adapters.

If you specify -resname and -listenertype in the Connector 1.5 resource adapter, a list of property names that you must set up for activating the specified message listeners will output as the standard output. You cannot specify -resname and -listenertype in Connector 1.0 resource adapters.

To Page Top

Arguments

server-name

Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.

-nameserver provider-URL

Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:

protocol-name: : host-name: port-number

For details on the specification items, see 2.1.2 Provider URL.

-name J2EE-application-name

Specifies the name of the J2EE application.

-type {ejb|war|rar}

Specifies the type of resource to be displayed:

• ejb: EJB-JAR file

• war: WAR file

• rar: RAR file

-resname display-name

Specifies the display name of the resources (EJB-JAR, WAR, or RAR file) to be displayed.

-spec

Specify this argument for displaying the connector architecture version.

One of the following connector architecture versions is displayed:

• Connector 1.0

• Connector 1.5

-outbound

Specify this argument along with -resname to display the connection definition identifier of the Outbound resource adapter included in the RAR file.

-inbound

Specify this argument along with -resname to display the types of message listeners of the Inbound resource adapter included in the RAR file.

-listenertype message-listener-type-name

Specify this argument along with -resname to display the property names that you must set up for activating the specified message listeners.

To Page Top

Input examples

For all applications

cjlistapp MyServer

For EJB-JAR files

cjlistapp MyServer -name App1 -type ejb

For a WAR file

cjlistapp MyServer -name App1 -type war -resname account-war

For a RAR file

cjlistapp MyServer -name App1 -type rar

To Page Top

Output format

For all J2EE applications

J2EE-application-status J2EE-application-mode J2EE-application-name (path=application-directory-path)#
J2EE-application-status J2EE-application-mode J2EE-application-name (path=application-directory-path)#
...

J2EE-application-status

• running: Running

• stopped: Stopped

• stopFailure: Normal termination failure

• forceStopFailure: Forced termination failure

• blockadeFailure: Blockade failure

• blockading: Blockading

• blockade: Blockade

• stopping: Undergoing normal termination

• forceStopping: Undergoing forced termination

J2EE-application-mode

• test: Operating in test mode (Compatibility mode with the previous version)

• (Space): Operating in normal mode

#

The information for path=application-directory-path is output only for an application in exploded archive format. This information is not output for an application in archive format.

For EJB-JAR files (-resname not specified)

EJB-JAR-file-display-name
EJB-JAR-file-display-name
...

For an EJB-JAR file (-resname specified)

Enterprise-Bean-display-name
Enterprise-Bean-display-name
...

For WAR files (-resname not specified)

WAR-file-display-name
WAR-file-display-name
...

For a WAR file (-resname specified)

servlet/JSP-display-name, filter-display-name
servlet/JSP-display-name, filter-display-name
...

For a RAR file (-resname and -spec not specified)

RAR-file-display-name
RAR-file-display-name
...

For a RAR file (-spec specified)

Connector-architecture-specification-version RAR-file-display-name
Connector-architecture-specification-version RAR-file-display-name
...

For a RAR file (-resname and -outbound specified)

Connection-definition-identifier
Connection-definition-identifier
...

For RAR files (-resname and -inbound specified)

Message-listener-type
Message-listener-type
...

For RAR files (-resname and -listenertype specified)

Property-name
Property-name
...

To Page Top

Return values

0:

The command terminated normally.

1:

The command terminated abnormally.

3:

A timeout occurred.

9:

The command could not be executed because there are no administrator privileges (in Windows).

To Page Top

Notes

• When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify J2EE-application-name -name); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -name ejb -type J2EE-application-name).

• When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).

• The files or resources in the listing are sorted in ascending order; file names are not case sensitive.

To Page Top