PING CHANNEL

Compaq NSK HP OpenVMS i5/OS UNIX systems Windows z/OS
X X X X X CR

For an explanation of the symbols in the z/OS column, see Using commands in z/OS.

Use PING CHANNEL to test a channel by sending data as a special message to the remote queue manager, and checking that the data is returned. The data is generated by the local queue manager.

Notes:
  1. On z/OS, the command server and the channel initiator must be running.
  2. Where there is both a locally defined channel and an auto-defined cluster-sender channel of the same name, the command applies to the locally defined channel. If there is no locally defined channel but more than one auto-defined cluster-sender channel, the command applies to the channel that was last added to the local queue manager's repository.
  3. On HP-UX and Linux it is not possible to ping an SSL channel using runmqsc.

This command can be used only for sender (SDR), server (SVR), and cluster-sender (CLUSSDR) channels (including those that have been defined automatically). It is not valid if the channel is running; however, it is valid if the channel is stopped or in retry mode.

Synonym: PING CHL

Read syntax diagramSkip visual syntax diagramPING CHANNEL

>>-PING CHANNEL(channel-name)----------------------------------->

   .-CMDSCOPE(' ')------------. (2)
>--+--------------------------+--------------------------------->
   |                     (1)  |
   +-CMDSCOPE(qmgr-name)------+
   |             (1)          |
   '-CMDSCOPE(*)--------------'

   .-CHLDISP(PRIVATE)--------. (2)   .-DATALEN(16)------.
>--+-------------------------+-------+------------------+------><
   |                 (1)     |       '-DATALEN(integer)-'
   +-CHLDISP(SHARED)---------+
   |                    (1)  |
   '-CHLDISP(FIXSHARED)------'

Notes:
  1. Valid only when the queue manager is a member of a queue-sharing group.
  2. Valid only on z/OS.