Create a procedure for the mqweb server

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

  • We need to perform this task once for each z/OS system where we want to run the 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 Version 9.1.0 and a started task called MQWB0905 for queue managers at Version 9.0.5.

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

  • We 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 our enterprise.

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

  2. Tailor the procedure to we 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 Create 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.

Parent topic: Configure the mqweb server