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 we want, you can create your own system parameter module and customized macros.


Before starting

Before we can perform this task, we 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 Connect or disconnect a queue manager.


About this task

A subset of a z/OS queue manager's properties are loaded from the queue manager 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 we 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.

We can, however, perform the following tasks in IBM MQ Explorer:
  1. View the system parameters.
  2. Override system parameters while the queue manager is running.


Procedure

  • [OPTION 1] View 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.

    1. In the Navigator view, right-click the queue manager, then click the relevant menu item to view the initial parameter values that we 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, the Initial table contains the values of the system parameters that were loaded from the system parameter module when the queue manager started.

  • [OPTION 2] Override 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.

    1. In the Navigator view, right-click the queue manager, then click the relevant menu item to view the initial parameter values that we 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 we want to override, then click OK to close the Properties dialog.

      For more information about the individual parameters, see Queue manager properties.

    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.

Parent topic: Create and configure queue managers and objects


Related tasks


Related reference