cjlistres (list resources)

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]

To Page Top

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.

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.

-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.

To Page Top

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

To Page Top

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
...

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 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.

To Page Top