IBM Support What's New?

New objects and new attributes for objects in WebSphere MQ 7.1, 7.5, 8.0 and 9.0

Technote (FAQ)


Question

You want to know if there are new objects and new attributes for objects in WebSphere MQ 7.1, 7.5, 8.0 and 9.0

Answer


++ New objects in MQ 7.1 (included in MQ 7.5 and later)

These are shown as new folders in the MQ Explorer 7.1 and later versions

CHLAUTH => New in 7.1

WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
SET CHLAUTH
Use the MQSC command SET CHLAUTH to create or modify a channel authentication record.

COMMINFO => New in 7.1
WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
DEFINE COMMINFO
Use the MQSC command DEFINE COMMINFO to define a new communication information object. These objects contain the definitions required for Multicast messaging.
.
It uses the new object SYSTEM.DEFAULT.COMMINFO.MULTICAST
... which is stored in the file:
/var/mqm/qmgrs/QMGR/comminfo/SYSTEM!DEFAULT!COMMINFO!MULTICAST


++ The rest of this technote provides the details on the rest of the new attributes on existing objects

Object: Local Queue (QLOCAL)
New attribute: CUSTOM => New in 7.1
WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
ALTER queues
CUSTOM(string)
The custom attribute for new features.
This attribute is reserved for the configuration of new features before separate attributes are introduced.

Object: Transmission Queues:
New attribute: CLCHNAME => New in 7.5
WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
ALTER queues
CLCHNAME(channel name)
CLCHNAME is the generic name of the cluster-sender channels that use this queue as a transmission queue. The attribute specifies which cluster-sender channels send messages to a cluster-receiver channel from this cluster transmission queue.

Object: Topic
New attributes:
COMMINFO => New in 7.1

CUSTOM => New in 7.1

MCAST => New in 7.1

WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
DEFINE TOPIC
MCAST: Specifies whether multicast is allowable in the topic tree.

USEDLQ => New in 7.1

WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
DEFINE TOPIC
USDELQ: Determines whether the dead-letter queue is used when publication messages cannot be delivered to their correct subscriber queue.

CLROUTE => New in 8.0

WebSphere MQ 8.0.0>WebSphere MQ>Reference>Administration reference>MQSC reference>The MQSC commands>
DEFINE TOPIC
CLROUTE - The routing behavior to use for topics in the cluster defined by the CLUSTER parameter.
DIRECT - When you configure a direct routed clustered topic on a queue manager, all queue managers in the cluster become aware of all other queue managers in the cluster. When performing publish and subscribe operations, each queue manager can connect direct to any other queue manager in the cluster.
TOPICHOST - When you use topic host routing, all queue managers in the cluster become aware of the cluster queue managers that host the routed topic definition (that is, the queue managers on which you have defined the topic object). When performing publish and subscribe operations, queue managers in the cluster connect only to these topic host queue managers, and not directly to each other. The topic host queue managers are responsible for routing publications from queue managers on which publications are published to queue managers with matching subscriptions.


+ Channels


WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands
DEFINE CHANNEL

Object: Server-Connection Channel (SVRCONN)
New attribute: DISCINT => New in 7.1 for Distributed (Unix, Windows)
The minimum time in seconds for which the channel waits for a message to arrive on the transmission queue, after a batch ends, before terminating the channel. A value of zero causes the message channel agent to wait indefinitely.
The value must be in the range zero through 999 999.
In MQ 7.0: This parameter is valid only for SVRCONN on z/OS and for SDR, SVR, CLUSSDR, CLUSRCVR.
In MQ 7.1 it is available now in Unix and Windows for SVRCONN, and continues to be available for SDR, SVR, CLUSSDR, CLUSRCVR.

Object: Client-Connection Channel (CLNTCONN)
New attribute: DEFRECON => New in 7.1
Specifies whether a client connection automatically reconnects a client application if its connection breaks.

Object: Cluster Receiver Channel (CLUSRCVR)
New attributes:
BATCHLIM => New in 7.1
The limit, in kilobytes, of the amount of data that can be sent through a channel before taking a sync point.

RESETSEQ => New in 7.1
Pending reset sequence number.
This is the sequence number from an outstanding request and it indicates a user RESET CHANNEL command request is outstanding.

USEDLQ => New in 7.1
Determines whether the dead-letter queue is used when messages cannot be delivered by channels.


Object: Cluster Sender Channel (CLUSSDR)
New attributes:
BATCHLIM => New in 7.1
RESETSEQ => New in 7.1
USEDLQ => New in 7.1

Object: Receiver Channel (RCVR)
New attributes:
RESETSEQ => New in 7.1
USEDLQ => New in 7.1

Object: Requester Channel (RQSTR)
New attributes:
RESETSEQ => New in 7.1
USEDLQ => New in 7.1

Object: Sender Channel (SDR)
New attributes:
BATCHLIM => New in 7.1
USEDLQ => New in 7.1

Object: Server Channel (SVR)
New attributes:
BATCHLIM => New in 7.1
RESETSEQ => New in 7.1
USEDLQ => New in 7.1

Object: Channels in general
New attribute in 8.0:
CERTLABL(' ') => Only for certain types: not for CHLTYPE(CLUSSDR)

WebSphere MQ 8.0.0 > WebSphere MQ > Reference > Configuration reference > Channel attributes > Channel attributes in alphabetical order >
Certificate label (CERTLABL)
This attribute specifies the certificate label of the channel definition.
The label identifies which personal certificate in the key repository is sent to the remote peer. The certificate is defined as described in Digital certificate labels.

+ New types for AUTHINFO (New in 8.0)
SYSTEM.DEFAULT.AUTHINFO.IDPWLDAP - AUTHTYPE(IDPWLDAP)
SYSTEM.DEFAULT.AUTHINFO.IDPWOS - AUTHTYPE(IDPWOS)
DEFINE AUTHINFO

AUTHTYPE - The type of authentication information.
CRLLDAP - Certificate Revocation List checking is done using LDAP servers.
IDPWLDAP - Connection authentication user ID and password checking is done using an LDAP server.
IDPWOS - Connection authentication user ID and password checking is done using the operating system.
OCSP - Certificate revocation checking is done using OCSP.


+ Adding attribute CHCKCLNT to CHLAUTH
Example:
SET CHLAUTH('SYSTEM.ADMIN.SVRCONN') +
CHCKCLNT(ASQMGR) +

WebSphere MQ 8.0.0 > WebSphere MQ > Reference > Administration reference > MQSC reference > The MQSC commands >
SET CHLAUTH
CHCKCLNT - Specifies whether the connection that matches this rule and is being allowed in with USERSRC(CHANNEL) or USERSRC(MAP), must also specify a valid user ID and password. REQDADM

+ New attributes for AUTHINFO

WebSphere MQ 8.0.0>IBM MQ>Reference>Administration reference>MQSC reference>The MQSC commands>
DISPLAY AUTHINFO
[V8.0.0.2 Feb 2015] AUTHORMD
Authorization method. Possible values are:
OS - Displays the operating system groups determining permissions
SEARCHGRP - Displays a group entry in the LDAP server, containing an attribute listing all the users belonging to that group.
SEARCHUSR - Displays a user entry in the LDAP server containing an attribute listing all the groups to which the user belongs.
This attribute is not applicable to Windows platforms.
[V8.0.0.2 Feb 2015] BASEDNG
Displays the Base DN for groups. This attribute is not applicable to Windows platforms.
[V8.0.0.2 Feb 2015]CLASSGRP
Displays the LDAP object class for group records. This attribute is not applicable to Windows platforms.
[V8.0.0.2 Feb 2015] FINDGRP
Displays the name of the attribute within an LDAP entry to determine group membership. This attribute is not applicable to Windows platforms.
[V8.0.0.2 Feb 2015] GRPFIELD
Displays the LDAP attribute that represents a simple name for the group. This attribute is not applicable to Windows platforms.
[V8.0.0.2 Feb 2015] NESTGRP
Displays whether a group is a member of another group. This attribute is not applicable to Windows platforms.

WebSphere MQ 8.0.0>IBM MQ>Reference>Administration reference>MQSC reference>The MQSC commands>
DISPLAY AUTHINFO
[V8.0.0.3 Jun 2015] AUTHENMD
Authentication method. Possible values are:
OS - Displays the traditional UNIX platforms password verification method permissions.
PAM - Displays the Pluggable Authentication Method permissions. You can set the PAM value only on UNIX and Linux platforms.

+ New CUSTOM attribute for Queues and Topics

CAPEXPRY ( integer ) - Enforcing lower expiration times.

CUSTOM ( string ) The custom attribute for new features.
[V8.0.0.4 Oct 2015]This attribute contains the values of attributes, as pairs of attribute name and value, separated by at least one space. The attribute name and value pairs have the form NAME(VALUE). Single quotation marks must be escaped with another single quotation mark. CAPEXPRY ( integer )
The maximum time, expressed in tenths of a second, until a message put using an object handle, opened using this object on the resolution path, remains in the system until it becomes eligible for expiry processing.
For more information on message expiry processing, see Enforcing lower expiration times.
integer The value must be in the range one through to 999 999 999.
NOLIMIT. There is no limit on the expiry time of messages put using this object. This is the default value.
Specifying a value for CAPEXPRY that is not valid, does not cause the command to fail. Instead the default value is used.

Note: Only NEW messages that are placed in the queue will be affected by CAPEXPRY. If there are messages in the queue when the CAPEXPRY attribute of the queue is specified/altered, then those existing messages are NOT modified to reflect the new CAPEXPRY.


+ New Feature: AMQP (MQ Light) => New in 8.0.0.4 and 9.0

Even though AMQP was introduced in 8.0.0.4, I am including here the main changes in case that customers from MQ 7.1 migrate directly to MQ 9.0, bypassing 8.0.

DEFINE CHANNEL('SYSTEM.DEF.AMQP') +
CHLTYPE(AMQP) +
AMQPKA(AUTO) +

DEFINE SERVICE('SYSTEM.AMQP.SERVICE') +
CONTROL(MANUAL) +
SERVTYPE(SERVER) +
STARTCMD('+MQ_INSTALL_PATH+\bin\amqp.bat') +
STARTARG('start -m +QMNAME+ -d "+MQ_Q_MGR_DATA_PATH+\." -g "+MQ_DATA_PATH+\."') +
STOPCMD('+MQ_INSTALL_PATH+\bin64\endmqsde.exe') +
STOPARG('-m +QMNAME+ -n "+MQ_SERVICE_NAME+" -t AMQP') +
STDOUT('+MQ_Q_MGR_DATA_PATH+\amqp.stdout') +
STDERR('+MQ_Q_MGR_DATA_PATH+\amqp.stderr') +
DESCR('Manages clients that use the AMQP protocol') +


+++ Reference
MQ 7.1: How to remove a CHLAUTH record

WMQ 7.1 / 7.5 / 8.0 queue manager RC 2035 MQRC_NOT_AUTHORIZED or AMQ4036 when using client connection as an MQ Administrator

See the related presentation for a tutorial on how to use the COMMINFO object:
Multicast in WebSphere MQ V7.1

+++ Related technotes

Technote: 1608033
New SYSTEM queues added in WebSphere MQ 7.1, 7.5, 8.0 and 9.0

Technote: 1578742
New WebSphere MQ 7.1, 7.5, 8.0 and 9.0 attributes in DISPLAY QMGR for new or migrated queue managers

Product Alias/Synonym

WebSphere MQ WMQ

Document information

More support for: WebSphere MQ
Capability

Software version: 7.1, 7.5, 8.0, 9.0

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1620936

Modified date: 2016-06-07