mqsichangebroker command - z/OS

Syntax

z/OS command - BIPCHBK

z/OS console command

Synonym: cb

Parameters

BrokerName
(Required) This parameter must be the first parameter. Specify the name of the broker to modify.

This parameter is implied in the console form of the command.

-s UserNameServerQueueManagerName
(Optional) The name of the WebSphere® MQ queue manager that is associated with the User Name Server.

To remove topic-based security, specify an empty string (two quotation marks, "").

This name is case sensitive; enclose the names in single quotation marks if they are in mixed case.

-j
(Optional) Publish/subscribe access is enabled for the broker. This parameter is valid only with the -s parameter.
-d
(Optional) Publish/subscribe access is not enabled for the broker.
-l UserLilPath
(Optional) A list of paths (directories) from which the broker loads 32-bit loadable implementation libraries (LILs) for user-defined message processing nodes. Use the -l flag for 32–bit LILs.

This name is case sensitive; enclose the names in single quotation marks if they are in mixed case.

Do not include environment variables in this path; WebSphere Event Broker ignores them.

Create your own directory for storing your .lil or .jar files. Do not save them in the WebSphere Event Broker installation directory.

If you specify more than one additional directory, each directory must be separated by the default platform-specific path separator.

-g ConfigurationChangeTimeout
Start of change(Optional) The maximum time (in seconds) that is allowed for a user configuration request to be processed. It defines the length of time taken within the broker to apply to an execution group a configuration change that you have initiated. For example, if you deploy a configuration from the workbench, the broker must respond to the Configuration Manager within this time.

A message flow cannot respond to a configuration change while it is processing an application message. An execution group that has been requested to change its configuration returns a negative response to the deployed configuration message if any one of its message flows does not finish processing an application message and apply the configuration change within this timeout.

Specify the value in seconds, in the range 10 to 3600. The default is 300.

For information about how to set the value for this timeout, see Setting configuration timeouts.

End of change
-k InternalConfigurationTimeout
Start of change(Optional) The maximum time (in seconds) that is allowed for an internal configuration change to be processed. For example, it defines the length of time taken within the broker to start an execution group.End of change

The response time of each execution group differs according to system load and the load of its own processes. The value must reflect the longest response time that any execution group takes to respond. If the value is too low, the broker returns a negative response, and might issue error messages to the local error log.

Specify the value in seconds, in the range 10 to 3600. The default is 60.

For information about how to set the value for this timeout, see Setting configuration timeouts.

-P HTTPListenerPort
(Optional) Enter the number of the port on which the Web services support is listening.

Start of changeThe broker starts this listener when a message flow that includes HTTP nodes or Web services support is started; the default is 7080. End of change

Ensure that the port that you specify has not been specified for any other purpose.

-v StatisticsMajorInterval
(Optional) Specify the interval (in minutes) at which WebSphere Event Broker statistics and accounting is notified that archive records are to be output. The valid range is from 10 to 14400 minutes.

An interval of zero minutes indicates that the operating system has an external method of notification and is not using an internal timer within WebSphere Event Broker.

-y LdapPrincipal
(Optional, but mandatory when ldapCredentials is provided.) The user principal for access to an optional LDAP directory that holds the JNDI administered Initial Context for the JMS provider.
-z LdapCredentials
(Optional, but mandatory when ldapPrincipal is provided.) The user password for access to LDAP.
-c ICUConverterPath
(Optional) A delimited set of directories to search for additional code page converters; the delimiter is a period (.).

The code page converters must be either of the form icudt32_codepagename.cnv, or in an ICU data package called icudt32.dat.

Do not use this parameter to set the converter path if you are using a converter that matches one of the built-in converters that are provided with Version 6.0, and that converter is the local code page for the broker. Use the ICU_DATA environment variable instead.

To change other broker properties, first delete and re-create the broker, and then use the workbench to redeploy the broker's configuration. To change the user ID that is used for database access, see Administering the broker domain.

Examples

z/OS®:
F MQP1BRK,cb g=100,k=200
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. All Rights Reserved.
Last updated : 2009-01-07 15:40:53

an28140_