配置 messaging REST API 的連線模式

依預設，「 messaging REST API 」只會連接至與 mqweb 伺服器相同安裝中的本端佇列管理程式。您可以配置 messaging REST API 來變更連線模式，並啟用與遠端佇列管理程式的連線。

開始之前

若要完成此作業，必須是具有特定專用權的使用者，讓您可以使用 dspmqweb 及 setmqweb 指令：

注意:

在 z/OS上發出 setmqweb 或 dspmqweb 指令之前，您必須先設定 WLP_USER_DIR 環境變數，讓該變數指向您的 mqweb 伺服器配置。

若要設定 WLP_USER_DIR 環境變數，請發出下列指令:

export WLP_USER_DIR=WLP_user_directory

其中，WLP_user_directory 是傳遞至 crtmqweb 的目錄名稱。例如：

export WLP_USER_DIR=/var/mqm/web/installation1

如需相關資訊，請參閱建立 mqweb 伺服器。

使用下列指令來檢視 messaging REST API 的現行配置:
```
dspmqweb properties -a
```
mqRestMessagingConnectionMode 欄位顯示現行連線模式。如果值為 local，則 messaging REST API 只能連接至與 mqweb 伺服器相同安裝中的佇列管理程式。如果值為 remote，則「 messaging REST API 」可以連接至遠端佇列管理程式。
使用下列指令，將 mqweb 伺服器配置為僅容許 messaging REST API 連接至與 mqweb 伺服器相同安裝中的佇列管理程式:
```
setmqweb properties -k mqRestMessagingConnectionMode -v local
endmqweb
strmqweb
```
使用下列指令，將 mqweb 伺服器配置為容許 messaging REST API 連接至遠端佇列管理程式:
```
setmqweb properties -k mqRestMessagingConnectionMode -v remote
endmqweb
strmqweb
```

如果您將 mqweb 伺服器配置為容許「 messaging REST API 」連接至遠端佇列管理程式，則必須提供您要連接的每一個佇列管理程式的連線資訊。如需如何提供連線資訊的相關資訊，請參閱設定遠端佇列管理程式以與 messaging REST API搭配使用。