Create the Liberty server definition
If you installed the IBM® MQ for z/OS® Unix System Services Web Components, and want to use the MQ Console, or the REST API, you need to create and customize the Liberty server definition.
Before you begin
Attention: When starting the mqweb server, if you encounter error message
CWWKG0014E, as displayed in the following
output:
Launching mqweb (MQM MVS/ESA V9 R2.0/wlp...) (en_US)
ÝAUDIT ¨ CWWKE0001I: The server mqweb has been launched.
ÝWARNING ¨ CWWKF0009W: The server has not been configured to install any features.
ÝAUDIT ¨ CWWKF0011I: The mqweb server is ready to run a smarter planet. The mqweb server started in 6.348 seconds.
ÝERROR ¨ CWWKG0014E: The configuration parser detected an XML syntax error while parsing the root of the configuration and the referenced configuration documents.
Error: An invalid XML character (Unicode: 0x4c) was found in the prolog of the document.
File: file:<your filepath>/servers/mqweb/server.xml Line: 1 Column: 1
you should check the z/OS setting of
AUTOCVT (automatically convert files from one code set to another) and adjust the value as required
by doing one of the following.- In a USS terminal:
- Issue the command: echo $_BPXK_AUTOCVT to display the value of this environment variable. If the environment variable is not defined, no value is displayed.
- System wide:
- Example 6 at Displaying status of z/OS Unix System Services (OMVS) shows how to display the value of the system wide AUTOCVT statement in BPXPRMxx.
If environment variable _BPXX_AUTOCVT is set in a USS terminal, it overrides the system wide setting of statement AUTOCVT in BPXPRMxx.
About this task
- You need to perform this task once for each z/OS system where you want to run the MQ Console or REST API.
- You need a Liberty server for each version of IBM MQ that is running.
- You might need to refresh or modify the server configuration when migrating from a previous version.
IBM MQ for z/OS Unix System Services Web Components
requires the creation of a single Liberty
server, called mqweb
.
The server configuration and log files are all stored under the Liberty user directory.
Carry out the following procedure to create themqweb
server definition: