blob: 0f587c227e3d6c82307ed5017af42e1f90c060e0 [file] [log] [blame]
type=page
status=published
title=jms-ping
next=list.html
prev=install-node-ssh.html
~~~~~~
jms-ping
========
[[jms-ping-1]][[GSRFM00144]][[jms-ping]]
jms-ping
--------
checks if the JMS service is up and running
[[sthref1275]]
Synopsis
[source,oac_no_warn]
----
asadmin [asadmin-options] jms-ping [--help]
[-- target target]
----
[[sthref1276]]
Description
The `jms-ping` subcommand checks if the Java Message Service (JMS)
service (also known as the JMS provider) is up and running. When you
start the \{product---name}, the JMS service starts by default.
The `jms-ping` subcommand pings only the default JMS host within the JMS
service. It displays an error message when it is unable to ping a
built-in JMS service.
This subcommand is supported in remote mode only. Remote `asadmin`
subcommands require a running domain administration server (DAS).
[[sthref1277]]
Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--target`::
Specifies the target for which the operation is to be performed. Valid
values are as follows: +
`server`;;
Pings the JMS service for the default server instance. This is the
default value
configuration-name;;
Pings the JMS service for all clusters using the specified
configuration.
cluster-name;;
Pings the JMS service for the specified cluster.
instance-name;;
Pings the JMS service for the specified server instance.
[[sthref1278]]
Examples
[[GSRFM630]][[sthref1279]]
Example 1   Verifying that the JMS service is running
The following subcommand checks to see if the JMS service is running on
the default server.
[source,oac_no_warn]
----
asadmin> jms-ping
JMS-ping command executed successfully
Connector resoure test_jms_adapter created.
Command jms-ping executed successfully.
----
[[sthref1280]]
Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref1281]]
See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-jms-host.html#create-jms-host-1[`create-jms-host`(1)],
link:delete-jms-host.html#delete-jms-host-1[`delete-jms-host`(1)],
link:list-jms-hosts.html#list-jms-hosts-1[`list-jms-hosts`(1)]