CHGMQM (Change Message Queue Manager)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Change Message Queue Manager (CHGMQM) command changes the specified attributes of the local queue manager.

Parameters

Table 1. Queue manager attributes
Keyword	Description	Choices	Notes
MQMNAME	Message Queue Manager name	`Character value`, *DFT	Optional, Key, Positional 1
FORCE	Force	NO, YES	Optional, Positional 2
TEXT	Text 'description'	`Character value`, BLANK, SAME	Optional, Positional 3
TRGITV	Trigger interval	0-999999999, *SAME	Optional, Positional 4
UDLMSGQ	Undelivered message queue	`Character value`, NONE, SAME	Optional, Positional 5
DFTTMQ	Default transmission queue	`Character value`, NONE, SAME	Optional, Positional 6
MAXHDL	Maximum handle limit	0-999999999, *SAME	Optional, Positional 7
MAXUMSG	Maximum uncommitted messages	1-999999999, *SAME	Optional, Positional 8
AUTEVT	Authorization events enabled	SAME, YES, *NO	Optional, Positional 9
INHEVT	Inhibit events enabled	SAME, YES, *NO	Optional, Positional 10
LCLERREVT	Local error events enabled	SAME, YES, *NO	Optional, Positional 11
RMTERREVT	Remote error events enabled	SAME, YES, *NO	Optional, Positional 12
PFREVT	Performance events enabled	SAME, YES, *NO	Optional, Positional 13
STRSTPEVT	Start and stop events enabled	SAME, YES, *NO	Optional, Positional 14
CHAD	Automatic Channel Definition	SAME, YES, *NO	Optional, Positional 15
CHADEV	Automatic Channel Definition events enabled	SAME, YES, *NO	Optional, Positional 16
CHADEXIT	Automatic Channel Definition exit program	Single values: SAME, NONE Other values: `Qualified object name`	Optional, Positional 17
	Qualifier 1: Automatic Channel Definition exit program	Name
	Qualifier 2: Library	Name
MAXMSGL	Max message length	32768-104857600, *SAME	Optional, Positional 18
CCSID	Coded Character Set	`Integer`, *SAME	Optional, Positional 19
CLWLDATA	Cluster workload exit data	`Character value`, SAME, NONE	Optional, Positional 20
CLWLEXIT	Cluster workload exit	Single values: SAME, NONE Other values: `Qualified object name`	Optional, Positional 21
	Qualifier 1: Cluster workload exit	Name
	Qualifier 2: Library	Name
CLWLLEN	Cluster workload exit length	0-999999999, *SAME	Optional, Positional 22
REPOS	Repository name	`Character value`, NONE, SAME	Optional, Positional 23
REPOSNL	Repository name list	`Character value`, NONE, SAME	Optional, Positional 24
SSLCRLNL	TLS CRL Namelist	`Character value`, NONE, SAME	Optional, Positional 25
SSLKEYR	TLS Key Repository	`Character value`, NONE, SAME, *SYSTEM	Optional, Positional 26
SSLKEYRPWD	TLS Repository Password	`Character value`, NONE, SAME	Optional, Positional 27
SSLRSTCNT	TLS key reset count	0-999999999, SAME, NONE	Optional, Positional 28
IPADDRV	IP protocol	SAME, IPv4, *IPv6	Optional, Positional 29
CLWLMRUC	Cluster workload channels	0-999999999, *SAME	Optional, Positional 30
CLWLUSEQ	Cluster workload queue use	SAME, LOCAL, *ANY	Optional, Positional 31
LOGGEREVT	Log recovery events enabled	SAME, YES, *NO	Optional, Positional 32
CHLEVT	Channel events enabled	SAME, YES, NO, EXCEPTION	Optional, Positional 33
SSLEVT	TLS events enabled	SAME, YES, *NO	Optional, Positional 34
SCHINIT	Channel initiator control	SAME, QMGR, *MANUAL	Optional, Positional 35
SCMDSERV	Command server control	SAME, QMGR, *MANUAL	Optional, Positional 36
MONQ	Queue Monitoring	SAME, NONE, OFF, LOW, MEDIUM, HIGH	Optional, Positional 37
MONCHL	Channel Monitoring	SAME, NONE, OFF, LOW, MEDIUM, HIGH	Optional, Positional 38
MONACLS	Cluster Sender Monitoring	SAME, QMGR, NONE, LOW, MEDIUM, HIGH	Optional, Positional 39
STATMQI	Queue Manager Statistics	SAME, OFF, *ON	Optional, Positional 40
STATQ	Queue Statistics	SAME, NONE, OFF, ON	Optional, Positional 41
STATCHL	Channel Statistics	SAME, NONE, OFF, LOW, MEDIUM, HIGH	Optional, Positional 42
STATACLS	Cluster Sender Statistics	SAME, QMGR, NONE, LOW, MEDIUM, HIGH	Optional, Positional 43
STATINT	Statistics Interval	1-604800, *SAME	Optional, Positional 44
ACCTMQI	MQI Accounting	SAME, OFF, *ON	Optional, Positional 45
ACCTQ	Queue Accounting	SAME, NONE, OFF, ON	Optional, Positional 46
ACCTINT	Accounting Interval	1-604800, *SAME	Optional, Positional 47
ACCTCONO	Accounting Override	SAME, ENABLED, *DISABLED	Optional, Positional 48
ROUTEREC	Trace Route Recording	SAME, MSG, QUEUE, DISABLED	Optional, Positional 49
ACTIVREC	Activity Recording	SAME, MSG, QUEUE, DISABLED	Optional, Positional 50
MAXPROPLEN	Maximum Property Data Length	0-104857600, SAME, ANY	Optional, Positional 51
MARKINT	Message mark-browse interval	0-999999999, SAME, ANY	Optional, Positional 52
PSRTYCNT	PubSub max msg retry count	0-999999999, *SAME	Optional, Positional 53
PSNPMMSG	PubSub NPM msg	SAME, DISCARD, *KEEP	Optional, Positional 54
PSNPMRES	PubSub NPM msg response	SAME, NORMAL, SAFE, DISCARD, *KEEP	Optional, Positional 55
PSSYNCPT	PubSub syncpoint	SAME, YES, *IFPER	Optional, Positional 56
PSMODE	Pubsub Engine Control	SAME, ENABLED, DISABLED, COMPATIBLE	Optional, Positional 57
TREELIFE	Topic Tree Life Time	0-604000, *SAME	Optional, Positional 58
CFGEVT	Configuration events enabled	SAME, YES, *NO	Optional, Positional 59
CMDEVT	Command events enabled	SAME, YES, NO, NODSP	Optional, Positional 60
ACTVTRC	Activity tracing	`Character value`, ON, SAME, *OFF	Optional, Positional 61
ACTVCONO	Override activity tracing	`Character value`, DISABLED, SAME, *ENABLED	Optional, Positional 62
CHLAUTH	Channel authentication	`Character value`, DISABLED, SAME, *ENABLED	Optional, Positional 63
CUSTOM	Custom attribute	`Character value`, NONE, SAME, 128 character string	Optional, Positional 64
DFTCLXQ	Default cluster transmission queue type	SAME, SCTQ, *CHANNEL	Optional, Positional 65
CERTLABL	Certificate label	SAME, DFT	Optional, Positional 66
REVDNS	Reverse lookup of host name	SAME, DISABLED, *ENABLED	Optional, Positional 67
CONNAUTH	Connection authentication object	SAME, NONE, 48 character string	Optional, Positional 68
IMGSCHED	Media image scheduling	SAME, MANUAL, *AUTO	Optional, Positional 69
IMGINTVL	Media image write interval	SAME, OFF, 1 - 999999999	Optional, Positional 70
IMGLOGLN	Recovery log target size	SAME, OFF, 1 - 999999999	Optional, Positional 71
IMGRCOVO	Whether objects recoverable	SAME, NO, *YES	Optional, Positional 72
IMGRCOVQ	Queue object attribute	SAME, NO, *YES	Optional, Positional 73

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

The possible values are:

*DFT: Use the default queue manager.
queue-manager-name: Specify the name of the queue manager. The name can contain up to 48 characters. The maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Force (FORCE)

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

DFTTMQ is specified.
An application has a remote queue open, the resolution of which will be affected by this change.

The possible values are:

*NO: The command fails if an open remote queue will be affected.
*YES: The command is forced to complete.

Text 'description' (TEXT)

Specifies the text that briefly describes the queue manager definition.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: The text is set to a blank string.
description: Specify no more than 64 characters enclosed in apostrophes.
Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Trigger interval (TRGITV)

Specifies the trigger time interval, expressed in milliseconds, to be used with queues that have TRGTYPE(*FIRST) specified.

When TRGTYPE(*FIRST) is specified the arrival of a message on a previously empty queue causes a trigger message to be generated. Any further messages that arrive on the queue within the specified interval will not cause a further trigger message to be generated.

The possible values are:

*SAME: The attribute is unchanged.
interval-value: Specify a value in the range 0 through 999999999.

Undelivered message queue (UDLMSGQ)

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 possible values are:

*SAME: The attribute is unchanged.
*NONE: There is no undelivered-message queue. The attribute is set to a blank string.
undelivered-message-queue-name: Specify the name of a local queue that is to be used as the undelivered-message queue.

Default transmission queue (DFTTMQ)

Specifies the name of the local transmission queue that is to be used as the default transmission queue. Messages transmitted to a remote queue manager are put on the default transmission queue if there is no transmission queue defined for their destination.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: There is no default transmission queue. The attribute is set to a blank string.
default-transmission-queue-name: Specify the name of a local transmission queue that is to be used as the default transmission queue.

Maximum handle limit (MAXHDL)

Specifies the maximum number of handles that any one job can have open at the same time.

The possible values are:

*SAME: The attribute is unchanged.
maximum-handle-limit: Specify a value in the range 0 through 999999999.

Maximum uncommitted messages (MAXUMSG)

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 and report 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.

The possible values are:

*SAME: The attribute is unchanged.
maximum-uncommitted-messages: Specify a value in the range 1 through 999999999.

Authorization events enabled (AUTEVT)

Specifies whether authorization (Not Authorized) events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Authorization events are not generated.
*YES: Authorization events are generated.

Inhibit events enabled (INHEVT)

Specifies whether inhibit events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Inhibit events are not generated.
*YES: Inhibit events are generated.

Local error events enabled (LCLERREVT)

Specifies whether local error events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Local error events are not generated.
*YES: Local error events are generated.

Remote error events enabled (RMTERREVT)

Specifies whether remote error events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Remote error events are not generated.
*YES: Remote error events are generated.

Performance events enabled (PFREVT)

Specifies whether performance events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Performance events are not generated.
*YES: Performance events are generated.

Start and stop events enabled (STRSTPEVT)

Specifies whether start and stop events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Start and stop events are not generated.
*YES: Start and stop events are generated.

Automatic Channel Definition (CHAD)

Specifies whether receiver and server-connection channels are automatically defined.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Receiver and server-connection channels are not automatically defined.
*YES: Receiver and server-connection channels are automatically defined.

Automatic Channel Definition events enabled (CHADEV)

Specifies whether automatic channel definition events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Automatic channel definition events are not generated.
*YES: Automatic channel definition events are generated.

Automatic Channel Definition exit program (CHADEXIT)

Specifies the entry point of the program to be called as the automatic channel-definition exit.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: No automatic channel definition exit is invoked.
channel-definition-exit-name: Specify the name of the channel definition exit program.
library-name: Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified and the values *LIBL and *CURLIB are not permitted.

Maximum Message Length (MAXMSGL)

Specifies the maximum message length of messages (in bytes) allowed on queues for this queue manager.

The possible values are:

*SAME: The attribute is unchanged.
maximum-message-length: Specify a value in bytes, in the range 32 KB through 100 MB.

Coded Character Set (CCSID)

The coded character set identifier for the queue manager.

The CCSID is the identifier used with all character string fields defined by the API. It does not apply to application data carried in the text of messages unless the CCSID in the message descriptor is set to the value MQCCSI_Q_MGR when the message is put to a queue.

If you use this keyword to change the CCSID, applications that are running when the change is applied continue to use the original CCSID. You must stop and restart all running applications before you continue. This includes the command server and channel programs. You are recommended to stop and restart the queue manager after making the change to achieve this.

The possible values are:

*SAME: The attribute is unchanged.
number: Specify a value in the range 1 through 65535. The value must represent a coded character set identifier (CCSID) that is recognised by the system.

Cluster Workload Exit Data (CLWLDATA)

Specifies the cluster workload exit data (maximum length 32 characters).

The possible values are:

*SAME: The attribute is unchanged.
*NONE: The cluster workload exit data is not specified.
cluster-workload-exit-data: This is passed to the cluster-workload exit when it is called.

Cluster Workload Exit (CLWLEXIT)

Specifies the entry point of the program to be called as the cluster-workload exit.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: No cluster-workload exit is invoked.
cluster-workload-exit: You must specify a fully-qualified name, when you specify a cluster-workload exit. In this instance, the libraries defined as *LIBL and *CURLIB are not permitted.

Cluster Workload Exit Data Length (CLWLLEN)

The maximum number of bytes of message data that is passed to the cluster workload exit.

The possible values are:

*SAME: The attribute is unchanged.
cluster-workload-exit-data-length: Specify a value in bytes, in the range 0 through 999999999.

Repository name (REPOS)

The name of a cluster for which this queue manager is to provide a repository manager service.

If the parameter REPOSNL is non-blank this parameter must be blank.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: A cluster is not specified.
clustername: The maximum length is 48 characters conforming to the rules for naming IBM® MQ objects.

Repository name list (REPOSNL)

The name of a namelist of clusters for which this queue manager is to provide a repository manager service.

If the parameter REPOS is non-blank this parameter must be blank.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: A namelist of clusters is not specified.
namelist: The name of the namelist.

TLS CRL Namelist (SSLCRLNL)

The name of a namelist of authinfo objects which this queue manager uses to check certificate status.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: A namelist of authinfo objects is not specified.
namelist: The name of the namelist.

TLS Key Repository (SSLKEYR)

The location of a key repository for this queue manager.

The possible values are:

*SAME: The attribute is unchanged.
*SYSTEM: The queue manager uses the *SYSTEM key repository. Setting the SSLKEYR repository to this value causes the queue manager to be registered as an application to Digital Certificate Manager. You can assign any client or server certificate in the *SYSTEM store to the queue manager through Digital Certificate Manager. If you specify this value you are not required to set the key repository password (SSLKEYRPWD).
*NONE: A key repository is not specified.
filename: The location of the key repository. If you specify this value you are must ensure the key repository contains a correctly labeled digital certificate and also set the key repository password (SSLKEYRPWD) to enable channels to access the key repository. See the IBM MQ Security manual for more details.

TLS Repository Password (SSLKEYRPWD)

The password of a key repository for this queue manager.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: A key repository password is not specified.
password: The password of the repository.

TLS key reset count (SSLRSTCNT)

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

The possible values are:

*SAME: The attribute is unchanged.
*NONE: Secret key renegotiation is disabled.
key-reset-byte-count: Specify a value in bytes, in the range 0 through 999999999. A value of 0 indicates that secret key renegotiation is disabled.

IP protocol (IPADDRV)

The IP protocol to use for channel connections.

This attribute is only relevant for systems enabled for both IPv4 and IPv6. The attribute affects channels with TRPTYPE defined as TCP when the CONNAME is defined as a host name that resolves to both an IPv4, and an IPv6 address, and one of the following is true:

LOCLADDR is not specified.
LOCLADDR also resolves to both an IPv4 and an IPv6 address.

The possible values are:

*SAME: The attribute is unchanged.
*IPv4: The IPv4 stack is used.
*IPv6: The IPv6 stack is used.

Cluster workload channels (CLWLMRUC)

Specifies the maximum number of most-recently-used cluster channels, to be considered for use by the cluster workload choice algorithm.

The possible values are:

*SAME: The attribute is unchanged.
maximum-cluster-workload-channels: Specify a value in the range 0 through 999999999.

Cluster workload queue use (CLWLUSEQ)

Specifies the behavior of an MQPUT when the target queue has both a local instance and at least one remote cluster instance. If the put originates from a cluster channel then this attribute does not apply. This value is used for queues where the CLWLUSEQ value is *QMGR.

The possible values are:

*SAME: The attribute is unchanged.
*LOCAL: The local queue will be the sole target of the MQPUT.
*ANY: The queue manager will treat such a local queue as another instance of the cluster queue for the purposes of workload distribution.

Log recovery events enabled (LOGGEREVT)

Specifies whether log recovery events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Log recovery events are not generated.
*YES: Log recovery events are generated.

Channel events enabled (CHLEVT)

Specifies whether channel events are generated.

The possible values are:

*SAME

The attribute is unchanged.

*NO

Channel events are not generated.

*EXCEPTION

Exception channel events are generated.

Only the following channel events are generated:

MQRC_CHANNEL_ACTIVATED
MQRC_CHANNEL_CONV_ERROR
MQRC_CHANNEL_NOT_ACTIVATED
MQRC_CHANNEL_STOPPED
The channel events are issued with the following reason qualifiers:
- MQRQ_CHANNEL_STOPPED_ERROR
- MQRQ_CHANNEL_STOPPED_RETRY
- MQRQ_CHANNEL_STOPPED_DISABLED
- MQRC_CHANNEL_STOPPED_BY_USER

*YES

All channel events are generated.

In addition to those generated by *EXCEPTION the following channel events are also generated:

MQRC_CHANNEL_STARTED
MQRC_CHANNEL_STOPPED
with the following reason qualifier:
- MQRQ_CHANNEL_STOPPED_OK

TLS events enabled (SSLEVT)

Specifies whether TLS events are generated.

The possible values are:

*SAME

The attribute is unchanged.

*NO

TLS events are not generated.

*YES

TLS events are generated.

The following event is generated:

MQRC_CHANNEL_SSL_ERROR

Channel initiator control (SCHINIT)

Specifies the channel initiator control.

The possible values are:

*SAME: The attribute is unchanged.
*QMGR: Start and stop the channel initiator with the queue manager.
*MANUAL: Do not automatically start the channel initiator with the queue manager.

Command server control (SCMDSERV)

Specifies the command server control.

The possible values are:

*SAME: The attribute is unchanged.
*QMGR: Start and stop the command server with the queue manager.
*MANUAL: Do not automatically start the command server with the queue manager.

Queue Monitoring (MONQ)

Controls the collection of online monitoring data for queues.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: Online monitoring data for queues is disabled regardless of the setting of the MONQ queue attribute.
*OFF: Monitoring data collection is turned off for queues specifying *QMGR in the MONQ queue attribute.
*LOW: Monitoring data collection is turned on with a low ratio of data collection for queues specifying *QMGR in the MONQ queue attribute.
*MEDIUM: Monitoring data collection is turned on with a moderate ratio of data collection for queues specifying *QMGR in the MONQ queue attribute.
*HIGH: Monitoring data collection is turned on with a high ratio of data collection for queues specifying *QMGR in the MONQ queue attribute.

Channel Monitoring (MONCHL)

Controls the collection of online monitoring data for channels.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: Online monitoring data for channels is disabled regardless of the setting of the MONCHL channel attribute.
*OFF: Monitoring data collection is turned off for channels specifying 'QMGR' in the MONCHL queue attribute.
*LOW: Monitoring data collection is turned on with a low ratio of data collection for channels specifying *QMGR in the MONCHL channel attribute.
*MEDIUM: Monitoring data collection is turned on with a moderate ratio of data collection for channels specifying *QMGR in the MONCHL channel attribute.
*HIGH: Monitoring data collection is turned on with a high ratio of data collection for channels specifying *QMGR in the MONCHL channel attribute.

Cluster Sender Monitoring (MONACLS)

Controls the collection of online monitoring data for auto-defined cluster sender channels. The possible values are:

*SAME: The attribute is unchanged.
*NONE: Online monitoring data for auto-defined cluster sender channels is disabled.
*QMGR: The collection of Online Monitoring Data is inherited from the setting of the MONCHL attribute in the QMGR object.
*LOW: Monitoring data collection is turned on with a low ratio of data collection for auto-defined cluster sender channels.
*MEDIUM: Monitoring data collection is turned on with a moderate ratio of data collection for auto-defined cluster sender channels.
*HIGH: Monitoring data collection is turned on with a high ratio of data collection for auto-defined cluster sender channels.

Queue Manager Statistics (STATMQI)

Controls the collection of statistics monitoring information for the queue manager. The possible values are:

*SAME: The attribute is unchanged.
*OFF: Data collection for MQI statistics is disabled.
*ON: Data collection for MQI statistics is enabled.

Queue Statistics (STATQ)

Controls the collection of statistics data for queues. The possible values are:

*SAME: The attribute is unchanged.
*NONE: Data collection for queue statistics is disabled for all queues regardless of the setting of the STATQ queue attribute.
*OFF: Statistics data collection is turned off for queues specifying *QMGR in the STATQ queue attribute.
*ON: Statistics data collection is turned on for queues specifying *QMGR in the STATQ queue attribute.

Channel Statistics (STATCHL)

Controls the collection of statistics data for channels. The possible values are:

*SAME: The attribute is unchanged.
*NONE: Data collection for channel statistics is disabled for all channels regardless of the setting of the STATCHL channel attribute.
*OFF: Statistics data collection is turned off for channels specifying *QMGR in the STATCHL channel attribute.
*LOW: Statistics data collection is turned on with a low ratio of data collection for channels specifying *QMGR in the STATCHL channel attribute.
*MEDIUM: Statistics data collection is turned on with a moderate ratio of data collection for channels specifying *QMGR in the STATCHL channel attribute.
*HIGH: Statistics data collection is turned on with a high ratio of data collection for channels specifying *QMGR in the STATCHL channel attribute.

Cluster Sender Statistics (STATACLS)

Controls the collection of statistics data for auto-defined cluster sender channels. The possible values are:

*SAME: The attribute is unchanged.
*NONE: Statistics data collection for auto-defined cluster sender channels is disabled.
*LOW: Statistics data collection for auto-defined cluster sender channels is enabled with a low ratio of data collection.
*MEDIUM: Statistics data collection for auto-defined cluster sender channels is enabled with a moderate ratio of data collection.
*HIGH: Statistics data collection for auto-defined cluster sender channels is enabled with a high ratio of data collection.

Statistics Interval (STATINT)

How often (in seconds) statistics monitoring data is written to the monitoring Queue.

The possible values are:

*SAME: The attribute is unchanged.
statistics-interval: Specify a value in the range 1 through 604800.

MQI Accounting (ACCTMQI)

Controls the collection of accounting information for MQI data. The possible values are:

*SAME: The attribute is unchanged.
*OFF: API accounting data collection is disabled.
*ON: API accounting data collection is enabled.

Queue Accounting (ACCTQ)

Controls the collection of accounting information for queues. The possible values are:

*SAME: The attribute is unchanged.
*NONE: Accounting data collection for queues is disabled and may not be overridden using the queue attribute ACCTQ.
*OFF: Accounting data collection is turned off for queues specifying *QMGR in the ACCTQ queue attribute.
*ON: Accounting data collection is turned on for queues specifying *QMGR in the ACCTQ queue attribute.

Accounting Interval (ACCTINT)

After how long in seconds, intermediate accounting records are written.

The possible values are:

*SAME: The attribute is unchanged.
accounting-interval: Specify a value in the range 1 through 604800.

Accounting Override (ACCTCONO)

Whether applications can override the setting of the ACCTMQI and the ACCTQ values in the QMGR attribute. The possible values are:

*SAME: The attribute is unchanged.
*ENABLED: Application may override the setting of the ACCTMQI and ACCTQ QMGR attributes using the Options field in the MQCNO structure on the MQCONNX api call.
*DISABLED: Application may not override the setting of the ACCTMQI and ACCTQ QMGR attributes using the Options field in the MQCNO structure on the MQCONNX api call.

Trace Route Recording (ROUTEREC)

Controls the recording of trace route information.

The possible values are:

*SAME: The attribute is unchanged.
*MSG: Reply put to destination specified by the message.
*QUEUE: Reply put to fixed name queue.
*DISABLED: No appending to trace route messages allowed.

Activity Recording (ACTIVREC)

Controls the generation of activity reports.

The possible values are:

*SAME: The attribute is unchanged.
*MSG: Report put to destination specified by the message.
*QUEUE: Report put to fixed name queue.
*DISABLED: No activity reports are generated.

Maximum Property Data Length (MAXPROPLEN)

Specifies a maximum length for property data.

The possible values are:

*SAME: The attribute is unchanged.
*ANY: There is no limit on the length of property data.
max-property-data-length: Specify a value in bytes, in the range 0 through 104857600 (ie: 10 MB).

Message mark-browse interval (MARKINT)

An approximate time interval in milliseconds, for which messages that have been marked-browsed by a call to MQGET with the get message option MQGMO_MARK_BROWSE_CO_OP are expected to remain marked-browsed.

The possible values are:

*SAME: The attribute is unchanged.
*ANY: Messages will remain marked-browsed indefinitely.
A time interval: A time interval expressed in milliseconds, up to a maximum of 999999999. The default value is 5000.
Attention: You should not reduce the value below the default of 5000.

PubSub max msg retry count (PSRTYCNT)

The number of retries when processing (under syncpoint) a failed command message.

The possible values are:

*SAME: The attribute is unchanged.
Retry count: Specify a value in the range 0 through 999999999.

PubSub NPM msg (PSNPMMSG)

Whether to discard (or keep) a undelivered input message

The possible values are:

*SAME: The attribute is unchanged.
*DISCARD: Non-persistent input messages may be discarded if they cannot be processed.
*KEEP: Non-persistent input messages will not be discarded if they cannot be processed. In this situation the queued pubsub daemon will continue to retry processing the message. Subsequent input messages are not processed until the message is successfully processed.

PubSub NPM msg response (PSNPMRES)

Controls the behavior of undelivered response messages

The possible values are:

*SAME: The attribute is unchanged.
*NORMAL: Non-persistent responses that cannot be placed on the reply queue are put on the dead letter queue. If they cannot be placed on the dead letter queue then they are discarded.
*SAFE: Non-persistent responses which cannot be placed on the reply queue are put on the dead letter queue. If the response cannot be placed on the dead letter queue then the message will be rolled back and then retried. Subsequent messages are not processed until the message is delivered.
*DISCARD: Non-persistent responses are not placed on the reply queue but are discarded.
*KEEP: Non-persistent responses that cannot be delivered will be rolled back and the delivery retried. Subsequent messages are not processed until the message is delivered.

PubSub syncpoint (PSSYNCPT)

Whether only persistent (or all) messages should be processed under syncpoint

The possible values are:

*SAME: The attribute is unchanged.
*IFPER: This makes the queued pubsub daemon receive non-persistent messages outside syncpoint. If the daemon receives a publication outside syncpoint, the daemon forwards the publication to subscribers known to it outside syncpoint.
*YES: This makes the queued pubsub daemon receive all messages under syncpoint.

Pubsub Engine Control (PSMODE)

Pubsub Engine Control.

The possible values are:

*SAME: The attribute is unchanged.
*ENABLED: The publish/subscribe engine and the queued publish/subscribe interface are running. It is therefore possible to publish/subscribe by using the application programming interface, the queues that are being monitored by the queued publish/subscribe interface, or both.
*DISABLED: The publish/subscribe engine and the queued publish/subscribe interface are not running. It is not possible to publish/subscribe by using the application programming interface. Any publish/subscribe messages put to the queues that are monitored by the queued publish/subscribe interface will not be acted upon.
*COMPATIBLE: The publish/subscribe engine is running. It is possible to publish subscribe by using the application programming interface. The queued publish/subscribe interface is not running. Any publish/subscribe messages put to the queues that are monitored by the queued publish/subscribe interface will not be acted upon. Use this for compatibility with WebSphere Message Broker V6, or earlier versions, using this queue manager

Topic Tree Life Time (TREELIFE)

Specifies a lifetime in seconds of non-administrative topics. Non-administrative topics are those created when an application publishes to, or subscribes on, a topic string that does not exist as an administrative node. When this non- administrative node no longer has any active subscriptions, this parameter determines how long the queue manager will wait before removing that node. Only non-administrative topics that are in use by a durable subscription remain after the queue manager is recycled.

The possible values are:

*SAME: The attribute is unchanged.
tree-life-time: Specify a value in seconds, in the range 0 through 604000. A value of 0 means that non-administrative topics are not removed by the queue manager.

Configuration events enabled (CFGEVT)

Specifies whether configuration events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Configuration events are not generated.
*YES: Configuration events are generated. After setting this value, issue MQSC REFRESH QMGR TYPE(CONFIGEV) commands for all objects to bring the queue manager configuration up to date.

Command events enabled (CMDEVT)

Specifies whether command events are generated.

The possible values are:

*SAME: The attribute is unchanged.
*NO: Command events are not generated.
*YES: Command events are generated for all successful commands.
*NODSP: Command events are generated for all successful commands, other than DISPLAY commands.

ACTVTRC

This attribute specifies whether MQI application activity tracing information is to be collected. See Setting ACTVTRC to control collection of activity trace information.

*SAME: The attribute is unchanged.
*OFF: IBM MQ MQI application activity tracing information collection is not enabled.
*ON: IBM MQ MQI application activity tracing information collection is enabled.
If the queue manager attribute ACTVCONO is set to ENABLED, the value of this parameter can be overridden using the options field of the MQCNO structure.

ACTVCONO

This attribute specifies whether applications can override the settings of the ACTVTRC queue manager parameter:

*SAME: The attribute is unchanged. This is the default value
*DISABLED: Applications cannot override the settings of the ACTVTRC queue manager parameter.
*ENABLED: Applications can override the settings of the ACTVTRC queue manager parameter by using the options field of the MQCNO structure of the MQCONNX API call.

Changes to this parameter are effective for connections to the queue manager that occur after the change.

CHLAUTH

This attribute specifies whether the rules defined by channel authentication records are used. CHLAUTH rules can still be set and displayed regardless of the value of this attribute.

Changes to this parameter take effect the next time that an inbound channel attempts to start.

Channels that are currently started are unaffected by changes to this parameter.

*SAME: The attribute is unchanged. This is the default value
*DISABLED: Channel authentication records are not checked.
*ENABLED: Channel authentication records are checked.

Custom attribute (CUSTOM)

This attribute is reserved for the configuration of new features before separate attributes have been introduced. This description will be updated when features using this attribute are introduced. At the moment there are no meaningful values for CUSTOM, so leave it empty.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: The text is set to a blank string.
128 character custom string: Specify zero or more attributes as pairs of attribute name and value, separated by at least one space. The attribute name-value pairs must have the form NAME(VALUE) and be specified in uppercase. Single quotes must be escaped with another single quote.

Default cluster transmission queue type (DFTCLXQ)

The DEFCLXQ attribute controls which transmission queue is selected by default by cluster-sender channels to get messages from, to send the messages to cluster-receiver channels.

The possible values are:

*SAME

The attribute is unchanged.

*SCTQ

All cluster-sender channels send messages from SYSTEM.CLUSTER.TRANSMIT.QUEUE. The correlID of messages placed on the transmission queue identifies which cluster-sender channel the message is destined for.

SCTQ is set when a queue manager is defined. This behavior is implicit in versions of IBM WebSphere® MQ, earlier than IBM WebSphere MQ 7.5. In earlier versions, the queue manager attribute DefClusterXmitQueueType was not present.

*CHANNEL

Each cluster-sender channel sends messages from a different transmission queue. Each transmission queue is created as a permanent dynamic queue from the model queue SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE.

CERTLABL

This attribute specified the certificate label for this queue manager to use. The label identifies which personal certificate in the key repository has been selected.

The default and migrated queue manager values on IBM i, are:

If you specified SSLKEYR(*SYSTEM), the value is blank.
Note that it is forbidden to use a nonblank queue manager CERTLABL with SSLKEYR(*SYSTEM). Attempting to do so results in an MQRCCF_Q_MGR_ATTR_CONFLICT error.
Otherwise, ibmwebspheremqxxxx where xxxx is the queue manager name folded to lowercase.

The possible values are:

*SAME: The attribute is unchanged.
*DFT: Leaving CERTLABL as a blank value on the queue manager is interpreted by the system to mean the default values specified.

REVDNS

This attribute controls whether reverse lookup of the host name from a Domain Name Server (DNS) is done for the IP address from which a channel has connected. This attribute has an effect only on channels using a transport type (TRPTYPE) of TCP.

The possible values are:

*SAME: The attribute is unchanged.
*ENABLED: DNS host names are reverse looked-up for the IP addresses of inbound channels when this information is required. This setting is required for matching against CHLAUTH rules that contain host names, and to include the host name in error messages. The IP address is still included in messages that provide a connection identifier.
This is the initial default value for the queue manager.
*DISABLED: DNS host names are not reverse looked-up for the IP addresses of inbound channels. With this setting any CHLAUTH rules using host names are not matched.

CONNAUTH

This attribute specifies the name of an authentication information object that is used to provide the location of user ID and password authentication. If CONNAUTH is *NONE, no user ID and password checking is done by the queue manager.

Changes to this configuration, or the object to which it refers, take effect when a REFRESH SECURITY TYPE(CONNAUTH) command is issued.

If you set CONNAUTH to *NONE, and attempt to connect to a channel that has the REQDADM option set in the CHCKCLNT field, the connection fails.

The possible values are:

*SAME: The attribute is unchanged.
*NONE: No user ID and password checking is done by the queue manager
48 character conn auth string: The specific name of an authentication information object that is used to provide the location of user ID and password authentication.

IMGSCHED

This attribute specifies whether the queue manager automatically writes media images.

The possible values are:

*SAME: The attribute is unchanged.
*AUTO: The queue manager attempts to automatically write a media image for an object, before IMGINTVL minutes have elapsed, or IMGLOGLN megabytes of recovery log have been written, since the previous media image for the object was taken.
The previous media image might have been taken manually or automatically, depending on the settings of IMGINTVL or IMGLOGLN.
*MANUAL: Automatic media images are not written.

IMGINTVL

This attribute specifies the target frequency with which the queue manager automatically writes media images, in minutes since the previous media image for the object.

The possible values are:

*SAME: The attribute is unchanged.
1 - 999 999 999: The time in minutes at which the queue manager automatically writes media images.
*OFF: Automatic media images are not written on a time interval basis.

IMGLOGLN

This attribute specifies the target size of recovery log, written before the queue manager automatically writes media images, in number of megabytes since the previous media image for the object. This limits the amount of log to be read when recovering an object.

The possible values are:

*SAME: The attribute is unchanged.
1 - 999 999 999: The target size of the recovery log in megabytes.
*OFF: Automatic media images are not written based on the size of log written.

IMGRCOVO

This attribute specifies whether authentication information, channel, client connection, listener, namelist, process, alias queue, remote queue, and service objects are recoverable from a media image, if linear logging is being used.

The possible values are:

*SAME: The attribute is unchanged.
*NO: The RCDMQMIMG (Record MQ Object Image) and RCRMQMOBJ (Re-create MQ Object) commands are not permitted for these objects, and automatic media images, if enabled, are not written for these objects.
*YES: These objects are recoverable.

IMGRCOVQ

This attribute specifies the IMGRCOVQ attribute for local and permanent dynamic queue objects, when used with this parameter.

The possible values are:

*SAME: The attribute is unchanged.
*NO: The IMGRCOVQ attribute for local and permanent dynamic queue objects is set to *NO.
*YES: The IMGRCOVQ attribute for local and permanent dynamic queue objects is set to *YES.