[IBM i]

PNGMQMCHL (Ping MQ Channel)

Where allowed to run
All environments (*ALL)
Threadsafe
Yes

The Ping MQ Channel (PNGMQMCHL) command tests a channel by sending data as a special message, to the remote message queue manager and checks that the data is returned. This command is successful only from the sending end of an inactive channel, and the data used is generated by the local message queue manager.

Parameters

Table 1. Command parameters
Keyword Description Choices Notes
CHLNAME Channel name Character value Required, Positional 1
MQMNAME Message Queue Manager name Character value, *DFT Optional, Positional 2
DATACNT Data count 16-32768, 64 Optional, Positional 3
CNT Count 1-16, 1 Optional, Positional 4

Channel name (CHLNAME)

Specifies the name of the channel definition.

The possible values are:

channel-name
Specify the channel name.

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

The possible values are:

*DFT
The default queue manager is used. If you do not have a default queue manager defined on the system, the command fails.
message-queue-manager-name
The name of a message queue manager.

Data count (DATACNT)

Specifies the length of the data in bytes. The actual number of bytes might be less than the amount requested depending on the operating system and communication protocol being used.

The possible values are:

64
The default value is 64 bytes.

data-count Specify a value ranging from 16 through 32768.

Count (CNT)

Specifies the number of times that the channel is to be pinged.

The possible values are:

1
The channel is pinged once.

ping-count Specify a value ranging from 1 through 16.