Configure system parameters on z/OS queue managers

If the default system parameter module that is supplied with IBM MQ does not contain the system parameters that you want, you can create your own system parameter module and customized macros.


About this task

A subset of a z/OSĀ® queue manager's attributes are loaded from the queue manager's system parameter module when the queue manager starts. The default system parameter module that is supplied with IBM MQ is called CSQZPARM. In the system parameter module are three macros:

  • CSQ6SYSP, which controls the connection and tracing parameters
  • CSQ6LOGP, which controls log initialization
  • CSQ6ARVP, which controls archive initialization

If the default system parameter module does not contain the system parameters that you want, you can create your own system parameter module and customized macros using the supplied JCL sample. You cannot perform these customizations from IBM MQ Explorer because IBM MQ Explorer cannot connect to a queue manager that is not running. For more information, see Customizing your queue managers in the IBM MQ online product documentation.

We can, however, perform the following tasks in IBM MQ Explorer:


Viewing the system parameters

When the z/OS queue manager starts, it loads its system parameter module which sets the queue manager's initial system parameter values. When the queue manager is running, we can monitor and administer it from IBM MQ Explorer and, therefore, view the queue manager's initial system parameter values.

Before you begin

Before we can perform this task, you must have already added the z/OS queue manager to IBM MQ Explorer and IBM MQ Explorer must be connected to the queue manager. For more information, see Showing a remote queue manager and Connecting or disconnecting a queue manager.

About this task

To view a z/OS queue manager's system parameters:

Procedure

In the Navigator view, right-click the queue manager, then click the relevant menu item to view the initial parameter values that you are interested in:

  • To view the log archive settings, click Configuration > Archive
  • To view the log settings, click Configuration > Log
  • To view the connection and tracing settings, click Configuration > System

Results

A dialog opens. In the dialog, the Initial table contains the values of the system parameters that were loaded from the system parameter module when the queue manager started.


Overriding system parameters while the queue manager is running

While the queue manager is running, we can change and temporarily override certain system parameter values. We can make these changes from IBM MQ Explorer.

Before you begin

Before we can perform this task, you must have already added the z/OS queue manager to IBM MQ Explorer and IBM MQ Explorer must be connected to the queue manager. For more information, see Showing a remote queue manager and Connecting or disconnecting a queue manager.

About this task

To temporarily override system parameters:

Procedure

  1. In the Navigator view, right-click the queue manager, then click the relevant menu item to view the initial parameter values that you are interested in:

    • To view the log archive settings, click Configuration > Archive
    • To view the log settings, click Configuration > Log
    • To view the connection and tracing settings, click Configuration > System
    A dialog opens. In the dialog, there is a table called Set. If we have already edited the system parameters since the queue manager started, the Set table contains the new parameter values.
  2. In the dialog, click Properties.... A Properties dialog opens.
  3. In the Properties dialog, edit the parameters that you want to override, then click OK to close the Properties dialog. For more information about the individual parameters, see Queue manager properties.

Results

The changes that we have made are shown in the Set table. The changes are temporary; the next time that the queue manager is restarted, the changes are lost because the values in the system parameter module are applied again.