Home

 

Optional parameters

 

AccountingConnOverride (MQCFIN)

Specifies whether applications can override the settings of the QueueAccounting and MQIAccounting queue manager parameters (parameter identifier: MQIA_ACCOUNTING_CONN_OVERRIDE).

The value can be:

MQMON_DISABLED

Applications cannot override the settings of the QueueAccounting and MQIAccounting parameters.

This is the queue manager's initial default value.

MQMON_ENABLED

Applications can override the settings of the QueueAccounting and MQIAccounting parameters by using the options field of the MQCNO structure of the MQCONNX API call.

This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

AccountingInterval (MQCFIN)

The time interval, in seconds, at which intermediate accounting records are written (parameter identifier: MQIA_ACCOUNTING_INTERVAL).

Specify a value in the range 1 through 604 000.

This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ActivityRecording (MQCFIN)

Whether activity reports can be generated (parameter identifier: MQIA_ACTIVITY_RECORDING).

The value can be:

MQRECORDING_DISABLED

Activity reports cannot be generated.

MQRECORDING_MSG

Activity reports can be generated and sent to the reply queue specified by the originator in the message causing the report.

MQRECORDING_Q

Activity reports can be generated and sent to SYSTEM.ADMIN.ACTIVITY.QUEUE.
For more information about activity reports, see WebSphere MQ Monitoring.

AdoptNewMCACheck (MQCFIN)

The elements checked to determine whether an MCA should be adopted (restarted) when a new inbound channel is detected that has the same name as a currently active MCA (parameter identifier: MQIA_ADOPTNEWMCA_CHECK).

The value can be:

MQADOPT_CHECK_Q_MGR_NAME

Check the queue manager name.

MQADOPT_CHECK_NET_ADDR

Check the network address.

MQADOPT_CHECK_ALL

Check the queue manager name and network address. Perform this check to prevent your channels from being inadvertently shut down. This is the queue manager's initial default value.

MQADOPT_CHECK_NONE

Do not check any elements.

This parameter applies to z/OS only.

AdoptNewMCAType (MQCFIN)

Adoption of orphaned channel instances (parameter identifier: MQIA_ADOPTNEWMCA_TYPE).

Specify whether an orphaned MCA instance is to be adopted when a new inbound channel request is detected matching the AdoptNewMCACheck parameters.

The value can be:

MQADOPT_TYPE_NO

Do not adopt orphaned channel instances.

MQADOPT_TYPE_ALL

Adopt all channel types. This is the queue manager's initial default value.

This parameter applies to z/OS only.

AuthorityEvent (MQCFIN)

Controls whether authorization (Not Authorized) events are generated (parameter identifier: MQIA_AUTHORITY_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled. This value is not permitted on z/OS.

BridgeEvent (MQCFIN)

Controls whether IMS™ Bridge events are generated (parameter identifier: MQIA_BRIDGE_EVENT). This parameter applies to z/OS only.

The value can be:

MQEVR_DISABLED

Event reporting disabled. This is the default value.

MQEVR_ENABLED

Event reporting enabled. This value is not supported on z/OS.

ChannelAutoDef (MQCFIN)

Controls whether receiver and server-connection channels can be auto-defined (parameter identifier: MQIA_CHANNEL_AUTO_DEF).

Auto-definition for cluster-sender channels is always enabled.

This parameter is supported in the following environments: AIX, HP-UX, i5/OS, Solaris, Windows and Linux.

The value can be:

MQCHAD_DISABLED

Channel auto-definition disabled.

MQCHAD_ENABLED

Channel auto-definition enabled.

ChannelAutoDefEvent (MQCFIN)

Controls whether channel auto-definition events are generated (parameter identifier: MQIA_CHANNEL_AUTO_DEF_EVENT), when a receiver, server-connection, or cluster-sender channel is auto-defined.

This parameter is supported in the following environments: AIX, HP-UX, i5/OS, Solaris, Windows and Linux.

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

ChannelAutoDefExit (MQCFST)

Channel auto-definition exit name (parameter identifier: MQCA_CHANNEL_AUTO_DEF_EXIT).

This exit is invoked when an inbound request for an undefined channel is received, if:

  1. The channel is a cluster-sender, or

  2. Channel auto-definition is enabled (see ChannelAutoDef).

This exit is also invoked when a cluster-receiver channel is started.

The format of the name is the same as for the SecurityExit parameter described in Change, Copy and Create Channel.

The maximum length of the exit name depends on the environment in which the exit is running. MQ_EXIT_NAME_LENGTH gives the maximum length for the environment in which your application is running. MQ_MAX_EXIT_NAME_LENGTH gives the maximum for all supported environments.

This parameter is supported in the following environments: AIX, HP-UX, i5/OS, Solaris, Windows, Linux, and z/OS. On z/OS, it applies only to cluster-sender and cluster-receiver channels.

ChannelEvent (MQCFIN)

Controls whether channel events are generated (parameter identifier: MQIA_CHANNEL_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

MQEVR_EXCEPTION

Reporting of exception channel events enabled.

ChannelInitiatorControl (MQCFIN)

Specifies whether the channel initiator is to be started when the queue manager starts (parameter identifier: MQIA_CHINIT_CONTROL).

The value can be:

MQSVC_CONTROL_MANUAL

The channel initiator is not to be started automatically.

MQSVC_CONTROL_Q_MGR

The channel initiator is to be started automatically when the queue manager starts.

This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ChannelMonitoring (MQCFIN)

Default setting for online monitoring for channels (parameter identifier: MQIA_MONITORING_CHANNEL).

The value can be:

MQMON_NONE

Online monitoring data collection is turned off for channels regardless of the setting of their ChannelMonitoring parameter.

MQMON_OFF

Online monitoring data collection is turned off for channels specifying a value of MQMON_Q_MGR in their ChannelMonitoring parameter. This is the queue manager's initial default value.

MQMON_LOW

Online monitoring data collection is turned on, with a low ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelMonitoring parameter.

MQMON_MEDIUM

Online monitoring data collection is turned on, with a moderate ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelMonitoring parameter.

MQMON_HIGH

Online monitoring data collection is turned on, with a high ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelMonitoring parameter.

ChannelStatistics (MQCFIN)

Controls whether statistics data is to be collected for channels (parameter identifier: MQIA_STATISTICS_CHANNEL).

The value can be:

MQMON_NONE

Statistics data collection is turned off for channels regardless of the setting of their ChannelStatistics parameter. This is the queue manager's initial default value.

MQMON_OFF

Statistics data collection is turned off for channels specifying a value of MQMON_Q_MGR in their ChannelStatistics parameter.

MQMON_LOW

Statistics data collection is turned on, with a low ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelStatistics parameter.

MQMON_MEDIUM

Statistics data collection is turned on, with a moderate ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelStatistics parameter.

MQMON_HIGH

Statistics data collection is turned on, with a high ratio of data collection, for channels specifying a value of MQMON_Q_MGR in their ChannelStatistics parameter.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ChinitAdapters (MQCFIN)

Number of adapter subtasks (parameter identifier: MQIA_CHINIT_ADAPTERS).

The number of adapter subtasks to use for processing WebSphere MQ calls. This parameter applies to z/OS only.

Specify a value in the range 1 through 9 999. The queue manager's initial default value is 8.

ChinitDispatchers (MQCFIN)

Number of dispatchers (parameter identifier: MQIA_CHINIT_DISPATCHERS).

The number of dispatchers to use for the channel initiator. This parameter applies to z/OS only.

Specify a value in the range 1 through 9 999. The queue manager's initial default value is 5.

ChinitServiceParm (MQCFST)

Reserved for use by IBM (parameter identifier: MQCA_CHINIT_SERVICE_PARM).

This parameter applies to z/OS only.

ChinitTraceAutoStart (MQCFIN)

Whether the channel initiator trace should start automatically (parameter identifier: MQIA_CHINIT_TRACE_AUTO_START).

The value can be:

MQTRAXSTR_YES

Channel initiator trace is to start automatically.

MQTRAXSTR_NO

Channel initiator trace is not to start automatically. This is the queue manager's initial default value.

This parameter applies to z/OS only.

ChinitTraceTableSize (MQCFIN)

The size, in megabytes, of the channel initiator's trace data space (parameter identifier: MQIA_CHINIT_TRACE_TABLE_SIZE).

Specify a value in the range 2 through 2048. The queue manager's initial default value is 2.

This parameter applies to z/OS only.

ClusterSenderMonitoringDefault (MQCFIN)

Default setting for online monitoring for automatically defined cluster-sender channels (parameter identifier: MQIA_MONITORING_AUTO_CLUSSDR).

Specifies the value to be used for the ChannelMonitoring attribute of automatically defined cluster-sender channels. The value can be:

MQMON_Q_MGR

Collection of online monitoring data is inherited from the setting of the queue manager's ChannelMonitoring parameter. This is the queue manager's initial default value.

MQMON_OFF

Monitoring for the channel is switched off.

MQMON_LOW

Unless ChannelMonitoring is MQMON_NONE, this specifies a low rate of data collection with a minimal impact on system performance. The data collected is not likely to be the most current.

MQMON_MEDIUM

Unless ChannelMonitoring is MQMON_NONE, this specifies a moderate rate of data collection with limited impact on system performance.

MQMON_HIGH

Unless ChannelMonitoring is MQMON_NONE, this specifies a high rate of data collection with a likely impact on system performance. The data collected is the most current available.

ClusterSenderStatistics (MQCFIN)

Controls whether statistics data is to be collected for auto-defined cluster-sender channels (parameter identifier: MQIA_STATISTICS_AUTO_CLUSSDR).

The value can be:

MQMON_Q_MGR

Collection of statistics data is inherited from the setting of the queue manager's ChannelStatistics parameter. This is the queue manager's initial default value.

MQMON_OFF

Statistics data collection for the channel is switched off.

MQMON_LOW

Unless ChannelStatistics is MQMON_NONE, this specifies a low rate of data collection with a minimal impact on system performance.

MQMON_MEDIUM

Unless ChannelStatistics is MQMON_NONE, this specifies a moderate rate of data collection.

MQMON_HIGH

Unless ChannelStatistics is MQMON_NONE, this specifies a high rate of data collection.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ClusterWorkLoadData (MQCFST)

Cluster workload exit data (parameter identifier: MQCA_CLUSTER_WORKLOAD_DATA).

This is passed to the cluster workload exit when it is called.

The maximum length of the string is MQ_EXIT_DATA_LENGTH.

ClusterWorkLoadExit (MQCFST)

Cluster workload exit name (parameter identifier: MQCA_CLUSTER_WORKLOAD_EXIT).

If a nonblank name is defined this exit is invoked when a message is put to a cluster queue.

The format of the name is the same as for the SecurityExit parameter described in Change, Copy and Create Channel.

The maximum length of the exit name depends on the environment in which the exit is running. MQ_EXIT_NAME_LENGTH gives the maximum length for the environment in which your application is running. MQ_MAX_EXIT_NAME_LENGTH gives the maximum for all supported environments.

This parameter is supported only in the environments in which an MQSeries V5.1 product, or later, is available.

ClusterWorkLoadLength (MQCFIN)

Cluster workload length (parameter identifier: MQIA_CLUSTER_WORKLOAD_LENGTH).

The maximum length of the message passed to the cluster workload exit.

The value of this attribute must be in the range 0 through 999 999 999.

CLWLMRUChannels (MQCFIN)

Cluster workload most recently used (MRU) channels (parameter identifier: MQIA_CLWL_MRU_CHANNELS).

The maximum number of active most recently used outbound channels.

Specify a value in the in the range 1 through 999 999 999.

CLWLUseQ (MQCFIN)

Use of remote queue (parameter identifier: MQIA_CLWL_USEQ).

Specifies whether a cluster queue manager is to use remote puts to other queues defined in other queue managers within the cluster during workload management.

Specify either:

MQCLWL_USEQ_ANY

Use remote queues.

MQCLWL_USEQ_LOCAL

Do not use remote queues.

CodedCharSetId (MQCFIN)

Queue manager coded character set identifier (parameter identifier: MQIA_CODED_CHAR_SET_ID).

The coded character set identifier (CCSID) for the queue manager. The CCSID is the identifier used with all character string fields defined by the application programming interface (API). It does not apply to application data carried in the text of a message unless the CCSID in the message descriptor, when the message is put with an MQPUT or MQPUT1, is set to the value MQCCSI_Q_MGR.

Specify a value in the range 1 through 65 535.

The CCSID must specify a value that is defined for use on the platform and use an appropriate character set. The character set must be:

  • EBCDIC on i5/OS

  • ASCII or ASCII-related on other platforms

Stop and restart the queue manager after execution of this command so that all processes reflect the changed CCSID of the queue manager.

This parameter is supported in the following environments: AIX, Compaq NonStop Kernel, HP OpenVMS, HP-UX, i5/OS, Solaris, Windows and Linux.

CommandEvent (MQCFIN)

Controls whether command events are generated (parameter identifier: MQIA_COMMAND_EVENT). This parameter applies to z/OS only.

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

MQEVR_NO_DISPLAY

Event reporting enabled for all successful commands except Inquire commands.

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only.

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, 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.

CommandServerControl (MQCFIN)

Specifies whether the command server is to be started when the queue manager starts (parameter identifier: MQIA_CMD_SERVER_CONTROL).

The value can be:

MQSVC_CONTROL_MANUAL

The command server is not to be started automatically.

MQSVC_CONTROL_Q_MGR

The command server is to be started automatically when the queue manager starts.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ConfigurationEvent (MQCFIN)

Controls whether configuration events are generated (parameter identifier: MQIA_CONFIGURATION_EVENT). This parameter applies to z/OS only.

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

DeadLetterQName (MQCFST)

Dead letter (undelivered message) queue name (parameter identifier: MQCA_DEAD_LETTER_Q_NAME).

Specifies the name of the local queue that is to be used for undelivered messages. Messages are put on this queue if they cannot be routed to their correct destination. The maximum length of the string is MQ_Q_NAME_LENGTH.

DefXmitQName (MQCFST)

Default transmission queue name (parameter identifier: MQCA_DEF_XMIT_Q_NAME).

This is the name of the default transmission queue that is used for the transmission of messages to remote queue managers, if there is no other indication of which transmission queue to use.

The maximum length of the string is MQ_Q_NAME_LENGTH.

DNSGroup (MQCFST)

DNS group name (parameter identifier: MQCA_DNS_GROUP).

Specify the name of the group that the TCP listener handling inbound transmissions for the queue-sharing group should join when using Workload Manager for Dynamic Domain Name Services support (WLM/DNS). This parameter applies to z/OS only.

The maximum length of the string is MQ_DNS_GROUP_NAME_LENGTH.

DNSWLM (MQCFIN)

Controls whether the TCP listener that handles inbound transmissions for the queue-sharing group should register with WLM/DNS: (parameter identifier: MQIA_DNS_WLM).

The value can be:

MQDNSWLM_YES

The listener should register with WLM.

MQDNSWLM_NO

The listener is not to register with WLM. This is the queue manager's initial default value.

This parameter applies to z/OS only.

ExpiryInterval (MQCFIN)

Interval between scans for expired messages (parameter identifier: MQIA_EXPIRY_INTERVAL). This parameter applies to z/OS only.

Specifies the frequency with which the queue manager scans the queues looking for expired messages. Specify a time interval in seconds in the range 1 through 99 999 999, or the following special value:

MQEXPI_OFF

No scans for expired messages.
The minimum scan interval used is 5 seconds, even if you specify a lower value.

Force (MQCFIN)

Force changes (parameter identifier: MQIACF_FORCE).

Specifies whether the command will be forced to complete if both of the following are true:

  • DefXmitQName is specified, and

  • An application has a remote queue open, the resolution for which will be affected by this change.

IGQPutAuthority (MQCFIN)

Command scope (parameter identifier: MQIA_IGQ_PUT_AUTHORITY). This parameter is valid only on z/OS when the queue manager is a member of a queue-sharing group.

Specifies the type of authority checking and, therefore, the user IDs to be used by the IGQ agent (IGQA). This establishes the authority to put messages to a destination queue. The value can be:

MQIGQPA_DEFAULT

Default user identifier is used.

The user identifier used for authorization is the value of the UserIdentifier field in the separate MQMD that is associated with the message when the message is on the shared transmission queue. This is the user identifier of the program that placed the message on the shared transmission queue, and is usually the same as the user identifier under which the remote queue manager is running.

If the RESLEVEL profile indicates that more than one user identifier is to be checked, the user identifier of the local IGQ agent (IGQUserId) is also checked.

MQIGQPA_CONTEXT

Context user identifier is used.

The user identifier used for authorization is the value of the UserIdentifier field in the separate MQMD that is associated with the message when the message is on the shared transmission queue. This is the user identifier of the program that placed the message on the shared transmission queue, and is usually the same as the user identifier under which the remote queue manager is running.

If the RESLEVEL profile indicates that more than one user identifier is to be checked, the user identifier of the local IGQ agent (IGQUserId) and the value of the UserIdentifier field in the embedded MQMD are also checked. The latter user identifier is usually the user identifier of the application that originated the message.

MQIGQPA_ONLY_IGQ

Only the IGQ user identifier is used.

The user identifier used for authorization is the user identifier of the local IGQ agent (IGQUserId).

If the RESLEVEL profile indicates that more than one user identifier is to be checked, this user identifier is used for all checks.

MQIGQPA_ALTERNATE_OR_IGQ

Alternate user identifier or IGQ-agent user identifier is used.

The user identifier used for authorization is the user identifier of the local IGQ agent (IGQUserId).

If the RESLEVEL profile indicates that more than one user identifier is to be checked, the value of the UserIdentifier field in the embedded MQMD is also checked. This user identifier is usually the user identifier of the application that originated the message.

IGQUserId (MQCFST)

Intra-group queuing agent user identifier (parameter identifier: MQCA_IGQ_USER_ID). This parameter is valid only on z/OS when the queue manager is a member of a queue-sharing group.

Specifies the user identifier that is associated with the local intra-group queuing agent. This identifier is one of the user identifiers that may be checked for authorization when the IGQ agent puts messages on local queues. The actual user identifiers checked depend on the setting of the IGQPutAuthority attribute, and on external security options.

The maximum length is MQ_USER_ID_LENGTH.

InhibitEvent (MQCFIN)

Controls whether inhibit (Inhibit Get and Inhibit Put) events are generated (parameter identifier: MQIA_INHIBIT_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

IntraGroupQueuing (MQCFIN)

Command scope (parameter identifier: MQIA_INTRA_GROUP_QUEUING). This parameter is valid only on z/OS when the queue manager is a member of a queue-sharing group.

Specifies whether intra-group queuing is used. The value can be:

MQIGQ_DISABLED

Intra-group queuing disabled.

MQIGQ_ENABLED

Intra-group queuing enabled.

IPAddressV(MQCFIN)

IP address version selector (parameter identifier: MQIA_IP_ADDRESS_VERSION).

Specifies which IP address version, either IPv4 or IPv6, is used. The value can be:

MQIPADDR_IPV4

IPv4 is used.

MQIPADDR_IPV6

IPv6 is used.
This parameter is only relevant for systems that run both IPv4 and IPv6 and only affects channels defined as having a TransportType of MQXPY_TCP when one of the following conditions is true:

ListenerTimer (MQCFIN)

Listener restart interval (parameter identifier: MQIA_LISTENER_TIMER).

The time interval, in seconds, between attempts by WebSphere MQ to restart the listener after an APPC or TCP/IP failure. This parameter applies to z/OS only.

Specify a value in the range 5 through 9 999. The queue manager's initial default value is 60.

LocalEvent (MQCFIN)

Controls whether local error events are generated (parameter identifier: MQIA_LOCAL_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

LoggerEvent (MQCFIN)

Controls whether recovery log events are generated (parameter identifier: MQIA_LOGGER_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled. This value is valid only on queue managers that use linear logging.

This is valid only on AIX, HP-UX, i5/OS, Solaris, Linux, and Windows.

LUGroupName (MQCFST)

Generic LU name for the LU 6.2 listener (parameter identifier: MQCA_LU_GROUP_NAME).

The generic LU name to be used by the LU 6.2 listener that handles inbound transmissions for the queue-sharing group.

This parameter applies to z/OS only.

The maximum length of the string is MQ_LU_NAME_LENGTH.

LUName (MQCFST)

LU name to use for outbound LU 6.2 transmissions (parameter identifier: MQCA_LU_NAME).

The name of the LU to use for outbound LU 6.2 transmissions. Set this to be the same as the name of the LU to be used by the listener for inbound transmissions.

This parameter applies to z/OS only.

The maximum length of the string is MQ_LU_NAME_LENGTH.

LU62ARMSuffix (MQCFST)

APPCPM suffix (parameter identifier: MQCA_LU62_ARM_SUFFIX).

The suffix of the APPCPM member of SYS1.PARMLIB. This suffix nominates the LUADD for this channel initiator.

This parameter applies to z/OS only.

The maximum length of the string is MQ_ARM_SUFFIX_LENGTH.

LU62Channels (MQCFIN)

Maximum number of LU 6.2 channels (parameter identifier: MQIA_LU62_CHANNELS).

The maximum number of channels that can be current, or clients that can be connected, that use the LU 6.2 transmission protocol.

This parameter applies to z/OS only.

Specify a value in the range zero through 9 999. The queue manager's initial default value is 200.

MaxActiveChannels (MQCFIN)

Maximum number of channels (parameter identifier: MQIA_ACTIVE_CHANNELS).

The maximum number of channels that can be active at any time.

This parameter applies to z/OS only.

Specify a value in the range 1 through 9 999. The queue manager's initial default value is 200.

MaxChannels (MQCFIN)

Maximum number of current channels (parameter identifier: MQIA_MAX_CHANNELS).

The maximum number of channels that can be current (including server-connection channels with connected clients).

This parameter applies to z/OS only.

Specify a value in the range 1 through 9 999.

MaxHandles (MQCFIN)

Maximum number of handles (parameter identifier: MQIA_MAX_HANDLES).

The maximum number of handles that any one connection can have open at the same time.

Specify a value in the range 0 through 999 999 999.

MaxMsgLength (MQCFIN)

Maximum message length (parameter identifier: MQIA_MAX_MSG_LENGTH).

Specifies the maximum length of messages allowed on queues on the queue manager. No message that is larger than either the queue’s MaxMsgLength or the queue manager’s MaxMsgLength can be put on a queue.

If you reduce the maximum message length for the queue manager, also reduce the maximum message length of the SYSTEM.DEFAULT.LOCAL.QUEUE definition, and your other queues, to ensure that the queue manager’s limit is not less than that of any of the queues in the system. If you do not do this, and applications inquire only the value of the queue’s MaxMsgLength, they might not work correctly.

The lower limit for this parameter is 32 KB (32 768 bytes). The upper limit depends on the environment:

  • On AIX, HP OpenVMS, Compaq NonStop Kernel, HP-UX, i5/OS, Solaris, Linux, and Windows, the maximum message length is 100 MB (104 857 600 bytes).

  • On UNIX systems not listed above, the maximum message length is 4 MB (4 194 304 bytes).

This parameter is not valid on z/OS.

MaxUncommittedMsgs (MQCFIN)

Maximum uncommitted messages (parameter identifier: MQIA_MAX_UNCOMMITTED_MSGS).

Specifies the maximum number of uncommitted messages. That is:

  • The number of messages that can be retrieved, plus

  • The number of messages that can be put, plus

  • Any trigger messages generated within this unit of work

under any one syncpoint. This limit does not apply to messages that are retrieved or put outside syncpoint.

Specify a value in the range 1 through 10 000.

MQIAccounting (MQCFIN)

Controls whether accounting information for MQI data is to be collected (parameter identifier: MQIA_ACCOUNTING_MQI).

The value can be:

MQMON_OFF

MQI accounting data collection is disabled. This is the queue manager's initial default value.

MQMON_ON

MQI accounting data collection is enabled.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

MQIStatistics (MQCFIN)

Controls whether statistics monitoring data is to be collected for the queue manager (parameter identifier: MQIA_STATISTICS_MQI).

The value can be:

MQMON_OFF

Data collection for MQI statistics is disabled. This is the queue manager's initial default value.

MQMON_ON

Data collection for MQI statistics is enabled.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

OutboundPortMax (MQCFIN)

The maximum value in the range for the binding of outgoing channels (parameter identifier: MQIA_OUTBOUND_PORT_MAX).

The maximum value in the range of port numbers to be used when binding outgoing channels. This parameter applies to z/OS only.

Specify a value in the range zero through 65 535. The queue manager's initial default value is zero.

Specify a corresponding value for OutboundPortMin and ensure that the value of OutboundPortMax is greater than or equal to the value of OutboundPortMin.

OutboundPortMin (MQCFIN)

The minimum value in the range for the binding of outgoing channels (parameter identifier: MQIA_OUTBOUND_PORT_MIN).

The minimum value in the range of port numbers to be used when binding outgoing channels. This parameter applies to z/OS only.

Specify a value in the range zero through 65 535. The queue manager's initial default value is zero.

Specify a corresponding value for OutboundPortMax and ensure that the value of OutboundPortMin is less than or equal to the value of OutboundPortMax.

PerformanceEvent (MQCFIN)

Controls whether performance-related events are generated (parameter identifier: MQIA_PERFORMANCE_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

QMgrDesc (MQCFST)

Queue manager description (parameter identifier: MQCA_Q_MGR_DESC).

This is text that briefly describes the object.

The maximum length of the string is MQ_Q_MGR_DESC_LENGTH.

Use characters from the character set identified by the coded character set identifier (CCSID) for the queue manager on which the command is executing, to ensure that the text is translated correctly.

QueueAccounting (MQCFIN)

Controls the collection of accounting (thread-level and queue-level accounting) data for queues (parameter identifier: MQIA_ACCOUNTING_Q).

The value can be:

MQMON_NONE

Accounting data collection for queues is disabled. This may not be overridden by the value of the QueueAccounting parameter on the queue.

MQMON_OFF

Accounting data collection is disabled for queues specifying a value of MQMON_Q_MGR in the QueueAccounting parameter.

MQMON_ON

Accounting data collection is enabled for queues specifying a value of MQMON_Q_MGR in the QueueAccounting parameter.

QueueMonitoring (MQCFIN)

Default setting for online monitoring for queues (parameter identifier: MQIA_MONITORING_Q).

If the QueueMonitoring queue attribute is set to MQMON_Q_MGR, this attribute specifies the value which is assumed by the channel. The value can be:

MQMON_OFF

Online monitoring data collection is turned off. This is the queue manager's initial default value.

MQMON_NONE

Online monitoring data collection is turned off for queues regardless of the setting of their QueueMonitoring attribute.

MQMON_LOW

Online monitoring data collection is turned on, with a low ratio of data collection.

MQMON_MEDIUM

Online monitoring data collection is turned on, with a moderate ratio of data collection.

MQMON_HIGH

Online monitoring data collection is turned on, with a high ratio of data collection.

QueueStatistics (MQCFIN)

Controls whether statistics data is to be collected for queues (parameter identifier: MQIA_STATISTICS_Q).

The value can be:

MQMON_NONE

Statistics data collection is turned off for queues regardless of the setting of their QueueStatistics parameter. This is the queue manager's initial default value.

MQMON_OFF

Statistics data collection is turned off for queues specifying a value of MQMON_Q_MGR in their QueueStatistics parameter.

MQMON_ON

Statistics data collection is turned on for queues specifying a value of MQMON_Q_MGR in their QueueStatistics parameter.
This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

ReceiveTimeout (MQCFIN)

How long a TCP/IP channel waits to receive data from its partner (parameter identifier: MQIA_RECEIVE_TIMEOUT).

The approximate length of time that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state.

This parameter applies to z/OS only and only to message channels (and not to MQI channels). This number can be qualified as follows:

  • To specify that this number is a multiplier to be applied to the negotiated HeartBeatInterval value to determine how long a channel is to wait, set ReceiveTimeoutType to MQRCVTIME_MULTIPLY. Specify a value of zero or in the range 2 through 99. If you specify zero, the channel does not time out its wait to receive data from its partner.

  • To specify that this number is a value, in seconds, to be added to the negotiated HeartBeatInterval value to determine how long a channel is to wait, set ReceiveTimeoutType to MQRCVTIME_ADD. Specify a value in the range 1 through 999 999.

  • To specify that this number is a value, in seconds, that the channel is to wait, set ReceiveTimeoutType to MQRCVTIME_EQUAL. Specify a value in the range zero through 999 999. If you specify zero, the channel does not time out its wait to receive data from its partner.

The queue manager's initial default value is zero.

ReceiveTimeoutMin (MQCFIN)

The minimum length of time that a TCP/IP channel waits to receive data from its partner (parameter identifier: MQIA_RECEIVE_TIMEOUT_MIN).

The minimum length of time that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state. This parameter applies to z/OS only.

Specify a value in the range zero through 999 999.

ReceiveTimeoutType (MQCFIN)

The qualifier to apply to ReceiveTimeout (parameter identifier: MQIA_RECEIVE_TIMEOUT_TYPE).

The qualifier to apply to ReceiveTimeoutType to calculate how long a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state. This parameter applies to z/OS only.

The value can be:

MQRCVTIME_MULTIPLY

The ReceiveTimeout value is a multiplier to be applied to the negotiated value of HeartbeatInterval to determine how long a channel will wait. This is the queue manager's initial default value.

MQRCVTIME_ADD

ReceiveTimeout is a value, in seconds, to be added to the negotiated value of HeartbeatInterval to determine how long a channel will wait.

MQRCVTIME_EQUAL

ReceiveTimeout is a value, in seconds, representing how long a channel will wait.

RemoteEvent (MQCFIN)

Controls whether remote error events are generated (parameter identifier: MQIA_REMOTE_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

RepositoryName (MQCFST)

Cluster name (parameter identifier: MQCA_REPOSITORY_NAME).

The name of a cluster for which this queue manager provides a repository manager service.

The maximum length of the string is MQ_OBJECT_NAME_LENGTH.

No more than one of the resultant values of RepositoryName can be nonblank.

RepositoryNamelist (MQCFST)

Repository namelist (parameter identifier: MQCA_REPOSITORY_NAMELIST).

The name, of a namelist of clusters, for which this queue manager provides a repository manager service.

This queue manager does not have a full repository, but can be a client of other repository services that are defined in the cluster, if

  • Both RepositoryName and RepositoryNamelist are blank, or

  • RepositoryName is blank and the namelist specified by RepositoryNamelist is empty.

No more than one of the resultant values of RepositoryNameList can be nonblank.

SharedQQmgrName (MQCFIN)

Shared-queue queue manager name (parameter identifier: MQIA_SHARED_Q_Q_MGR_NAME).

When a queue manager makes an MQOPEN call for a shared queue and the queue manager that is specified in the ObjectQmgrName parameter of the MQOPEN call is in the same queue-sharing group as the processing queue manager, the SQQMNAME attribute specifies whether the ObjectQmgrName is used or whether the processing queue manager opens the shared queue directly. This parameter is valid only on z/OS.

The value can be:

MQSQQM_USE

ObjectQmgrName is used and the appropriate transmission queue is opened.

MQSQQM_IGNORE

The processing queue manager opens the shared queue directly. This can reduce the traffic in your queue manager network.

SSLCRLNamelist (MQCFST)

The SSL namelist (parameter identifier: MQCA_SSL_CRL_NAMELIST).

The length of the string is MQ_NAMELIST_NAME_LENGTH.

Indicates the name of a namelist of authentication information objects to be used for CRL checking by the queue manager.

If SSLCRLNamelist is blank, CRL checking is not invoked.

Changes to SSLCRLNamelist, or to the names in a previously specified namelist, or to previously referenced authentication information objects become effective:

SSLCryptoHardware (MQCFST)

The SSL cryptographic hardware (parameter identifier: MQCA_SSL_CRYPTO_HARDWARE).

The length of the string is MQ_SSL_CRYPTO_HARDWARE_LENGTH.

Sets the name of the parameter string required to configure the cryptographic hardware present on the system.

This parameter is supported on AIX, HP-UX, Solaris, Linux, and Windows only.

The string can have one of the following values:

  • GSK_ACCELERATOR_RAINBOW_CS_OFF

  • GSK_ACCELERATOR_RAINBOW_CS_ON

  • GSK_ACCELERATOR_NCIPHER_NF_OFF

  • GSK_ACCELERATOR_NCIPHER_NF_ON

  • GSK_PKCS11=<the PKCS #11 driver path and filename>;<the PKCS #11 token label>;<the PKCS #11 token password>;<symmetric cipher setting>;

The strings containing RAINBOW enable or disable the Rainbow CryptoSwift cryptographic hardware.

The strings containing NCIPHER enable or disable the nCipher nFast cryptographic hardware.

To use cryptographic hardware which is accessed using the PKCS #11 interface, you must specify the string containing PKCS11. The PKCS #11 driver path is an absolute path to the shared library providing support for the PKCS #11 card. The PKCS #11 driver filename is the name of the shared library. An example of the value required for the PKCS #11 driver path and filename is /usr/lib/pkcs11/PKCS11_API.so

To access symmetric cipher operations through GSKit, specify the symmetric cipher setting parameter on the PKCS11 string. The value of this parameter is either:

SYMMETRIC_CIPHER_OFF

Do not access symmetric cipher operations.

SYMMETRIC_CIPHER_ON

Access symmetric cipher operations.
If the symmetric cipher setting is not specified, this has the same effect as specifying SYMMETRIC_CIPHER_OFF.

The maximum length of the string is 256 characters. The default value is blank.

If you specify a string that does not begin with one of the cryptographic strings listed above, you get an error. If you specify the GSK_PKCS11 string, the syntax of the other parameters is also checked.

When the SSLCryptoHardware value is changed, the cryptographic hardware parameters specified become the ones used for new SSL connection environments. The new information becomes effective:

  • When a new channel process is started.

  • For channels that run as threads of the channel initiator, when the channel initiator is restarted.

  • For channels that run as threads of the listener, when the listener is restarted.

  • When a Refresh Security command is issued to refresh the contents of the SSL key repository.

SSLEvent (MQCFIN)

Controls whether SSL events are generated (parameter identifier: MQIA_SSL_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

SSLFipsRequired (MQCFIN)

Specifies whether only FIPS-certified algorithms are to be used if WebSphere MQ itself is to perform cryptography (parameter identifier: MQIA_SSL_FIPS_REQUIRED).

If cryptographic hardware is configured, the cryptographic modules used are those provided by the hardware product, and these may, or may not, be FIPS-certified to a particular level. This depends on the hardware product in use. This parameter applies to Windows and UNIX platforms only.

The value can be:

MQSSL_FIPS_NO

WebSphere MQ provides an implementation of SSL cryptography which supplies some FIPS-certified modules on some platforms. If you set SSLFIPSRequired to MQSSL_FIPS_NO, any CipherSpec supported on a particular platform can be used. This is the queue manager's initial default value.

If the queue manager runs without using cryptographic hardware, the following CipherSpecs run using FIPS 140–2 certified cryptography:

  • TLS_RSA_WITH_DES_CBC_SHA

  • TLS_RSA_WITH_3DES_EDE_CBC_SHA

  • FIPS_WITH_DES_CBC_SHA

  • FIPS_WITH_3DES_EDE_CBC_SHA

  • TLS_RSA_WITH_AES_128_CBC_SHA

  • TLS_RSA_WITH_AES_256_CBC_SHA

MQSSL_FIPS_YES

Specifies that only FIPS-certified algorithms are to be used in the CipherSpecs allowed on all SSL connections from and to this queue manager.

Inbound and outbound SSL channel connections succeed only if one of the following CipherSpecs is used:

  • TLS_RSA_WITH_DES_CBC_SHA

  • TLS_RSA_WITH_3DES_EDE_CBC_SHA

  • FIPS_WITH_DES_CBC_SHA

  • FIPS_WITH_3DES_EDE_CBC_SHA

  • TLS_RSA_WITH_AES_128_CBC_SHA

  • TLS_RSA_WITH_AES_256_CBC_SHA

SSLKeyRepository (MQCFST)

The SSL key repository (parameter identifier: MQCA_SSL_KEY_REPOSITORY).

The length of the string is MQ_SSL_KEY_REPOSITORY_LENGTH.

Indicates the name of the Secure Sockets Layer key repository.

The format of the name depends on the environment:

  • On z/OS, it is the name of a key ring.

  • On i5/OS, it is of the form pathname/keyfile, where keyfile is specified without the suffix (.kdb), and identifies a GSKit key database file. The default value is /QIBM/UserData/ICSS/Cert/Server/Default.

    If you specify *SYSTEM, WebSphere MQ utilizes the system certificate store as the key repository for the queue manager. As a result, the queue manager is registered as a server application in Digital Certificate Manager (DCM) and we can assign any server/client certificate in the system store to this application.

    If you change the SSLKEYR parameter to a value other than *SYSTEM, WebSphere MQ deregisters the queue manager as an application with DCM.

  • On UNIX it is of the form pathname/keyfile and on Windows pathname\keyfile, where keyfile is specified without the suffix (.kdb), and identifies a GSKit key database file. The default value for UNIX platforms is /var/mqm/qmgrs/QMGR/ssl/key, and on Windows it is C:\\IBM\WebSphere MQ\qmgrs\QMGR\ssl\key, where QMGR is replaced by the queue manager name (on UNIX and Windows).

On i5/OS, Windows, and UNIX systems, the syntax of this parameter is validated to ensure that it contains a valid, absolute, directory path.

If SSLKEYR is blank, or is set to a value that does not correspond to a key ring or key database file, channels using SSL fail to start.

Changes to SSLKeyRepository become effective:

  • On i5/OS, Windows, and UNIX platforms, when a new channel process is started.

  • For channels that run as threads of the channel initiator on i5/OS, Windows, and UNIX platforms, when the channel initiator is restarted.

  • For channels that run as threads of the listener on i5/OS, Windows, and UNIX platforms, when the listener is restarted.

  • On z/OS, when the channel initiator is restarted.

SSLKeyResetCount (MQCFIN)

SSL key reset count (parameter identifier: MQIA_SSL_RESET_COUNT).

Specifies when SSL channel MCAs that initiate communication reset the secret key used for encryption on the channel. The value of this parameter represents the total number of unencrypted bytes that are sent and received on the channel before the secret key is renegotiated. This number of bytes includes control information sent by the MCA.

The secret key is renegotiated when (whichever occurs first):

  • The total number of unencrypted bytes sent and received by the initiating channel MCA exceeds the specified value, or,

  • If channel heartbeats are enabled, before data is sent or received following a channel heartbeat.

Specify a value in the range zero through 999 999 999. A value of zero, the queue manager's initial default value, signifies that secret keys are never renegotiated.

SSLTasks (MQCFIN)

Number of server subtasks to use for processing SSL calls (parameter identifier: MQIA_SSL_TASKS). This parameter applies to z/OS only.

The number of server subtasks to use for processing SSL calls. To use SSL channels, have at least two of these tasks running.

Specify a value in the range zero through 9 999. However, to avoid problems with storage allocation, do not set this parameter to a value greater than 50.

StartStopEvent (MQCFIN)

Controls whether start and stop events are generated (parameter identifier: MQIA_START_STOP_EVENT).

The value can be:

MQEVR_DISABLED

Event reporting disabled.

MQEVR_ENABLED

Event reporting enabled.

StatisticsInterval (MQCFIN)

The time interval, in seconds, at which statistics monitoring data is written to the monitoring queue (parameter identifier: MQIA_STATISTICS_INTERVAL).

Specify a value in the range 1 through 604 000.

This parameter is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows.

TCPChannels (MQCFIN)

The maximum number of channels that can be current, or clients that can be connected, that use the TCP/IP transmission protocol (parameter identifier: MQIA_TCP_CHANNELS).

Specify a value in the range zero to 9 999. The queue manager's initial default value is 200.

This parameter applies to z/OS only.

TCPKeepAlive (MQCFIN)

Whether the TCP KEEPALIVE facility is to be used to check whether the other end of a connection is still available (parameter identifier: MQIA_TCP_KEEP_ALIVE).

The value can be:

MQTCPKEEP_YES

The TCP KEEPALIVE facility is to be used as specified in the TCP profile configuration data set. The interval is specified in the KeepAliveInterval channel attribute.

MQTCPKEEP_NO

The TCP KEEPALIVE facility is not to be used. This is the queue manager's initial default value.

This parameter applies to z/OS only.

TCPName (MQCFST)

The name of the TCP/IP system that you are using (parameter identifier: MQIA_TCP_NAME).

The maximum length of the string is MQ_TCP_NAME_LENGTH.

This parameter applies to z/OS only.

TCPStackType (MQCFIN)

Whether the channel initiator may use only the TCP/IP address space specified in TCPName, or may optionally bind to any selected TCP/IP address (parameter identifier: MQIA_TCP_STACK_TYPE).

The value can be:

MQTCPSTACK_SINGLE

The channel initiator may only use the TCP/IP address space specified in TCPName. This is the queue manager's initial default value.

MQTCPSTACK_MULTIPLE

The channel initiator may use any TCP/IP address space available to it. It defaults to the one specified in TCPName if no other is specified for a channel or listener.

This parameter applies to z/OS only.

TraceRouteRecording (MQCFIN)

Whether trace-route information can be recorded and a reply message generated (parameter identifier: MQIA_TRACE_ROUTE_RECORDING).

The value can be:

MQRECORDING_DISABLED

Trace-route information cannot recorded.

MQRECORDING_MSG

Trace-route information can be recorded and replies sent to the destination specified by the originator of the message causing the trace-route record.

MQRECORDING_Q

Trace-route information can be recorded and replies sent to SYSTEM.ADMIN.TRACE.ROUTE.QUEUE.
If participation in route tracing is enabled using this queue manager attribute (by the attribute being not set to MQRECORDING_DISABLED) then the value of the attribute is only important should a reply be generated. The reply should go either to SYSTEM.ADMIN.TRACE.ROUTE.QUEUE, or to the destination specified by the message itself. Provided the attribute is not disabled then messages not yet at the final destination may have information added to them. For more information about trace-route records, see WebSphere MQ Monitoring.

TriggerInterval (MQCFIN)

Trigger interval (parameter identifier: MQIA_TRIGGER_INTERVAL).

Specifies the trigger time interval, expressed in milliseconds, for use only with queues where TriggerType has a value of MQTT_FIRST.

In this case trigger messages are normally generated only when a suitable message arrives on the queue, and the queue was previously empty. Under certain circumstances, however, an additional trigger message can be generated with MQTT_FIRST triggering, even if the queue was not empty. These additional trigger messages are not generated more often than every TriggerInterval milliseconds.

Specify a value in the range 0 through 999 999 999.

 

Parent topic:

Change Queue Manager


pc11230_


 

Home