[z/OS]

Creating a procedure for the mqweb server

If you installed the IBM® MQ for z/OS® UNIX System Services Web Components, and want to use the IBM MQ Console, or the REST API, you need to create a cataloged procedure to start the mqweb server. The mqweb server is a Liberty server that hosts the IBM MQ Console and the REST API.

  • You need to perform this task once for each z/OS system where you want to run the IBM MQ Console or REST API.
  • You need a mqweb server for each version of IBM MQ that is running. For example, a started task called MQWB0910 for queue managers at IBM MQ for z/OS 9.1.0 and a started task called MQWB0905 for queue managers at IBM MQ for z/OS 9.0.5.

    If you have only one queue manager on the z/OS system, you can run a single Liberty server started task, and change the libraries it uses when you migrate your queue manager.

  • You might need to modify the cataloged procedure when migrating from a previous version.
Carry out the following procedure to create a cataloged procedure:
  1. Copy the sample started task procedure thlqual.SCSQPROC(CSQ4WEBS) to your procedure library.

    Name the procedure according to the standards of your enterprise.

    For example MQWB0910, indicating that this is the cataloged procedure for the IBM MQ for z/OS 9.1.0 mqweb server.

  2. Tailor the procedure to your requirements using the instructions in the sample procedure CSQ4WEBS.

    Note that the Liberty user directory is the directory specified when the crtmqweb script was run to create the mqweb server definition.

    See Creating the mqweb server for details.

    Note: Ensure that you specify Caps off when you edit the member, as the file has lowercase data.
  3. Authorize the procedure to run under your external security manager.
  4. Use IBM Workload Manager (WLM) to classify this address space.

    The mqweb server is an IBM MQ application, and users interact with this application. The application does not need to be high importance in WLM, and a service class of STCUSER might be suitable.

What to do next

Follow the steps in Basic configuration for the mqweb server to finish configuring the mqweb server.