cjlistrar (list resource adapters)

Format

For displaying the resource adapter status

cjlistrar [server-name] [-nameserver provider-URL]
    [-clusterpool] [-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 a resource adapter is a member of a cluster connection pool, the status of the connection pool is also displayed.
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.
-clusterpool
Specifies that the status of the connection pool is to be displayed. This argument is effective when the cluster connection pool is used.
-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 -clusterpool 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 -clusterpool is specified

resource-adapter-status connection-pool-status resource-adapter-name
resource-adapter-status connection-pool-status resource-adapter-name
...

One of the following values is displayed:
  • running: Running
  • runningReserved: Running reserved
  • resumingAutomatically: Restarting automatically
  • resumingManually: Restarting manually
  • blockedAutomatically: Blocked automatically
  • blockedManually: Blocked manually
  • suspendedAutomatically: Suspended automatically
  • suspendedAutomaticallyReserved: Suspended automatically reserved
  • suspendedManually: Suspended manually
  • suspendedManuallyReserved: Suspended manually reserved
  • invalid: Invalid
  • N/A: The adapter is not a member resource adapter
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 -clusterpool and -spec are specified

Resource-adapter-status Connection-pool-status Connector-architecture-specification-version resource-adapter-name
Resource-adapter-status Connection-pool-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 Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista).

Notes