Ping MQ Channel (PNGMQMCHL)
- 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
| 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 we 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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i