cjlistres (list resources)
- Organization of this page
Format
- For resources other than RAR file
cjlistres [server-name] [-nameserver provider-URL] -type {ejb|war|datasource|mail} [-resname display-name]
- For RAR file resources
cjlistres [server-name] [-nameserver provider-URL] -type rar [-spec| -resname display-name -outbound | -resname display-name -inbound | -resname display-name -listenertype message-listener-type-name]
Function
- For resources other than RAR file
-
This command outputs the list of imported EJB-JAR, WAR, data source files, or mails as the standard output.
- For RAR file resources
-
This command outputs the list of imported RAR files to the standard output.
If you specify -spec, the version of Connector-architecture specification for RAR files is output as the standard output.
If you specify -resname and -outbound in the Connector 1.5 resource adapter, a list of connection definition identifiers for the outbound resource adapter included in the deployed RAR file will output as the standard output. You cannot specify -resname and -outbound in Connector 1.0 resource adapters.
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 deployed 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.
- -type {ejb|war|datasource|mail|rar}
-
Specifies the type of resource to be displayed:
-
ejb: EJB-JAR files
-
war: WAR files
-
datasource: Data source files
-
mail: Mail
-
rar: RAR files
-
- -resname display-name
-
Specifies the display names of resources (EJB-JAR, WAR, or RAR file) to be displayed.
If you specify -resname for EJB-JAR, WAR, or RAR file, the list of resources (for EJB-JAR file: Enterprise Bean, for WAR file: servlet/JSP or filter, for RAR file: connection definition identifier of the RAR file) included in each is output as the standard output.
- -spec
-
Specify this argument to display the Connector-architecture version.
One of the following Connector-architecture version is displayed:
-
Connector 1.0
-
Connector 1.5
-
- -outbound
-
Specify this argument along with -resname for displaying the connection definition identifier for 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 EJB-JAR files
cjlistres MyServer -type ejb
- For WAR files
cjlistres MyServer -type war
- For data source files
cjlistres MyServer -type datasource
- For mail
cjlistres MyServer -type mail
- For RAR files
cjlistres MyServer -type rar
Output 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 data source files
data-source-file-display-name data-source-file-display-name ...
- For mail
mail-display-name mail-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 a RAR file (-resname and -inbound specified)
Message-listener-type Message-listener-type ...
- For a RAR file (-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 provider-URL -nameserver); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver ejb -type provider-URL).
-
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 in the listing are sorted in ascending order; file names are not case sensitive.