modifyWMQTopic command

Use the modifyWMQTopic command to change certain parameters of an IBM MQ messaging provider topic.

To run the command, use the AdminTask object of the wsadmin scripting client.

(iSeries) The wsadmin scripting client is run from Qshell. See topic "Configure Qshell to run WebSphere Application Server scripts".

This command is valid only when it is used with WAS v7 and later application servers. Do not use it with earlier versions.

For a list of the available IBM MQ messaging provider administrative commands, plus a brief description of each command, enter at the wsadmin prompt:

print AdminTask.help('WMQAdminCommands')

For overview help on a given command, enter at the wsadmin prompt:

print AdminTask.help('command_name')

After using the command, save the changes to the master configuration. For example.

AdminConfig.save()

Use the modifyWMQTopic command to modify an IBM MQ messaging provider topic defined at the scope at which the command is issued.

We cannot change the name of an topic.

Target object

An IBM MQ messaging provider topic at the specific scope.

Required parameters

The parameters for this command are identical to those used to create an IBM MQ messaging provider topic.

Optional parameters

The parameters for this command are identical to those used to create an IBM MQ messaging provider topic.

the behavior of this command on the -customProperties parameter.

-customProperties

Specify custom properties to be passed to the IBM MQ messaging provider topic implementation. Typically, custom properties are used to set attributes of the topic that are not directly supported through the WebSphere administration interfaces.

Each custom property is specified using name and value table step parameters. Since these are table steps, the order of the two parameters is fixed, so we must always specify the name first and the value second:

• In Jython: [name value]
• In Jacl: {name value}

New name/value pairs are added to the existing set of custom properties using the following rules:

• If the existing set of properties does not contain a property with the same name as that supplied as part of a modify command, the supplied property is added to the set of custom properties, unless the custom property has no value specified, when it is disregarded.

• If the existing set of properties contains a property with the same name as that supplied as part of a modify command, and the modify command also specifies a value for the property, the existing value is replaced by the supplied value.

• If the existing set of properties contains a property with the same name as that supplied as part of a modify command, but the modify command does not specify a value for the property, the property with the same name is deleted from the existing set of custom properties.

Example

• Use Jython:

  wsadmin>AdminTask.modifyWMQTopic("t1(cells/L3A3316Node04Cell/
  nodes/L3A3316Node05|resources.xml#MQTopic_1204538835312)", ["-priority 7"]) 
  t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml#
  QTopic_1204538835312)
  

• Use Jacl:

  wsadmin>$AdminTask modifyWMQTopic 
  t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml#
  QTopic_1204538835312) {-priority 7} 
  t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml#
  QTopic_1204538835312)
  

wsadmin AdminTask

Start the wsadmin scripting client

createWMQTopic command

deleteWMQTopic command

listWMQTopics command

showWMQTopic command

Mapping of administrative console panel names to command names and IBM MQ names