dspmqweb (display mqweb server configuration)
Display information about the status of the mqweb server, the configuration of the mqweb server, or the remote queue manager connection information for the IBM® MQ Console. The mqweb server is used to support the IBM MQ Console and REST API.
Using the command on z/OS
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 passed to
crtmqweb. For
example:export WLP_USER_DIR=/var/mqm/web/installation1
See Create the mqweb server for more information.
You must also set the JAVA_HOME environment variable to reference a 64 bit version of Java on your system.
Purpose - dspmqweb status
Use the dspmqweb command to view information about the status of the mqweb server.
The mqweb server must be running to use the IBM MQ Console or the administrative REST API. If the server is running then the available root context URLs and associated ports that are used by the IBM MQ Console and administrative REST API are displayed by the dspmqweb status command.
Purpose - dspmqweb remote
Use the dspmqweb remote command to view details of the remote queue manager connections that are configured for use with the IBM MQ Console.
Purpose - dspmqweb properties
Use the dspmqweb properties command to view details of the configuration of the mqweb server. It is not necessary for the mqweb server to be running.
- ltpaExpiration
- This configuration property is used to specify the time, in seconds, before the LTPA token expires.
- maxTraceFiles
- This configuration property is used to specify the maximum number of mqweb server log files that are generated by the mqweb server.
- maxTraceFileSize
- This configuration property is used to specify the maximum size, in MB, that each mqweb server log file can reach.
- mqConsoleMaxMsgCharsToDisplay
- This configuration property is used to specify the maximum characters to retrieve from each message when browsing a queue via the IBM MQ Console.
- mqConsoleMaxMsgRequestSize
- This configuration property is used to specify the maximum size, in MB, a browse request can be across all messages when browsing queues via the IBM MQ Console.
- mqConsoleMaxMsgsPerRequest
- This configuration property is used to specify the total number of messages to retrieve from a queue when browsing via the IBM MQ Console.
- mqRestCorsAllowedOrigins
- This configuration property is used to specify the origins that are allowed to access the REST API. For more information about CORS, see Configuring CORS for the REST API.
- mqRestCorsMaxAgeInSeconds
- This configuration property is used to specify the time, in seconds, that a web browser can cache the results of any CORS pre-flight checks.
- mqRestCsrfValidation
- This configuration property is used to specify whether CSRF validation checks are performed. A
value of
false
removes the CSRF token validation checks. - mqRestGatewayEnabled
- This configuration property is used to specify whether the administrative REST API gateway is enabled.
- mqRestGatewayQmgr
- This configuration property is used to specify the name of the queue manager to use as the gateway queue manager. This queue manager must be in the same installation as the mqweb server. A blank value indicates that no queue manager is configured as the gateway queue manager.
- mqRestMessagingEnabled
- This configuration property is used to specify whether the messaging REST API is enabled.
- mqRestMessagingFullPoolBehavior
- This configuration property is used to specify the behavior of the messaging REST API when all connections in the connection pool are in use.
- mqRestMessagingMaxPoolSize
- This configuration property is used to specify the maximum connection pool size for each queue manager connection pool.
- mqRestMftCommandQmgr
- This configuration property is used to specify the name of the command queue manager to which create transfer and create, delete, or update resource monitor requests are submitted by the REST API for MFT.
- mqRestMftCoordinationQmgr
- This configuration property is used to specify the name of the coordination queue manager from which transfer details are retrieved by the REST API for MFT.
- mqRestMftEnabled
- This configuration property is used to specify whether the REST API for MFT is enabled.
- mqRestMftReconnectTimeoutInMinutes
- This configuration property is used to specify the length of time, in minutes, after which the REST API for MFT stops trying to connect to the coordination queue manager.
- mqRestRequestTimeout
- This configuration property is used to specify the time, in seconds, before a REST request times out.
- traceSpec
- This configuration property is used to specify the level of trace that is generated by the mqweb server. For a list of possible values, see Configuring logging for the IBM MQ Console and REST API.
- httpHost
- This configuration property is used to specify the HTTP host name as an IP address, domain name server (DNS) host name with domain name suffix, or the DNS host name of the server where IBM MQ is installed.
- httpPort
- This configuration property is used to specify the HTTP port number that is used for HTTP connections.
- httpsPort
- This configuration property is used to specify the HTTPS port number that is used for HTTPS connections.
- ltpaCookieName
- This configuration property is used to specify the name of the LTPA token cookie name.
- maxMsgTraceFiles
- This configuration property is used to specify the maximum number of messaging trace files that are generated by the mqweb server for the IBM MQ Console.
- maxMsgTraceFileSize
- This configuration property is used to specify the maximum size, in MB, that each messaging trace file can reach.
- mqConsoleAutostart
- This configuration property is used to specify whether the IBM MQ Console automatically starts when the mqweb server starts.
- mqConsoleFrameAncestors
- This configuration property is used to specify the list of origins of web pages which can embed the IBM MQ Console in an IFrame.
- mqConsoleRemoteAllowLocal
- This configuration property is used to specify whether remote and local queue managers are visible in the IBM MQ Console when remote queue manager connections are allowed. When this property is set to true, both local and remote queue managers are displayed.
- mqConsoleRemotePollTime
- This configuration property is used to specify the time, in seconds, before the remote queue manager connections list is refreshed. On refresh, unsuccessful connections are retried.
- mqConsoleRemoteSupportEnabled
- This configuration property is used to specify whether the IBM MQ Console allows remote queue manager connections. When this property is set to true, remote queue manager connections are allowed.
- mqConsoleRemoteUIAdmin
- This configuration property is used to specify whether remote queue managers can be added to the IBM MQ Console by using the Console, or if remote queue managers can be added only by using the setmqweb remote command. When this property is set to true, remote queue managers can be added by using the IBM MQ Console.
- mqRestAutostart
- This configuration property is used to specify whether the REST API automatically starts when the mqweb server starts.
- remoteKeyfile
- This configuration property is used to specify the location of the key file that contains the initial encryption key that is used to decrypt the passwords that are stored in the remote queue manager connection information.
- secureLtpa
- This configuration property is used to specify whether the LTPA token is secured for all requests. An unsecured LTPA token is required in order send HTTP requests from a browser.
- managementMode
- This configuration property is used to specify whether queue managers and listeners are able to be created, deleted, started, and stopped by the IBM MQ Console.
Syntax
Optional parameters
- status
- Displays information about the status of the mqweb server. That is, whether the mqweb server is running. If the mqweb server is running, information about the available root context URLs and associated ports that are used by the IBM MQ Console and administrative REST API are displayed. The command returns non-zero if the mqweb server is not running, or its status could not be successfully queried.
- properties
- Displays information about the configurable properties of the mqweb server. That is, which properties are configurable by the user and those that have been modified. It is not necessary for the mqweb server to be running.
- remote
- Displays information about the remote queue manager connections that are configured for use with the IBM MQ Console.
- -l
- Enable verbose logging. Diagnostic information is written to a mqweb server log-file.
Return codes
Return code | Description |
---|---|
0 | Command successful. |
>0 | Command not successful. |