setmqweb pid (set mqweb server product ID)

Use the setmqweb pid command to change the product ID (PID) that the mqweb server runs under on z/OS®.

By default, on z/OS, the mqweb server runs under the PID that is chosen when you use the crtmqweb command.

Before using setmqweb pid, ensure that the mqweb server has been stopped by using the MVS STOP command on the mqweb server started task.

For more information on PIDs and how they are used on z/OS, see Product usage recording with IBM® MQ for z/OS products.

Using the setmqweb pid command on z/OS

Before you issue 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.

To set the WLP_USER_DIR environment variable, enter the following command:

export WLP_USER_DIR=WLP_user_directory

where WLP_user_directory is the name of the directory that is passed to crtmqweb. For example:

export WLP_USER_DIR=/var/mqm/web/installation1

For more information, see Create the mqweb server.

You must also set the JAVA_HOME environment variable to reference a 64-bit version of Java on your system.

The user ID running the command needs write access to the following directories:

WLP_user_directory and its subdirectories.
/tmp or to another directory that is referenced by the TMPDIR variable. If you do not have access to /tmp, the command fails with message FSUMF315 Cannot define temporary file. If you need to set the TMPDIR variable, issue the following command in the z/OS UNIX shell: export TMPDIR=user_directory

Syntax

Parameters

Before using setmqweb pid, ensure that the mqweb server has been stopped by using the MVS STOP command on the mqweb server started task.

-p pid_name

Specifies the PID that the mqweb server runs under. pid_name is one of the following values:

MQ: The mqweb server runs under IBM MQ for z/OS (5655-MQ9)
VUE: The mqweb server runs under IBM MQ for z/OS Value Unit Edition (5655-VU9)
ADVANCEDVUE: The mqweb server runs under IBM MQ Advanced for z/OS VUE (5655-AV1)

-l

Enable verbose logging. Diagnostic information is written to an mqweb server log file.

Return codes

Table 1. Return code identifiers and descriptions
Return code	Description
0	Command successful.
>0	Command not successful.

For a full list of server command exit codes, see Liberty:server command options in the WebSphere® Application Server documentation.