blob: 11d37af96ccde1a166c6d14a2da5cc0a49e8d937 [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]
----
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 {productName}, 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]
----
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)]