DeepSeek补全IBM MQ 9.4 REST API 执行命令的PPT

DeepSeek补全了我在网上找到的PPT的一页内容，帮了大忙了。

人机协同，人工智能可以协助人更好的做事。

下面的内容是讲解IBM MQ REST API 执行IBM MQ命令的PPT: MQSC for REST Tailored RESTful support for individual MQ objects and actions are in the works... However, to speed up full MQ admin support over REST we will be adding the ability to submit arbitrary MQSC commands over REST Gives complete MQSC coverage quickly Simple to convert existing scripts Does not benefit from improved usability HTTPS POST: https://host:port/ibmmq/v1/admin/action/qmgr/QMGR1/mqsc { "type": "runCommand", "parameters": { "command": "STOP CHANNEL(CHANNEL.TEST)" } } { "commandResponse": ${ "completionCode": 0, "reasonCode": 0, "text": \["AMQ8019: Stop IBM MQ channel accepted."$ }], "overallCompletionCode" : 0, "overallReasonCode" : 0 } Stopping a channel 但是我不知道完成的可执行的命令，如下所示： curl -k "https://localhost:9443/ibmmq/rest/v1/admin/qmgr/QM1/channel/TO.QM2" \ -X GET \ -u mqadmin:tgb5YHN6 请把上面的PPT改为可执行的命令

根据您提供的PPT内容，IBM MQ REST API 支持通过 MQSC 命令执行管理操作。以下是可执行的命令和详细说明：

通过 REST API 执行 MQSC 命令的完整语法

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "DISPLAY CHSTATUS(CHAN1) TYPE(SVRCONN)"
           }
         }'

命令解析

HTTP 方法 ：POST (不是 GET)

URL 结构：

text

复制代码

https://<host>:<port>/ibmmq/rest/v1/admin/action/qmgr/<QMGR_NAME>/mqsc

认证：

bash

复制代码

-u "mqadmin:tgb5YHN6"  # 用户名:密码

请求头：

bash

复制代码

-H "Content-Type: application/json"  # 必须指定 JSON 内容类型

请求体：

json

复制代码

{
  "type": "runCommand",
  "parameters": {
    "command": "MQSC_COMMAND_HERE"
  }
}

查询通道状态的具体实现

1. 查询单个通道状态

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "DISPLAY CHSTATUS(CHAN1) TYPE(SVRCONN)"
           }
         }'

2. 查询所有通道状态

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "DISPLAY CHSTATUS(*) TYPE(SVRCONN)"
           }
         }'

响应解析示例

成功响应：

json

复制代码

{
  "commandResponse": [{
    "completionCode": 0,
    "reasonCode": 0,
    "text": [
      "AMQ8417: Display Channel Status details.",
      "   CHANNEL(CHAN1)                             TYPE(SVRCONN)",
      "   STATUS(RUNNING)                            SUBSTATE(RECEIVE)",
      "   ..."
    ]
  }],
  "overallCompletionCode": 0,
  "overallReasonCode": 0
}

其他常用 MQSC 命令示例

1. 启动通道

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "START CHANNEL(CHAN1)"
           }
         }'

2. 停止通道

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "STOP CHANNEL(CHAN1)"
           }
         }'

3. 重置通道

bash

复制代码

curl -k -X POST "https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc" \
     -u "mqadmin:tgb5YHN6" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "runCommand",
           "parameters": {
             "command": "RESET CHANNEL(CHAN1)"
           }
         }'

权限配置要求

在执行命令前，确保用户有足够权限：

bash

复制代码

# 授予 MQSC 命令执行权限
setmqaut -m QM1 -t qmgr -p mqadmin +connect +inq +ctrl
setmqaut -m QM1 -n SYSTEM.ADMIN.COMMAND.QUEUE -t queue -p mqadmin +put

错误处理

1. 401 未授权错误

json

复制代码

{"error": [{"msgId": "MQWB0105E", "reason": "2035"}]}

解决方案：检查用户权限并刷新安全设置

bash

复制代码

refresh security type(ssl)

2. 404 接口未找到

json

复制代码

{"error": [{"msgId": "MQWB0116E"}]}

解决方案：

确认使用正确的 URL 路径：/ibmmq/rest/v1/admin/action/qmgr/QM1/mqsc

检查 MQ Web 服务器配置：

xml

复制代码

<!-- mqwebuser.xml -->
<feature>restAdmin-1.0</feature>

3. 500 命令执行错误

json

复制代码

{
  "commandResponse": [{
    "completionCode": 2,
    "reasonCode": 2085,
    "text": ["AMQ8147: Web request for MQSC command ended with reason code 2085."]
  }]
}

解决方案：检查命令语法是否正确

自动化脚本示例

bash

复制代码

#!/bin/bash

QMGR="QM1"
CHANNEL="CHAN1"
USER="mqadmin"
PASS="tgb5YHN6"
URL="https://localhost:9443/ibmmq/rest/v1/admin/action/qmgr/$QMGR/mqsc"

# 查询通道状态
response=$(curl -s -k -X POST "$URL" \
  -u "$USER:$PASS" \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"runCommand\",\"parameters\":{\"command\":\"DISPLAY CHSTATUS($CHANNEL) TYPE(SVRCONN)\"}}")

# 检查状态码
overall_code=$(echo "$response" | jq -r '.overallCompletionCode')
if [ "$overall_code" != "0" ]; then
  echo "错误：命令执行失败"
  echo "$response" | jq .
  exit 1
fi

# 提取状态信息
status=$(echo "$response" | grep -oP 'STATUS\(\K[^)]+' | head -1)

# 检查通道状态
if [[ "$status" == "STOPPED" || "$status" == "RETRYING" ]]; then
  echo "警报：通道 $CHANNEL 状态异常 ($status)"
  # 发送警报邮件...
fi

注意事项

版本兼容性：
- REST API v1 适用于 IBM MQ 9.1.4+
- 确保使用 v1 而不是 v3 路径
命令限制：
- 不支持交互式命令
- 命令长度限制为 4096 字符
- 每个请求只能执行一个命令
性能考虑：
- 频繁调用可能影响性能
- 复杂操作建议使用原生 MQSC

安全建议：

bash

复制代码

# 使用更安全的证书认证
curl --cert client.pem --key client.key -X POST ...

通过这种 REST API 方式，您可以完全控制 IBM MQ 管理操作，同时保持与现代应用程序的集成能力。