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
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
- 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.
- When invalid is output as the connection pool status, you must undeploy the member resource adapters, redeploy them, and then restart them. If the problem cannot be corrected, collect maintenance information and contact a maintenance engineer.