Configuring the administrative REST API gateway
By default, the administrative REST API gateway is enabled. When the administrative REST API gateway is enabled, you can perform remote administration with the REST API by using a gateway queue manager. You can configure the queue manager that is used as the default gateway queue manager, or you can prevent remote administration by disabling the administrative REST API gateway, by using the setmqweb properties command.
About this task
You must be a privileged user to complete this procedure.
dspmqweb properties -a
The mqRestGatewayEnabled
field
shows whether the gateway is enabled, and mqRestGatewayQmgr
field shows the name of
the default gateway queue manager. For more information, see dspmqweb.- A queue manager is not specified in the
ibm-mq-rest-gateway-qmgr
header of a REST request. - The queue manager that is specified in the REST API resource URL is not a local queue manager.
For more information about remote administration with the REST API, see Remote administration using the REST API.
Before issuing either the setmqweb or dspmqweb commands on z/OS®, you must set the WLP_USER_DIR environment variable, so that the variable points to your mqweb server configuration.
export WLP_USER_DIR=WLP_user_directory
where
WLP_user_directory
is the name of the directory that is passed
to crtmqweb.sh
. For
example:export WLP_USER_DIR=/var/mqm/web/installation1
For more information, see Create the Liberty server definition.