cjlistapp (list applications)
- Organization of this page
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]
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.
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.
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
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 ...
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).
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.