Set System on z/OS

Use the Set System (MQCMD_SET_SYSTEM) command to dynamically change certain general system parameter values initially set from the system parameter module at queue manager startup.

    Required parameters:
    ParameterType

    Optional parameters (if the value of ParameterType is MQSYSP_TYPE_SET:
    CheckpointCount, CommandScope, Exclmsg, MaxConnects, MaxConnectsBackground, MaxConnectsForeground, Service, SMFInterval, TraceSize

    Optional parameters if ParameterType type is MQSYSP_INITIAL:
    CommandScope


Required parameters

    ParameterType (MQCFIN)
    Parameter type (parameter identifier: MQIACF_SYSP_TYPE). Specifies how the parameters are to be set:

      MQSYSP_TYPE_INITIAL
      The initial settings of the system parameters. MQSYSP_TYPE_INITIAL resets the parameters to the values specified in the system parameters at queue manager startup.

      MQSYSP_TYPE_SET
      MQSYSP_TYPE_SET indicates that you intend to change one, or more, of the system parameter settings.


Optional parameters

    CheckpointCount (MQCFIN)
    The number of log records written by IBM MQ between the start of one checkpoint and the next (parameter identifier: MQIACF_SYSP_CHKPOINT_COUNT).

    IBM MQ starts a new checkpoint after the number of records that you specify has been written.

    Specify a value in the range 200 through 16 000 000.

    CommandScope (MQCFST)
    Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). Specifies how the command is executed when the queue manager is a member of a queue sharing group. We can specify one of the following:

    • blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
    • a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.
    • an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue sharing group.

    The maximum length is MQ_QSG_NAME_LENGTH.

    Exclmsg (MQCFSL)
    A list of message identifiers to be excluded from being written to any log (parameter identifier: MQCACF_EXCL_OPERATOR_MESSAGES).

    Specify a list of error message identifiers to be excluded from being written to any log. For example, to exclude message CSQX500I, add X500 to this list. Messages in this list are not sent to the z/OS console and hardcopy log. As a result using the EXCLMSG parameter to exclude messages is more efficient from a CPU perspective than using z/OS mechanisms such as the message processing facility list and should be used instead where possible.

    The maximum length of each message identifier is MQ_OPERATOR_MESSAGE_LENGTH.

    The list can contain a maximum of 16 message identifiers.

    Service (MQCFST)
    Service parameter setting (parameter identifier: MQIACF_SYSP_SERVICE).

    This parameter is reserved for use by IBM.

    SMFInterval (MQCFIN)
    The default time, in minutes, between each gathering of statistics (parameter identifier: MQIACF_SYSP_SMF_INTERVAL).

    Specify a value in the range zero through 1440.

    If you specify a value of zero, statistics data and accounting data are both collected at the SMF data collection broadcast.

    TraceSize (MQCFIN)
    The size of the trace table, in 4 KB blocks, to be used by the global trace facility (parameter identifier: MQIACF_SYSP_TRACE_SIZE).

    Specify a value in the range zero through 999.

Parent topic: Definitions of the Programmable Command Formats