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)]