cjlistrar (list resource adapters)
- Organization of this page
Format
- For displaying the resource adapter status
cjlistrar [server-name] [-nameserver provider-URL] [-spec]
- For displaying the list of connection definition identifiers
cjlistrar [server-name] [-nameserver provider-URL] -resname resource-adapter-display-name -outbound
- For displaying the list of message listener types
-resname resource-adapter-display-name -inbound
- For displaying the list of property names that must be set up for activation
-resname resource-adapter-display-name -listenertype message-listener-type-name
Function
- For displaying the resource adapter status
-
This command outputs to the standard output the names and statuses of all deployed resource adapters.
If you specify -spec, the version of Connector-architecture specification for RAR file is output as the standard output.
- For displaying the list of connection definition identifiers
-
If you specify -resname and -outbound 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.
- -spec
-
Specify this argument to display the Connector-architecture version.
One of the following Connector-architecture versions is displayed:
-
Connector 1.0
-
Connector 1.5
-
- -resname resource-adapter-display-name
-
Specifies the name of resource adapter to be displayed.
- -outbound
-
Specify this argument along with -resname to display 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.
Output format
- When -spec is not specified
resource-adapter-status resource-adapter-name resource-adapter-status resource-adapter-name ...
One of the following values is output for resource-adapter-status:
-
running: Running
-
stopped: Stopped
-
- When -spec is specified
Resource-adapter-status Connector-architecture-specification-version resource-adapter-name Resource-adapter-status Connector-architecture-specification-version resource-adapter-name ...
- When -resname and -outbound are specified
Connection-definition-identifier Connection-definition-identifier ...
- When -resname and -inbound are specified
Message-listener-type Message-listener-type ...
- When -resname and -listenertype are specified
Property-name Property-name ...
Input examples
cjlistrar MyServer
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. Specify the other arguments after 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 server-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 resource adapters in the listing are sorted in ascending order; resource adapter names are not case sensitive.