BIP8000-8999: Runtime components - Commands

BIP8001
Unknown flag <insert_1> selected.
Severity
20 : Error
Explanation
When using this command interface the user should only select the supported flags.
Response
Correct and reissue the command.

BIP8002
Selected flag <insert_1> badly formed.
Severity
20 : Error
Explanation
Command flag should be properly specified.
Response
Correct and reissue the command.

BIP8003
Duplicate flag detected.
Severity
20 : Error
Explanation
A flag was selected more than once.
Response
Correct and reissue the command.

BIP8004
Invalid argument <insert_1> specified.
Severity
20 : Error
Explanation
Argument specified should be well formed.
Response
Correct and reissue the command.

BIP8005
Flag or argument <insert_1> missing.
Severity
20 : Error
Explanation
The command will result in no action being taken, a required flag or a flag's argument is missing.
Response
Correct and reissue the command.

BIP8006
Flag missing. One of the flags in list (<insert_1>) must be specified.
Severity
20 : Error
Explanation
When using this command interface the user should select all required flags.
Response
Correct and reissue the command.

BIP8007
Mandatory argument missing.
Severity
20 : Error
Explanation
When using this command interface the user should supply the mandatory argument.
Response
Correct and reissue the command.

BIP8008
Unable to create the Java environment.
Severity
20 : Error
Explanation
The Java environment could not be created.
Response
Ensure that the Java CLASSPATH variable is correct and ensure that the Java runtime executable (JRE) shipped with the product is in its correct directory.

BIP8009
Program name incorrect.
Severity
20 : Error
Explanation
Ensure that the program name (executable) has not been modified.
Response
Correct and reissue the command.

BIP8010
No component name supplied.
Severity
20 : Error
Explanation
This command requires a component name to be supplied.
Response
Correct and reissue the command.

BIP8011
Unable to create the components configuration data.
Severity
20 : Error
Explanation
The command is unable to store the component's configuration data.
Response
Ensure that the userid that is running this command has adequate authority to update the configuration or registry files. Without this authority the registry or configuration files cannot be updated. Also check that the broker name does not contain invalid characters or is too long.

BIP8012
It was not possible to connect to system components.
Severity
20 : Error
Explanation
The command issued was unable to connect to required system services.
Response
Check your system log for failure information. Ensure that the user name used to issue this command has the required permissions to modify Windows services. Reissue the command when the problem has been resolved.

BIP8013
Broker <insert_1> does not exist.
Severity
20 : Error
Explanation
A broker can be used only if it has already been created.
Response
No user action required.

BIP8014
Component could not be created.
Severity
10 : Warning
Explanation
Unable to create the component, the required resources were unavailable.
Response
Investigate the reasons for the failure, ensure that the userid permissions are correct and that there are sufficient system resources available. Contact your IBM support center if you are unable to resolve the problem.

BIP8015
The component cannot be started.
Severity
20 : Error
Explanation
The command cannot start the required component.
Response
The possible causes of this error are: insufficient user ID permissions; lack of system resources (not enough memory); the WebSphere MQ environment is not configured correctly for the user who is running the command (for example, the mqm library is missing from the user's path).

BIP8016
Unable to stop component.
Severity
20 : Error
Explanation
A request to stop this component was refused.
Response
Investigate the reason for this failure and reissue the command. The problem may be that the component was in the process of being stopped or started, in this case just reissue the command. It may be that the command could not be issued because of insufficient userid permissions. If you are unable to resolve the problem, contact your IBM support center.

BIP8017
The component could not be deleted.
Severity
20 : Error
Explanation
Ensure that the component is in a valid state to be deleted.
Response
Make sure that the component is stopped and reissue the command. Check your system log for failures. If you are unable to resolve the problem contact your IBM support center.

BIP8018
Broker <insert_1> running.
Severity
20 : Error
Explanation
This broker is running; the command you issued cannot be processed when a broker is running.
Response
Stop the broker and reissue the command.

BIP8019
Broker <insert_1> stopped.
Severity
20 : Error
Explanation
This broker is stopped; the command you issued cannot be processed when a broker is stopped.
A previous command has been issued to stop this broker, or this broker has never been started.
Response
This broker can be started, changed, or deleted.

BIP8020
Unable to access the broker's configuration.
Severity
20 : Error
Explanation
The command was unable to access the broker's internal configuration store.
Response
Ensure that the broker's service userid has permission to access the file system.

BIP8021
Ensure that the userid and/or password supplied are correct.
Severity
20 : Error
Explanation
Ensure that the password is valid and that the userid is defined. Ensure that the service does not interact with the desktop.
Response
Correct and reissue the command.

BIP8022
Invalid service userid and password combination supplied.
Severity
20 : Error
Explanation
The userid/password pair are not correct.
Response
Correct and reissue the command.

BIP8023
A valid password must be supplied.
Severity
20 : Error
Explanation
When a userid is altered, a valid password must also be supplied. If you supply a password it must contain at least two characters.
Response
Correct and reissue the command.

BIP8024
Unable to locate the component's executable.
Severity
20 : Error
Explanation
The component's executable is not in the expected directory.
Response
Ensure that the product has not been moved from its installation directory. Check that executable 'bipservice' is in the product's 'bin' directory.

BIP8025
The component is disabled.
Severity
20 : Error
Explanation
The component should not be in a disabled state. The component could not be started.
Response
Investigate why the component is disabled and correct the problem. On Windows this may be because the component's service was 'disabled'.

BIP8026
It was not possible to start the component.
Severity
20 : Error
Explanation
The component could not be started using the service user ID that was supplied when the component was created.
Response
Ensure that the service user ID and password are still valid. Ensure that the service user ID has permission to access all of the product directories, specifically the 'bin' and 'log' directories. Check for system messages. (On Windows this would be the application event log).

BIP8027
It was not possible to start WebSphere MQ.
Severity
20 : Error
Explanation
WebSphere Message Broker requires that WebSphere MQ is installed and its service 'IBM MQSeries' is available.
Response
On Windows the WebSphere MQ service must be available before the WebSphere Message Broker component can be started. The WebSphere MQ service was unable to start. See the event log or syslog to determine the cause of the failure. Correct the problem and reissue the command.

BIP8028
The required product is unavailable.
Severity
20 : Error
Explanation
WebSphere Message Broker requires that WebSphere MQ is installed and that its service 'IBM MQSeries' is available.
Response
Ensure that WebSphere MQ is installed, and that the service is started and running correctly.

BIP8029
The broker's configuration is not yet deployed.
Severity
20 : Error
Explanation
This command results in an internal configuration message to the broker, this message may only be sent after at least one deployment to the broker from the Message Broker Toolkit.
Response
Reissue the command after the broker's configuration has been deployed.

BIP8030
It was not possible to modify user ID privileges.
Severity
20 : Error
Explanation
On Windows the command issued modifies a user ID's privileges, ('logon as service').
Response
Ensure that the user ID issuing this command has sufficient privileges to modify the privileges of the user ID supplied in the command. Ensure that a Domain Controller, either Primary or Backup, is available. Re-execute the command. If the problem persists, contact your IBM support center.

BIP8031
Invalid flag argument supplied.
Severity
20 : Error
Explanation
Ensure that the correct flag arguments are selected.
Response
Correct and reissue the command.

BIP8032
Unable to connect to a WebSphere MQ queue.
Severity
20 : Error
Explanation
An attempt was made to connect to the component's WebSphere MQ Queue Manager and queue, this attempt was unsuccessful.
Response
Ensure that the components WebSphere MQ Queue Manager and queue are available, running and that the user has sufficient authority to access them.

BIP8033
Unable to send an internal configuration message to the broker.
Severity
20 : Error
Explanation
This command was unable to send an internal configuration message to the broker using WebSphere MQ.
Response
Ensure that WebSphere MQ is installed and that the broker and its Queue Manager are running.

BIP8034
An internal configuration response message not received.
Severity
20 : Error
Explanation
This command sends an internal configuration message to the broker, a internal configuration response message was not received from that broker.
Response
Ensure that the broker and its WebSphere MQ Queue Manager are running.

BIP8035
An internal configuration response message was expected from the broker but was not received within its 1 hour timeout or the internal configuration message was rejected as an invalid message.
Severity
20 : Error
Explanation
This command sends an internal configuration message to the broker, it has a predefined 1 hour timeout, if a request exceeds this time then the command is terminated. The internal configuration messages may also be rejected if their format is incorrect.
Response
Investigate why the internal configuration response message was not received within this period. Check the system log messages and ensure that your WebSphere MQ channels and listeners are active and that the broker or User Name Server is active. Contact your IBM support center if you are unable to resolve this problem.

BIP8036
Negative response received.
Severity
20 : Error
Explanation
This command sends an internal configuration message to the broker, the response received indicated that the internal configuration message was unsuccessful.
Response
Check that the WebSphere MQ transport is available. Check the system log for further information.

BIP8037
Unsupported flag. The flags listed in (<insert_1>) are not supported.
Severity
20 : Error
Explanation
When using this command interface the user should only select from the set of supported flags.
Response
Check the list of supported flags, correct and then reissue the command.

BIP8038
An invalid combination of options was selected.
Severity
20 : Error
Explanation
The command specified represents an invalid combination of options and parameters.
Response
Refer to the WebSphere Message Broker online documentation for the list of valid options for this command. Correct and reissue the command.

BIP8039
The execution group is not available.
Severity
20 : Error
Explanation
The execution group could not be found; it may have been deleted by the Message Broker Toolkit or a CMP application.
Response
Use the Message Broker Toolkit or a CMP application to see if the execution group exists.

BIP8040
Unable to connect to the database.
Severity
20 : Error
Explanation
The database cannot be accessed with the specified user Id and password pair.
Response
- Check that the database is running.
- Check that the database has an adequate number of database connections available for use.
- On Windows, check that an ODBC connection has been created.
- On systems that use $ODBCINI, check that the file pointed to by $ODBCINI has been correctly updated.
- On z/OS check the BIPDSNAO member of the component's dataset, and check the DB2 64bit ODBC driver (DSNAO64C) is in the STEPLIB.
- Use mqsisetdbparms to set the password to the correct value and try again.

BIP8041
Unable to open the selected file <insert_1>.
Severity
20 : Error
Explanation
A product component cannot open the specified file for read or write, for example a log file.
Response
Ensure that:
1. The file path is valid.
2. If specified as input, the file exists and is not also specified as output.
3. The file is not locked by another user.

BIP8042
Insufficient memory.
Severity
20 : Error
Explanation
This command requires a significant amount of memory.
Response
Ensure that there is enough memory available to execute the command.

BIP8043
File selected was not a broker trace file.
Severity
20 : Error
Explanation
Broker trace files have an XML tag indicating that they are trace files.
Response
Repeat the trace extraction and reissue the command.

BIP8044
Unable to get the message text for WMB command response <insert_1>.
Severity
20 : Error
Explanation
A response was generated for which there is no message available. This is an internal error and should be reported to IBM together with a trace of the command that caused this message to be issued.
Response
Contact your IBM support center.

BIP8045
The message flow is not available.
Severity
20 : Error
Explanation
The message flow could not be found; it may have been deleted by the Message Broker Toolkit or a CMP application.
Response
Use the Message Broker Toolkit or a CMP application to see if the message flow exists.

BIP8046
Unable to initialize parser data, exception caught <insert_1>.
Severity
20 : Error
Explanation
The command initializes parser functions prior to analyzing XML data, this parser cannot be initialized. Use the line number and column number (inserts 2 and 3 in the exception), to locate the XML causing the problem.
Response
Contact your IBM support center.

BIP8047
Unable to parse the data received, exception caught <insert_1>.
Severity
20 : Error
Explanation
The command uses parser functions to analyze XML data, the parser has detected an error in the format of the XML data being parsed. Use the line number and column number to locate the XML causing the problem.
Response
Check that the data being parsed is correctly formatted. The command may produce partial output. It may also be possible to modify the XML data that the command is parsing so that the error does not occur.

BIP8048
It was not possible to start WebSphere MQ queue manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to start a WebSphere MQ queue manager. The queue manager could not be started.
Response
Check your system and queue manager logs for failure information. Ensure that the user name used to issue this command has the required permissions to start the WebSphere MQ queue manager and its resources. Check that you have an appropriate installation of WebSphere MQ to support a WebSphere Message Broker component. Please see the "Diagnosing errors" section in the information center for more information.

BIP8049
Unable to stop WebSphere MQ Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to stop a WebSphere MQ Queue Manager. The Queue Manager could not be stopped.
Response
Locate and resolve the problem and retry the command.

BIP8050
Unable to create WebSphere MQ Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to create a WebSphere MQ Queue Manager. The Queue Manager could not be created.
Response
Locate and resolve the problem and retry the command.

BIP8051
Unable to create WebSphere MQ Queue <insert_1> on Queue Manager <insert_2>.
Severity
20 : Error
Explanation
This command attempts to create a WebSphere MQ Queue but was unable to do so.
Response
Locate and resolve the problem and retry the command.

BIP8052
Unable to delete WebSphere MQ object <insert_1> from queue manager <insert_2>.
Severity
20 : Error
Explanation
This command attempts to delete a WebSphere MQ object but was unable to do so.
Response
Locate and resolve the problem and retry the command. This could be because a WebSphere MQ channel is still running. If this is the case, stop all WebSphere MQ channels running on behalf of this queue manager. If any applications are connected to your broker, you may need to stop these as well.

BIP8053
Unable to set the security attributes for WebSphere Queue Manager <insert_1>, Group <insert_2>.
Severity
20 : Error
Explanation
This command attempts to set the Group security attributes for a WebSphere Queue Manager.
Response
Ensure that the required Group is available and that the user issuing this command is a member of the mqm group.

BIP8054
Unable to set the security attributes for WebSphere Queue <insert_1> on Queue Manager <insert_2>, Group <insert_3>.
Severity
20 : Error
Explanation
This command attempts to set the Group security attributes for a WebSphere Queue.
Response
Ensure that the required Group is available and that the user issuing this command is a member of the mqm group.

BIP8055
Unable to load a Java class or method <insert_1>.
Severity
20 : Error
Explanation
This command attempts to use a Java class or method, but was unable to run the class or method.
Response
Ensure that the required Java archives (jar files) are in the broker's classes directory.

BIP8056
The component's WebSphere MQ queue manager <insert_1> does not exist.
Severity
20 : Error
Explanation
The command cannot be executed because the queue manager associated with this component does not exist.
Response
Recover the queue manager, or delete and recreate the component.

BIP8057
The command has failed because of an unexpected Queue Manager error.
Severity
20 : Error
Explanation
During execution of the command an unexpected response has been returned from an MQI call.
Response
A message containing further details of the failure will have been issued to your system log. Consult this message for problem resolution.

BIP8059
Command has failed because the component's Queue Manager is not available.
Severity
20 : Error
Explanation
The command has failed because the Queue Manager associated with the component is currently unavailable.
Response
Reissue the command after the queue manager has been restarted.

BIP8062
Join request has failed because parent broker is already a neighbor.
Severity
20 : Error
Explanation
The mqsijoinmqpubsub command has failed because the named parent broker is already a neighbor.
Response
If a previous attempt to join the two brokers using the mqsijoinmqpubsub command has failed then it may be necessary to use mqsiclearmqpubsub first before reissuing the command.

BIP8063
Clear request has failed because specified broker is not a neighbor.
Severity
20 : Error
Explanation
The mqsiclearmqpubsub command has failed because the named broker was not a neighbor.
Response
Reissue the command specifying a broker which is a neighbor.

BIP8064
Command has failed because of an internal component error
Severity
20 : Error
Explanation
The command has failed because of an internal error at the component.
Response
A message containing the further details of the failure will have been issued to the system log. Consult this message for problem resolution.

BIP8065
Join request has failed because broker already has a parent.
Severity
20 : Error
Explanation
The mqsijoinmqpubsub command has failed because the message broker already has a parent WebSphere Publish/Subscribe broker.
Response
Remove the existing parent broker before reissuing the command.

BIP8067
Request has failed because couldn't contact the parent WebSphere publish/subscribe broker.
Severity
20 : Error
Explanation
The mqsijoinmqpubsub command has failed because the supplied WebSphere publish/subscribe broker could not be contacted.
Response
A message containing further details of the failure will have been issued to the system log. The problem is likely to be caused by the parent broker name not resolving to the name of a transmission queue at the queue manager which is hosting the WebSphere Message Broker broker. Correct the underlying problem with the WebSphere network and reissue the command.

BIP8068
Argument <insert_1> is not a valid integer value for this flag.
Severity
20 : Error
Explanation
Ensure that the argument used is a valid integer and in the allowable range.
Response
Correct and reissue the command.

BIP8069
Unable to find message <insert_1> in message catalog <insert_2>.
Severity
20 : Error
Explanation
A message could not be found in the message catalog specified.
Response
Ensure that the message is available in the message catalog and that the catalog is in the product message directory.

BIP8070
Exception accessing database table executing SQL statement <insert_1>: SQL state <insert_2>; exception <insert_3>.
Severity
20 : Error
Explanation
An SQL command has failed.
Response
Ensure that the broker's database is available. Examine the exception and SQL state code to determine and correct the cause of the error.

BIP8071
Successful command completion.
Severity
0 : Information

BIP8072
Exception accessing a database table, executing SQL statement <insert_1>: exception <insert_2>.
Severity
20 : Error
Explanation
An SQL command has failed.
Response
Ensure that the database is available, examine the exception to determine and correct the cause of the error.

BIP8073
<insert_1> is not a valid component.
Severity
20 : Error
Explanation
The name selected is not a valid component.
Response
Select a different component.

BIP8074
Unable to create a JVM.
Severity
20 : Error
Explanation
A Java Virtual Machine could not be created.
Response
Ensure that the Java CLASSPATH variable is correct and that it is not too large, ensure that the Java runtime executable (JRE) shipped with the product is in its correct directory.

BIP8075
A Java exception was caught from class <insert_1>. The text is <insert_2>.
Severity
20 : Error
Explanation
A Java exception was caught via the JNI.
Response
Check preceding messages for related errors and retry the operation. If the exception still occurs, contact your IBM support center.

BIP8076
Current working directory could not be set to <insert_1>.
Severity
20 : Error
Explanation
An error has occurred while the command was running. The command has cleaned up and terminated.
Response
Investigate why the directory <insert_1> can't be accessed, correct the problem and retry the command. If the problem still occurs, contact your IBM support center.

BIP8079
Unable to find service user id <insert_1>.
Severity
20 : Error
Explanation
This user ID is not defined to the operating system, so it cannot be used as a component service user ID.
Response
Create the user ID and reissue the command, or specify a user ID which exists on this system.

BIP8080
Unable to initialize a parser factory.
Severity
20 : Error
Explanation
The command executable detected an error whilst initializing its parser factory.
Response
Contact your IBM support center.

BIP8081
An error occurred while processing the command.
Severity
20 : Error
Explanation
An error occurred while the command was running; the command has cleaned up and ended.
Response
Use messages prior to this one to determine the cause of the error.
Check for some common problems:
Does the user id have the correct authorities (for example a member of the mqbrkrs group)?
Is any operating system limit set too low to allow the command to run?
Is the environment correctly set up?
Correct the problem and retry the command, otherwise, contact your IBM support center.

BIP8082
Unable to delete WebSphere MQ Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to delete an WebSphere MQ Queue Manager, but the Queue Manager could not be deleted.
Response
This could be because an WebSphere MQ channel or WebSphere MQ Listener is still running. Stop all WebSphere MQ channels and WebSphere MQ Listeners running for this Queue Manager and retry the command.

BIP8083
The broker name that you specified, <insert_1>, contains characters that are not valid.
Severity
20 : Error
Explanation
The broker name must only contain characters that are supported by the platform on which the command is being processed.
Response
Correct the broker name and reissue the command.

BIP8084
Unable to create directory <insert_1>, return code <insert_2>.
Severity
20 : Error
Explanation
The specified directory could not be created. Ensure that the characters are valid, that you have the required permissions and that the parent directory exists.
Response
Correct and reissue the command.

BIP8085
The environment variable <insert_1> is not defined.
Severity
20 : Error
Explanation
An attempt to read an environment variable was unsuccessful.
Response
Ensure the environment variable is defined.

BIP8086
WebSphere MQ queue manager <insert_1> is already being used by broker <insert_2>.
Severity
20 : Error
Explanation
An attempt was made to use a WebSphere MQ queue manager that was already in use by another broker. It is not acceptable for multiple brokers to share a single WebSphere MQ queue manager.
Response
Choose another WebSphere MQ queue manager and reissue the command.

BIP8087
<insert_1> already exists and cannot be created.
Severity
20 : Error
Explanation
An attempt was made to create a component that already exists.
Response
Ensure that the component name you have selected for creation is the correct one, and investigate the reasons why this component name already exists. Additionally, if you are running on a Windows platform and mqsilist does not report the existence of the component the component's service may still be running. This may be because of a previous delete failed to complete and left the component's service running (this can be caused by an open Administrative Tools - Services window, which prevents the deletion being completed.) If the component's service still exists try deleting the component after resolving any relevant issues and retry this create command.

BIP8091
Common stream <insert_1>.
Severity
0 : Information

BIP8092
Unable to locate WebSphere Message Broker response <insert_1> in message catalog <insert_2>.
Severity
20 : Error
Explanation
The WebSphere Message Broker response could not be found in the message catalog.
Response
Make sure that the message catalog is available and that the WebSphere Message Broker response is in the message catalog. If the problem persists contact your IBM support center.

BIP8093
Unable to access the WebSphere MQ Queue Manager.
Severity
20 : Error
Explanation
The WebSphere MQ Queue Manager is currently being created by another user.
Response
Wait until the Queue Manager has been created, then reissue this command.

BIP8094
Unable to access the WebSphere MQ Queue Manager.
Severity
20 : Error
Explanation
The WebSphere MQ Queue Manager is currently being stopped by another user.
Response
Wait until the stop has completed and reissue this command.

BIP8095
WebSphere queue manager <insert_1> is being used by WebSphere Message Broker component <insert_2>.
Severity
20 : Error
Explanation
An attempt was made to delete a queue manager that in use by another WebSphere Message Broker component. The queue manager delete option provided by this command can only be selected if there are no other WebSphere Message Broker components using that queue manager.
Response
If it is no longer required, delete the component before deleting the queue manager.

BIP8096
Successful command initiation, check the system log to ensure that the component started without problem and that it continues to run without problem.
Severity
0 : Information

BIP8097
Unable to instantiate Java object of class <insert_1>.
Severity
20 : Error
Explanation
An instance of the Java class could not be instantiated.
Response
This is an internal error, possibly due to a faulty installation. Check messages in the system log for related errors and retry the operation. If the problem persists, contact your IBM support center.

BIP8098
Trace level: <insert_1>, mode: <insert_2>, size: <insert_3> KB.
Severity
0 : Information

BIP8099
<insert_1>: <insert_2> - <insert_3>3
Severity
0 : Information

BIP8101
Changes the configuration of a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsichangebroker brokerName [[-i generalDefaultUserId] -a generalDefaultPassword] [-t | -n] [-l userLilPath] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-v statisticsMajorInterval] [-P httpListenerPort] [-c ICU converter path] [-y ldapPrincipal] [-z ldapCredentials] [-x userExitPath] [-e activeUserExits] [-s adminSecurity] [-d MQService] [-f function level] [-b cachePolicy] [-r cachePortRange]


Command options:
'brokerName' the name of the broker to change.
'-i generalDefaultUserId' the default user ID that the broker will use to connect to external resources.
'-a generalDefaultPassword' the password to be used with the generalDefaultUserId.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-n' disables WebSphere MQ fastpath for this broker.
'-l userLilPath' indicates where user-written LIL and JAR files are loaded from.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c ICU converter path' delimited ':' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-e activeUserExits' the active user exits. By default, user exits are inactive. Adding a user exit name to this list changes its default state to active for this broker. The default state can be overridden at the execution group or message flow level using the mqsichangeflowuserexits command. If a user exit name is specified and no library is found to provide that user exit when the execution group starts, a BIP8860 message is written to the system log and the execution group fails to start. The separator character for the list is ':'.
'-s adminSecurity' activates broker administration security. Valid values that can be set are 'active' and 'inactive'.
'-d MQService' start the broker as a WebSphere MQ Service when the queue manager starts. Valid values that can be set are 'defined' and 'undefined'. The default is 'undefined'.
'-f function level' the effective function level of the broker, such as '7.0.0.1', '7.0.0.2', or 'all'
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.

BIP8104
Changes a component's trace options.
Severity
10 : Warning
Explanation
Syntax (1):
mqsichangetrace componentName [-u | -t | [-n on | off]] -e egName [[-k application] [-y library] -f messageFlow] [-l level] [-m mode] [-c size] [-r]
Syntax (2):
mqsichangetrace componentName -t -b [-l level] [-m mode] [-c size]


Command options:
'componentName' name of the component whose trace options are to be changed
'-u' indicates user trace (use only with '-e')
'-t' indicates service trace
'-n' indicates trace node settings (use only with '-e')
'-b' denotes tracing of a component other than an execution group
'-e egName' name of the execution group
'-k application' name of the application
'-y library' name of the library
'-f messageFlow' name of the message flow
'-l level' specifies the trace level: 'none', 'normal' or 'debug'
'-m mode' specifies the trace mode: 'safe', 'fast' or 'temp'
'-c size' specifies the trace file size in kilobytes
'-r' specifies that the log should be reset
Certain conditions apply to these optional parameters. Check the online documentation for more information.

BIP8105
Creates a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsicreatebroker. brokerName -q queueManagerName [-i generalDefaultUserId -a generalDefaultPassword] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-w workPath] [-e sharedWorkPath] [-l userLilPath] [-t] [-m] [-v statisticsMajorInterval] [-P httpListenerPort] [-c icuConverterPath] [-y ldapPrincipal -z ldapCredentials] [-x userExitPath] [-o operationMode] [-s adminSecurity] [-d MQService] [-b cachePolicy] [-r cachePortRange]


Command Options:
'brokerName' the name of the broker.
'-q queueManagerName' the WebSphere MQ queue manager that the broker will use. The queue manager is created if it does not exist.
'-i generalDefaultUserId' the default user ID that the broker will use to connect to external resources.
'-a generalDefaultPassword' the password to be used with the generalDefaultUserId.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-w workPath' the directory in which trace logs are written.
'-e sharedWorkPath' the directory in which registry and configuration data is shared between multiple instances of this broker.
'-l userLilPath' the directory from which the broker searches for user-supplied libraries.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-m' indicates that migration is required from an WebSphere publish/subscribe broker.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c icuConverterPath' delimited ':' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-o operationMode' the broker operation mode. Valid values that you can set are 'express', 'standard', 'adapter', and 'advanced'. The default mode is 'advanced' unless you have the Trial Edition, in which case the default mode is 'trial'.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'. The default is 'inactive'.
'-d MQService' start the broker as a WebSphere MQ Service when the queue manager starts. Valid values that you can set are 'defined' and 'undefined'. The default is 'undefined'.
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.

BIP8108
Deletes a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsideletebroker. brokerName [-q] [-w] [-s]


Command Options:
'brokerName' Name of the broker to delete
'-q' deletes the broker's WebSphere MQ queue manager
'-w' deletes the broker's trace files from its work directory.
'-s' delete the broker and any current execution group administration security WebSphere MQ queues.

BIP8111
Formats the trace log retrieved using mqsireadlog.
Severity
10 : Warning
Explanation
Syntax:
mqsiformatlog -i inputFileName [-o outputFileName]


Command Options:
'-i inputFileName' the file name of a trace log that requires formatting
'-o outputFileName' the file name to write the formatted trace log (default=stdout).

BIP8113
Lists the components that have been created and their WebSphere MQ queue managers.
Severity
10 : Warning
Explanation
Syntax:
mqsilist [-a] [brokerName [-e egName]]


Command Options:
'-a' lists all components on this machine.
'brokerName' lists execution groups configured for a broker
'-e egName' lists message flows configured for an execution group.

BIP8114
Retrieves the trace log.
Severity
10 : Warning
Explanation
Syntax (1):
mqsireadlog componentName (-u | -t) -e executionGroupName [-f] [-o outputFileName]
Syntax (2):
mqsireadlog componentName -t -b subcomponent -f [-o outputFileName]
Syntax (3):
mqsireadlog componentName -t -x executionGroupUuid -f [-o outputFileName]


Command Options:
'-u' indicates user trace (may only be used with '-e')
'-t' indicates service trace
'-b subcomponent' name of the command or subcomponent (for example, 'agent')
'-e executionGroupName' Name of the execution group
'-x executionGroupUuid' Universally Unique Identifier (UUID) of the execution group
'-f' specifies that the log file is to be read directly from the file system (this flag is mandatory for service trace)
'-o outputFileName' file name to write the trace log.

BIP8115
Displays trace settings.
Severity
10 : Warning
Explanation
Syntax (1):
mqsireporttrace componentName (-u | -t | -n) -e executionGroupName [[-k application] [-y library] -f messageFlow]
Syntax (2):
mqsireporttrace componentName -t -b

Syntax (3):
mqsireporttrace componentName [-u | -t]


Command options:
'-u' indicates user trace (use only with '-e')
'-t' indicates service trace
'-n' indicates trace node settings (use only with '-e')
'-b' denotes tracing of a component other than an execution group
'-e executionGroupName' execution group name
'-k application' application name
'-y library' library name
'-f messageFlow' message flow name

BIP8116
Starts a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsistart brokerName

Command Options:
'brokerName' name of the broker to start

BIP8117
Stops a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsistop brokerName [-q] [-i]

Command Options:
'brokerName' name of the broker to stop
'-q' additionally stops the WebSphere MQ queue manager used by the broker
'-i' forces the broker to stop immediately (use with caution).

BIP8119
Lists the credentials of resources that are associated with an integration node
Severity
10 : Warning
Explanation
Syntax (1):
mqsireportdbparms <brokerName> -h
Syntax (2):
mqsireportdbparms <brokerName> -n <resource>
Syntax (3): mqsireportdbparms <brokerName> -n <resource> -[-u <userId>] [-p <password>]
Syntax (4) mqsireportdbparms <brokerName> -n <resource> -[-u <userId>]-i <sshIdentity>] [-r <passPhrase>]

Command options, syntax (1):
<brokerName>
The integration node
Outputs a help message.

Command options, syntax (2)
<brokerName >
The integration node name.
-n <resource>
The data source, resource name or resource type of interest.
Lists resources and their credentials that are associated with the integration node which have the specified resource name or type.
If a non-SFTP data source is entered, the UserID is returned.
If an SFTP datasource has been entered, the userId, and if set, the SSHIdentity is returned.
If entering a specific resource, enter the resource name, e.g. dsn&colon.&colon.odbc
If searching for a resource type, enter the first few letters of the resource type, e.g. ftp followed by an asterisk.
See below for a list of available resource options
Command options, syntax (3):
<brokerName>
The name of an integration node.
-n <resource>
The name or type of the resource that is associated with <userId> and <password>.
-u <userId>
The user identifier associated with <resource>.
-p <password>
The password that you are trying to verify is associated with <userId>.
Checks whether the password that you associate with a particular userID and resource is correct.
When verifying a password, the -u and -p flags must be used together.

Command options, syntax (4):
<brokerName>
The name of an integration node.
-n <resource>
The name of an SFTP resource that is associated with <SSHIdentity> and <passphrase>.
-u <userId>
The user identifier that is associated with <resource>.
-i <SSHIdentity>
The fully qualified path to the SSH identity that is associated with <resource>.
-r <passphrase>
The passphrase that is associated with <SSHIdentity>.
Validates an sshIdentity and passphrase that are associated with <resource>
You must use the -u, -i and -r flags together, and the resource must be an SFTP resource.

List of possible resources which can be entered with this command
The resource can be one of the following types. Each type is determined by the syntax of the <resource> parameter:

-n odbc::<Data Source Name>
The ODBC data source name

-n ftp::<security identity>
The FTP server security identity that is specified on File nodes.

-n jms::<JMS connection factory name>
The JMS ConnectionFactory that is used by a JMS node.

-n jndi::<JNDI administered object name>
The JNDI name that is associated with a JMS ConnectionFactory or Destination.

-n jdbc::<security identity>
The JDBC security identity.

-n <data source name>
The Data Source Name (DSN) that is used in Compute or Database nodes.

-n eis::<adapter name>
The adapter name that is used by the WebSphere Adapters nodes.

-n email::<security identity>
User identity for the EmailInput node or EmailServer configurable service.

-n ims::<security identity>
The IMS Connect security identity that is specified on an IMS node.

-n cics::<security_identity>
The CICS security identity that is specified on a CICSRequest node.

-n sftp::<security_identity>
The SFTP security identity that is used on a File node.

-n cd::<security_identity>
The Connect:Direct security identity that is used on the CD nodes. cd&colon.&colon.default is the default security identity used by the nodes.

-n wxs::<security_identity>
The WebSphere eXtreme Scale security identity that is used by the WebSphere eXtreme Scale configurable service.

This command can be run when the integration node is running or is stopped.

BIP8120
Migrates broker database tables.
Severity
10 : Warning
Explanation
Syntax:
migratetables


BIP8121
Lists the contents of a components persistent store.
Severity
10 : Warning
Explanation
Syntax:
mqsibrowse componentName -t persistentStoreTable


Command Options:
'componentName' Name of the component to browse
'-t persistentStoreTable' the persistent store table to browse.

BIP8122
The mqsireportproperties command displays the values of broker properties.
Severity
10 : Warning
Explanation
Syntax 1:
mqsireportproperties BrokerName -o ObjectName ( -b httplistener | -b securitycache | -b servicefederation | -b webadmin | -b cachemanager | -e ExecutionGroupLabel | -c ConfigurableService ) (-n AttributeName | -a | -r) [-p Path/Filename] [-f]
Syntax 2:
mqsireportproperties BrokerName (-o BrokerRegistry | -o SecurityCache) (-n AttributeName | -a | -r) [-p Path/Filename]
Command Options:
'BrokerName' The name of the broker.
'-b httplistener' Report properties for the HTTP Listener component.
'-b securitycache' Report properties for the Security Cache component.
'-b servicefederation' Report properties for the Service Federation Management component.
'-b webadmin' Report properties for the Web Administration component.
'-b cachemanager' Report properties for the Cache Manager component.
'-e ExecutionGroupLabel' The name of the execution group.
'-c ConfigurableService' The type of the configurable service, for example, JMSProviders. Specify a value of "AllTypes" to list all configurable service types.
'-o ObjectName' The name of the object to report on. Specify a value of "AllReportableEntityNames" to list all valid object names.
'-n AttributeName' Display the value of the named attribute.
'-a' Display all attribute values (non-recursive).
'-r' Display all attribute values (recursive).
'-p Path/Filename' The name of a file to write the broker property settings to. If -n is specified, the attribute name is omitted from the output; only the value of the attribute is written to the file.
'-f' Allow the command to run when the execution group is stopped. This option can be used only along with the -e option.
Response
Correct the arguments and rerun the command.

BIP8123
The mqsichangeproperties command changes the values of broker properties.
Severity
10 : Warning
Explanation
Syntax:
mqsichangeproperties BrokerName ( -b httplistener | -b securitycache | -b servicefederation | -b webadmin | -b cachemanager | -e ExecutionGroupLabel | -c ConfigurableService ) -o ObjectName -n PropertyName ( -v PropertyValue | -p Path/Filename ) [-f]

Command options:
BrokerName: The name of the broker to modify.
'-b httplistener': Change properties for the HTTP Listener component.
'-b securitycache': Change properties for the Security Cache component.
'-b servicefederation' Change properties for the Service Federation Management component.
'-b webadmin' Change properties for the Web Administration component.
'-b cachemanager' Change properties for the Cache Manager component.
'-e ExecutionGroupLabel' Change properties for the execution group.
'-c ConfigurableService' Change properties for a configurable service used by the broker, such as JMSProviders.
'-o ObjectName' The name of the object for which you want to change the properties.
'-n PropertyName' The name of the property to be changed.
'-v PropertyValue' The value that is assigned to the property specified by the -n parameter. Specify more than one property name and corresponding value by using commas as separators; for example, -n Name1, Name2 -v Value1, Value2.
'-p Path/Filename' The name of a file to read the broker property settings from.
'-f' Allow the command to run when the execution group stopped. Use this option only for recovering from execution group startup failures and only with the -e option.

BIP8124
Changes and reports a component's details.
Severity
10 : Warning
Explanation
Syntax:
mqsiservice. [-v] [componentName [-r label=value]] [-m messageNumber [-c messageCatalog]] [-t]


Command Options:
'-v' is the product version information.
'componentName' is the name of the component to query for its registry data.
'-r label=value' sets the registry key 'label' to 'value'. Use with caution.
'-r label=' sets the registry key 'label' to null. Use with caution.
'-r label' deletes the registry key 'label'. Use with caution.
'-m messageNumber' is a message number to output.
'-c messageCatalog' is the name of the message catalog to use.
'-t' Output information about current time and time zone.

BIP8125
Exports or Imports a message set from or into a repository.
Severity
10 : Warning
Explanation
Syntax (1):
mqsiimpexpmsgset -e -n mrmDataSourceName -u mrmDataSourceUserId -p mrmDataSourcePassword -s sourceMessageSetName -l sourceMessageSetLevel -f fileName
Syntax (2):
mqsiimpexpmsgset -i -n mrmDataSourceName -u mrmDataSourceUserId -p mrmDataSourcePassword -f fileName


Command Options
'-e' exports a message set.
'-i' imports a message set.
'-n mrmDataSourceName' the component's database name.
'-u mrmDataSourceUserId' the userid that the component uses to access the database.
'-p mrmDataSourcePassword' the password that the component uses to access its database
'-s sourceMessageSetName' the message set being exported or imported
'-l sourceMessageSetLevel' the level of the message set
'-f fileName' the file being imported, or the file being exported.

BIP8126
Creates a new message set as a copy of an existing message set within a repository.
Severity
10 : Warning
Explanation
Syntax:
mqsicopymsgset -n mrmDataSourceName -u mrmDataSourceUserId -p mrmDataSourcePassword -s sourceMessageSetName -l sourceMessageSetLevel -t targetMessageSetName -k targetMessageSetLevel


Command Options
'-n mrmDataSourceName' the component's database name
'-u mrmDataSourceUserId' the userid that the component uses to access the database
'-p mrmDataSourcePassword' the password that the component uses to access its database
'-s sourceMessageSetName' the message set being copied
'-l sourceMessageSetLevel' the level of the message set being copied
'-t targetMessageSetName' the name of the target message set
'-k targetMessageSetLevel' the target message set level.

BIP8127
Checks the contents of a broker's subscriptions table looking for CBR filters that include string literals with escape characters.
Severity
10 : Warning
Explanation
Syntax:
mqsicbrreport brokerName


Command Options
'brokerName' Name of the broker.

BIP8128
Reloads a broker's execution groups.
Severity
0 : Information
Explanation
Syntax:
mqsireload brokerName [-e egName]


Command Options:
'brokerName' Broker name
'-e egName' Execution group name to reload.

BIP8129
Sets the user name and password associated with a Data Source Name (DSN), FTP Server, JNDI administered object, JDBC provider name, SFTP Server, or JMS connection factory name.
Severity
10 : Warning
Explanation
Syntax (1):
mqsisetdbparms <brokerName> -n <resource> [-u <userId>] [-p <password>] [-f]
Syntax (2):
mqsisetdbparms <brokerName> -n <resource> -d [-f]
Syntax (3):
mqsisetdbparms <brokerName> -n <resource> [-u <userId>] [-i <ssh_identiy>] [-r <passphrase>] [-f]


Command options, syntax (1):
<brokerName>
The broker name.
-n <resource>
The type and name of the resource with which the <userId> and <password> are associated.
-u <userId>
The user identifier associated with <resource>.
If the resource already exists and a user ID is associated with the resource, you do not need to set this parameter.
If the resource does not already exist, you must set this parameter.
-p <password>
The password associated with <resource>.
You must set the <userId> and <password>.

Command options, syntax (2)
<brokerName>
The broker name.
-n <resource>
The type and name of the resource with which the <userId> and <password> are associated.
-d
Deletes the <resource>, <userId>, and <password> information.

Command options, syntax (3):
<brokerName>
The broker name.
-n <resource>
The type and name of the resource with which the <userId> and <ssh_identity> are associated.
-u <userId>
The user identifier associated with <resource>.
If the resource already exists and a user ID is associated with the resource, you do not need to set this parameter.
If the resource does not already exist, you must set this parameter.
-i <ssh_identity>
The fully qualified path to the ssh identity associated with <resource>.
You must set the <userId> and <ssh_identity>.
-r <passphrase>
The passphrase associated with <ssh_identity>.
The passphrase is optional.

The resource can be one of the following types. Each type is determined by the syntax of the <resource> parameter:

-n odbc::<Data Source Name>[::<Execution Group name>]
The ODBC Data Source Name, with optional execution group name

-n ftp::<security identity>
The FTP server security identity specified on File nodes.

-n jms::<JMS connection factory name>
The JMS ConnectionFactory used by a JMS node.

-n jndi::<JNDI administered object name>
The JNDI name associated with a JMS ConnectionFactory or Destination.

-n jdbc::<security identity>
The JDBC security identity.

-n <data source name>
The Data Source Name (DNS) used in Compute or Database nodes.

-n eis::<adapter name>
The adapter name used by the WebSphere Adapters nodes.

-n email::<security identity>
User identity for the EmailInput node or EmailServer configurable service.

-n ims::<security identity>
The IMS Connect security identity specified on an IMS node.

-n cics::<security_identity>
The CICS security identity specified on a CICSRequest node.

-n sftp::<security_identity>
The SFTP security identity used on a File node.

-n cd::<security_identity>
The Connect:Direct security identity used on the CD nodes. cd&colon.&colon.default is the default security identity used by the nodes.

-n wxs::<security_identity>
The WebSphere eXtreme Scale security identity used by the WebSphere eXtreme Scale configurable service.

By default, this command processes with the broker running, but the operational changes do not take effect until the Execution Group, or Groups, using the <resource> are restarted.
Use the -f option to force a check that the broker <brokerName> is stopped before this command is allowed to run, thereby ensuring that the changes take effect for all Execution Groups as soon as the broker is next started. However, using this option means that the broker has to be stopped before this command can be run.

BIP8130
Execution Group: <insert_1> - <insert_2>2
Severity
0 : Information

BIP8131
MessageFlow: <insert_1>1
Severity
0 : Information

BIP8132
<insert_1> is not a valid subcomponent name.
Severity
20 : Error
Explanation
The name selected is not a valid subcomponent.
Response
The name selected is not supported. Select a different subcomponent name.

BIP8133
Unable to write to the selected output file <insert_1>
Severity
20 : Error
Explanation
The file selected could not be written to.
Response
Ensure that the file selected is not in a protected directory, that it is not read-only and that it is not being used or locked by another user. Also check that the directory into which the file will be written has adequate free space.

BIP8134
Unable to alter WebSphere MQ Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to alter a WebSphere MQ Queue Manager, the Queue Manager could not be altered.
Response
Locate and resolve the problem and retry the command.

BIP8135
Unable to create files: operating system return code <insert_1>.
Severity
20 : Error
Explanation
An error occurred creating files in response to a command. This may be because the user does not have the required authorization.
Response
Check that the user has the required authority to create files and retry.

BIP8136
Unable to change the ownership of files: operating system return code <insert_1>.
Severity
20 : Error
Explanation
An error occurred changing the ownership of files in response to a command. This may be because the user does not have the required authorization.
Response
Check that the user has the required authority to create files and retry.

BIP8137
Unable to change the access permission mode of file <insert_1> : operating system return code <insert_2>.
Severity
20 : Error
Explanation
An error occurred while changing the access permissions for the specified file. This may be because the user does not have the required authorization to carry out this action.
Response
Check that the user has the required authority to create and modify files. Retry the operation.

BIP8138
Userid <insert_1> cannot be used by this component.
Severity
20 : Error
Explanation
The userId selected cannot be used by the component. This may be because the userId does not have the required authorization or that the userId is invalid for operations that the component requires, for example, if a component is to use fastbind (-t) on UNIX platforms it must use the ServiceUserId 'mqm'.
Response
Check that the user has the required authority to create files and retry.

BIP8139
The user issuing this command does not have the required permissions to execute the command.
Severity
20 : Error
Explanation
The userId that the command is being run under must have the required authority execute the command.
Response
Check that the user has the required authority to execute the command.

BIP8140
Unable to find service userid <insert_1> in component <insert_2>.
Severity
20 : Error
Explanation
Cannot authenticate service userid in component.
Response
Use mqsichangebroker to alter the service userid and then retry the command.

BIP8141
Unauthorized userid <insert_1> in component <insert_2>.
Severity
20 : Error
Explanation
The service userid is not authorized to run the component.
Response
Use mqsichangebroker to alter the service userid and retry the command.

BIP8142
Unable to set process userid.
Severity
20 : Error
Explanation
UNIX setuid command had failed.
Response
Verify with your system administrator that file permissions for this command are set correctly.

BIP8143
Unable to change group ownership of directory <insert_2> to <insert_3>. (error <insert_1>)
Severity
20 : Error
Explanation
Directory <insert_2> is required to have <insert_3> as group owner.
Response
Use a different -w value or consult system administrator for possible causes of this error.

BIP8144
Unable to create directory <insert_1>. (error <insert_2>)
Severity
20 : Error
Explanation
Directory <insert_1> creation has failed due to directory permission setting.
Response
Use a different -w value or consult system administrator for possible causes of this error.

BIP8145
Execution Group process IDs <insert_1> were forced to terminate.
Severity
0 : Information
Explanation
The Broker was shutdown forcibly, this caused Execution Group processes to be killed.
Response
This action may leave system, database, WebSphere MQ or Application resources in a locked state. Some resource locks may need freeing manually, others will not need any action to be taken.

BIP8146
Unable to retrieve the SQL primitives supported by the Database.
Severity
20 : Error
Explanation
The command attempted to retrieve the SQL primitives that the Database supports, however the primitives retrieved indicate that the Database could not be contacted successfully. Refer to the Administration Guide for information about Database setup, ensure that the Database libraries are available in the library path and that the ODBC ini file is correct.
Response
Correct the problem and retry the command.

BIP8147
Changes the configuration of a broker. Syntax: changebroker [l=userLilPath] [g=configurationChangeTimeout] [k=internalConfigurationTimeout] [x=userExitPath] [e=activeUserExits] [s=adminSecurity] [d=MQService] [f=functionLevel]
Severity
10 : Warning
Explanation
Command options:
'l=userLilPath' the directory from which the broker searches for user-supplied libraries.
'g=configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'k=internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'x=userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'e=activeUserExits' the active user exits. By default, user exits are inactive. Adding a userExit name to this list changes its default state to active for this broker. The default state can be overridden at the execution group or message flow level using the mqsichangeflowuserexits command. If a user exit name is specified, and no library is found to provide that user exit when the execution group starts, a BIP8860 message is written to the system log and the execution group fails to start. The separator character for the list is ':'.
's=adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'.
'd=MQService' start the broker as a WebSphere MQ Service when the queue manager starts. Valid values that you can set are 'defined' and 'undefined'. The default is 'undefined'.
'f=functionLevel' the effective function level of the broker, such as '7.0.0.1', '7.0.0.2', or 'all'

BIP8149
This command changes a component's trace options. Syntax (1): changetrace (u=yes | t=yes | (n=on | n=off)) ,e=executionGroupName [[,k=application] [,y=library] ,f=messageFlow] [,l=level] [,m=mode] [,c=size] [,r=yes] Syntax (2): changetrace t=yes ,b=yes [,l=level] [,m=mode] [,c=size]
Severity
10 : Warning
Explanation
Command options:
'u=yes' indicates that user trace options are to be modified (use only with the e parameter)
't=yes' indicates that service trace options are to be modified
'n=on' indicates that trace node is active (use only with the e parameter)
'n=off' indicates that trace node is inactive (use only with the e parameter)
'b=yes' indicates that service trace options for the agent subcomponent of the specified component are to be modified
'e=executionGroupName' specifies the execution group name
'k=application' specifies the application name
'y=library' specifies the library name
'f=messageFlow' specifies the message flow name
'l=level' specifies the trace level: 'none', 'normal' or 'debug'
'm=mode' specifies the trace mode: 'safe', 'fast' or 'temp'
'c=size' specifies the trace size in kilobytes
'r=yes' specifies that the log is reset
Certain conditions apply to these optional parameters. Check the online documentation for more information.

BIP8150
Displays trace settings. Syntax (1): reporttrace (u=yes | t=yes | n=yes) ,e=executionGroupName [[,k=application] [,y=library] ,f=messageFlow] Syntax (2): reporttrace t=yes ,b=yes
Severity
10 : Warning
Explanation
Command options:
'u=yes' indicates user trace (use only with flag 'e')
't=yes' indicates service trace
'n=yes' indicates trace node settings (use only with flag 'e')
'b=yes' denotes components other than execution groups
'e=executionGroupName' execution group name
'k=application' specifies the application name
'y=library' specifies the library name
'f=messageFlow' message flow name.

BIP8151
Lists the properties of a broker. Syntax: list [e=egName [k=applicationName] [y=libraryName]] [r=recursive] [d=detailLevel]
Severity
10 : Warning
Explanation
Command Options
'e=egName' list deployed objects configured for an execution group.
'k=applicationName' list deployed objects configured for an application.
'y=libraryName' list deployed objects configured for a library.
'r=recursive' display information on subcomponents.
'd=detailLevel' control how much information to display. Valid values are: 0 = display minimal information 1 = display one-line summary per object (default) 2 = display detailed information

BIP8152
Stops a component. Syntax: stopcomponent [i=yes]
Severity
10 : Warning
Explanation
Command Options:
'i=yes' Stop the component immediately

BIP8153
Migrated database tables for broker <insert_1>1
Severity
0 : Information

BIP8154
An error occurred while locking the registry file <insert_1> : <insert_2>.
Severity
20 : Error
Explanation
The program cannot continue, because of an internal error.
Response
Contact your WebSphere Message Broker administrator.

BIP8155
Migrates database tables for a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsimigratetables brokerName [-i serviceUserId] [-a servicePassword]


Command options
'brokerName' name of the broker whose tables are to be migrated
'-i' the userid that the broker service should run under
'-a' the password for the broker service userid.

BIP8156
Broker database being migrated is in an inconsistent state
Severity
20 : Error
Explanation
The Broker database being migrated is in an inconsistent state. ClientId's referenced in tables can not be found in the BCLIENTUSER table.
Response
Restore your Broker database tables to a known good state, then try migrating the tables again.

BIP8157
Unable to create WebSphere MQ channel <insert_1> on queue manager <insert_2>.
Severity
20 : Error
Explanation
This command attempted to create a WebSphere MQ channel, but was unable to do so.
Response
Locate and resolve the problem, and retry the command.

BIP8158
Invalid format for command.
Severity
20 : Error
Explanation
The string <insert_1> contained no valid formatted command.
Response
Consult the user manual and correct your errors.

BIP8159
Unknown parameter <insert_1>.
Severity
20 : Error
Explanation
The parameter <insert_1> is not valid for this command.
Response
Check the spelling of the parameter and check if it is valid for this command.

BIP8160
The verb <insert_1> is unknown.
Severity
20 : Error
Explanation
The verb <insert_1> is not a valid verb.
Response
Consult the user manual and correct your errors.

BIP8161
Start was issued.
Severity
0 : Information
Explanation
Start was issued and recognized.
Response
Everything was OK.

BIP8162
MVS stop was issued.
Severity
0 : Information
Explanation
MVS stop was issued and recognized.
Response
Everything was OK.

BIP8163
Missing closing single quote. Opened at <insert_1>.
Severity
20 : Error
Explanation
You opened a quoted text at <insert_1>, but never closed it.
Response
Check where you intended to end the quoted text and issue the corrected command.

BIP8164
A problem was encountered while attempting to create/delete/list security ACL information.
Severity
20 : Error
Explanation
The operation was not completed successfully.
Response
Check messages in the system log for related errors and retry the operation. If the problem still occurs, contact your IBM support center.

BIP8165
An internal error has occurred while accessing the message repository.
Severity
20 : Error
Explanation
This is an internal error. There may be insufficient memory to complete the operation.
Response
Increase the amount of virtual memory available on your system and retry the command. If the problem persists turn on mqsiimpexpmsgset utility tracing to capture details of the error, retry the operation and contact your IBM support center.

BIP8166
The message set to be imported has been finalized in this repository since the export file was created.
Severity
20 : Error
Explanation
A record of this message set, indicating that it was finalized, exists in this repository because another message set was based on it before it was deleted.
Response
Delete all message sets based on this message set or import a finalized version of the message set.

BIP8167
Unknown message repository database name <insert_1>.
Severity
20 : Error
Explanation
The message repository database name <insert_1> could not be located.
Response
This error is most probably a result of either, an incorrect name that was provided for the MRMDataSourceName on the mqsiimpexpmsgset command, or the ODBC data source name <insert_1> was not set up correctly, or has been deleted. Check that the message repository database name has been correctly set up as an ODBC system data source that has been configured for the correct database.

BIP8168
The userid and/or password are not authorized for connection to the message repository database <insert_1>.
Severity
20 : Error
Explanation
The message repository database name <insert_1> could not be opened because the userid and/or password is not authorized.
Response
This error is most probably a result of either, incorrect userid and password that were provided for the MRMDataSourceUserId and MRMDataSourcePassword on the mqsiimpexpmsgset command, or the userid has not been assigned access rights to the message repository database by the database management system. Check that the message repository database access rights have been correctly configured.

BIP8169
An internal error has occurred while accessing the message repository.
Severity
10 : Warning
Explanation
A SAX parser exception occurred. The text of the exception is <insert_1>.
Response
If the error persists contact your IBM support center.

BIP8170
Failed to import as all plug-ins registered for the message set have not been installed.
Severity
20 : Error
Explanation
The import file refers to plug-ins which have not been installed.
Response
Install all plug-ins registered for the message set and retry the command.

BIP8171
An internal error has occurred while accessing the message repository.
Severity
10 : Warning
Explanation
A DOM parser exception occurred. The text of the exception is <insert_1>.
Response
If the error persists contact your IBM support center.

BIP8172
An unexpected exception has occurred while accessing the message repository.
Severity
10 : Warning
Explanation
The text of the exception is <insert_1>.
Response
If the error persists contact your IBM support center.

BIP8173
An internal error has occurred while accessing the message repository.
Severity
20 : Error
Explanation
The error was due to invalid content of an XML document.
Response
If the error persists contact your IBM support center.

BIP8174
An internal error has occurred while accessing the message repository.
Severity
20 : Error
Explanation
The error was due to invalid content of an XML document.
Response
If the error persists contact your IBM support center.

BIP8175
Duplicate message set identifier.
Severity
20 : Error
Explanation
The message set to be imported already exists in this repository.
Response
Delete the message set and retry the command.

BIP8176
Failed to access export file <insert_1>.
Severity
20 : Error
Explanation
The error code <insert_2> was detected.
Response
Check that you have access rights to the export file.

BIP8177
Failed to open import file <insert_1>.
Severity
20 : Error
Explanation
There was a failure opening the import file <insert_1>.
Response
Check the filename and path entered and that you have access rights to the file.

BIP8178
The database transaction log size has been exceeded.
Severity
20 : Error
Explanation
You have exceeded the transaction log size of the database.
Response
Increase the size of the database transaction log size on your system and retry the command.

BIP8179
Internal error while accessing message repository.
Severity
10 : Warning
Explanation
An internal inconsistency has been detected while accessing the message repository. The MRM return code <insert_1> was detected.
Response
This is an internal error. Turn on mqsiimpexpmsgset utility tracing to capture details of the error, retry the operation and contact your IBM support center.

BIP8180
The Resource name <insert_1> has userID <insert_2>
Severity
0 : Information

BIP8181
An error has occurred while connecting to the message repository.
Severity
20 : Error
Explanation
This error is most probably a result of an incorrect userid that was provided for the MRMDataSourceUserId on the mqsiimpexpmsgset command, or the userid has not been assigned access rights to the message repository database by the database management system.
Response
Check that the message repository database access rights have been correctly configured. Alternatively, if the userid is correct, then this is an internal error. The SQL code (<insert_2>) and SQL state (<insert_3>) were returned. Check your database manager documentation for further information on this error.

BIP8182
Database manager not started.
Severity
20 : Error
Explanation
The message repository database name, <insert_1>, could not be accessed. The database manager has either not been started, or has been stopped.
Response
Start the database manager and retry the command.

BIP8183
A referenced resource does not exist in the message repository.
Severity
20 : Error
Explanation
A resource was referenced, but it does not exist in the message repository.
Response
This is an internal error. Turn on mqsiimpexpmsgset utility tracing to capture details of the error, retry the operation and contact your IBM support center.

BIP8184
Message set is not complete.
Severity
20 : Error
Explanation
A message set must be complete before performing an export. A message set is incomplete if it contains any incomplete messages. A message is incomplete if its type is incomplete. An empty type is incomplete if the type composition is not empty except for type composition message where the type content is not closed. A type is also incomplete if it has incomplete plug-in layer information or if it has an incomplete child. Similarly, a child is incomplete if its type is incomplete.
Response
Complete the message set and retry the command.

BIP8185
Duplicate message set name.
Severity
20 : Error
Explanation
A message set named <insert_1> already exists in this repository.
Response
Delete the message set and retry the command.

BIP8186
The message set <insert_1> with level <insert_2> does not exist in the message repository.
Severity
20 : Error
Explanation
The message set <insert_1> with level <insert_2> is referenced, but it does not exist in the message repository.
Response
Correct the problem and retry the command.

BIP8187
Statistics <insert_1> collection for flow <insert_2> in execution group <insert_3> is <insert_4>. Settings: ThreadDataLevel: <insert_5>, NodeDataLevel: <insert_6>, OutputFormat: <insert_7>, AccountingOrigin: <insert_8>.
Severity
0 : Information

BIP8188
Invalid message set level.
Severity
20 : Error
Explanation
The level <insert_1> for message set <insert_2> is invalid.
Response
Correct the message set level and retry the command.

BIP8189
Changes a broker's statistics options.
Severity
10 : Warning
Explanation
Syntax:
mqsichangeflowstats brokerName (-a | -s) (-e executionGroupName | -g) ([-k application] [-y library] -f messageFlow | -j) [-c control] [-t threadData] [-n nodeData] [-r] [-o outputFormat] [-b accountingOrigin]

Command Options:
'brokerName' name of the broker.
'-a' indicates archival of statistics.
'-s' indicates snapshot publishing.
'-e executionGroupName' execution group name.
'-g' indicates all execution groups.
'-k application' application name
'-y library' library name
'-f messageFlow' message flow name.
'-j' indicates all message flows.
'-c control' starts or stops collection: values allowed are 'active' or 'inactive'.
'-t threadData' specifies the thread statistics level: values allowed are 'none' or 'basic'.
'-n nodeData' specifies the node statistics level: values allowed are 'none', 'basic' or 'advanced'.
'-r' resets the archival, that is, deletes all previous records currently held.
'-o outputFormat' specifies the output format: values allowed are 'usertrace', 'xml' or (on z/OS only) 'smf'. The default is 'usertrace'.
'-b accountingOrigin' indicates using accounting origin to segregate the statistics.

BIP8190
Displays statistics settings.
Severity
10 : Warning
Explanation
Syntax:
mqsireportflowstats BrokerName ( -a | -s | -a -s ) ( -e executionGroupName | -g ) ([-k application] [-y library] -f messageFlow | -j )

Command Options
'brokerName' name of the broker
'-a' indicates archival of statistics
'-s' indicates snapshot publishing
'-e executionGroupName' execution group name
'-g' indicates all execution groups
'-k application' application name
'-y library' library name
'-f messageFlow' message flow name
'-j' indicates all message flows.

BIP8191
Changes a component's statistics options. Syntax: changeflowstats ( a=yes [,r=yes] | s=yes ) ( ,e=ExecutionGroupLabel | ,g=yes ) ([,k=Application] [,y=Library] ,f=MessageFlow | ,j=yes ) [ ,l=Level ] [ ,t=ThreadData ] [ ,n=NodeData ] [,o=OutputFormat] [,b=AccountingOrigin]
Severity
10 : Warning
Explanation
Command Options
'a' indicates Archival of statistics.
'r' resets the Archival, that is, deletes all previous records currently held.
's' indicates Snapshot publishing.
'e' Execution Group name.
'g' indicates all Execution Groups.
'k' Application name.
'y' Library name.
'f' Message Flow name.
'j' indicates all Message Flows.
'c' starts or stops collection: values allowed are 'active' or 'inactive'.
't' specifies the thread statistics level: ThreadData values allowed are 'none' or 'basic'.
'n' specifies the node statistics level: NodeData values allowed are 'none', 'basic' or 'advanced'.
'o' specifies the output format: values allowed are 'usertrace', 'xml' or 'smf'.
'b' indicates using Accounting Origin to segregate the statistics.

BIP8192
Displays statistics settings. Syntax: reportflowstats ( a=yes, | s=yes, | a=yes,s=yes, ) ( ,e=ExecutionGroupLabel | ,g=yes ) ([,k=Application] [,y=Library] ,f=MessageFlow | ,j=yes )
Severity
10 : Warning
Explanation
Command Options
'a' indicates Archival of statistics.
's' indicates Snapshot publishing.
'e' Execution Group name.
'g' indicates all Execution Groups.
'k' Application name.
'y' Library name.
'f' Message Flow name.
'j' indicates all Message Flows.

BIP8193
Creates a security ACL group entry.
Severity
10 : Warning
Explanation
Syntax:
mqsicreateaclgroup (-f fileName | ( (-g groupName | -u userName) -x accessLevel (-b broker | -e executionGroup | -s | -t | -r) ) )


Command Options:
'-f fileName' Imported ACL list file name.
'-g groupName' Windows group name for the desired action.
'-u userName' Windows user name for the desired action.
'-x accessLevel' Desired security access level for specified object (F, E, D, V).
'-b broker' The operation references the specified broker.
'-e executionGroup' The operation references the specified execution group.
'-s' The operation references the subscriptions.
'-t' The operation references the topology.
'-r' The operation references the root topic.

BIP8194
Deletes a security ACL group entry.
Severity
10 : Warning
Explanation
Syntax:
mqsideleteaclgroup (-f fileName | (-g groupName | -u userName) (-b broker | -e executionGroup | -s | -t | -r) )


Command Options:
'-f fileName' Imported ACL list file name
'-g groupName' Group name for the desired action
'-u userName' User name for the desired action
'-b broker' The operation references the specified broker
'-e executionGroup' The operation references the specified execution group
'-s' The operation references the subscriptions
'-t' The operation references the topology
'-r' The operation references the root topic

BIP8195
Lists the current security ACL group(s).
Severity
10 : Warning
Explanation
Syntax:
mqsilistaclgroup [-g groupName | -u userName | -b broker | -e executionGroup | -s | -t | -r]


Command Options:
'-g groupName' ACLs referencing the specified group
'-u userName' ACLs referencing the specified user
'-b broker' ACLs referencing the specified broker
'-e executionGroup' ACLs referencing the specified execution group
'-s' ACLs referencing the subscriptions table
'-t' ACLs referencing the publish/subscribe topology
'-r' ACLs referencing the root topic.

BIP8196
Statistics <insert_1> settings for flow <insert_2> in execution group <insert_3> - On?: <insert_4>, ThreadDataLevel: <insert_5>, NodeDataLevel: <insert_6>, OutputFormat: <insert_7>.
Severity
0 : Information

BIP8197
Unable to set the security attributes for WebSphere MQ Queue <insert_2> on Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to set the Group or Principal security attributes for a WebSphere MQ Queue for the related Queue Manager.
Response
Ensure that the required Group or Principal, <insert_3> is available and that the user issuing this command is a member of the mqm group.

BIP8198
An attempt to start the Queue Manager for WebSphere MQ Queue Manager <insert_1> was unsuccessful and returned WebSphere MQ code <insert_2>.
Severity
20 : Error
Explanation
This command attempts to start the required WebSphere MQ Queue Manager.
Response
Ensure that the required Queue Manager, <insert_1> is available and that the user issuing this command is a member of the mqm group.

BIP8199
Unable to set the security attributes for WebSphere MQ Queue Manager <insert_1>.
Severity
20 : Error
Explanation
This command attempts to set the Group or Principal security attributes for a WebSphere MQ Queue Manager.
Response
Ensure that the required Group or Principal, <insert_2> is available and that the user issuing this command is a member of the mqm group.

BIP8200
Resource <insert_1> does not exist.
Severity
20 : Error
Explanation
An attempt was made to delete a resource called <insert_1> that does not exist.
Response
Update the command with the correct name for the resource to be deleted, and reissue the command. If the resource name is correct, the resource has already been deleted and no other action is required.

BIP8201
The password you entered, <insert_1> for resource <insert_2> and userId <insert_3> is correct
Severity
0 : Information

BIP8202
The Resource name <insert_1> has SSHIdentity <insert_2>
Severity
0 : Information

BIP8203
The passPhrase you entered, <insert_1> for resource <insert_2> with userId <insert_3> and SSHIdentity <insert_4> is correct
Severity
0 : Information

BIP8204
The password you entered, <insert_1> for resource <insert_2> and userId <insert_3> is incorrect
Severity
0 : Information

BIP8205
The passPhrase you entered, <insert_1> for resource <insert_2> with userId <insert_3> and SSHIdentity <insert_4> is incorrect
Severity
0 : Information

BIP8206
The Message Broker is not running and may not have been restarted since the last change made by the mqsisetdbparms command.
Severity
0 : Information

BIP8207
The Message Broker has not been restarted since the last change made to this datasource by the mqsisetdbparms command.
Severity
0 : Information

BIP8211
User Name Server failed to retrieve <insert_2> <insert_1> entries from the native security subsystem.
Severity
0 : Information
Explanation
The User Name Server failed to read a number (<insert_2>) of user or group (<insert_1>) entries, and will continue processing using an incomplete cache of user/group information.
Response
Check trace entries for an indication of which <insert_1> entries could not be read.

BIP8212
User Name Server failed to retrieve more than <insert_2> <insert_1> entries from the native security subsystem.
Severity
10 : Warning
Explanation
The User Name Server failed to read more than a given number (<insert_2>) of user or group (<insert_1>) entries, and will not attempt to read any further <insert_1> entries. Processing will continue using an incomplete cache of user/group information.
Response
Check trace entries for an indication of which <insert_1> entries could not be read.

BIP8213
User Name Server failed to retrieve any <insert_1> entries from the native security subsystem.
Severity
20 : Error
Explanation
The User Name Server did not read any user or group (<insert_1>) entries, and will not continue processing.
Response
Check trace entries for an indication of why no <insert_1> entries were found.

BIP8215
The ACL command resulted in no change.
Severity
10 : Warning
Explanation
The ACL command resulted in no change.
Response
The most likely cause of this return code is attempting to delete an Access Control Entry which does not exist or create one which already exists.

BIP8216
Trace file <insert_1> is not readable by this version of the product. The file was written by version <insert_2>, while this product is version <insert_3>.
Severity
20 : Error
Explanation
The trace file contains data that cannot be understood by this product, and the trace reader command was not able to process the file.
Response
Ensure that the correct version of the product is used to read the trace files.

BIP8217
Trace file <insert_1> is corrupt, and has not been fully read.
Severity
30 : Severe error
Explanation
The trace file contains data other than complete trace records for the current product version, and the trace reader command was not able to process the file.
Response
Ensure that the correct product version is used to read trace files. If the correct version is being used and this error still occurs, ensure that enough disk space is available to store trace data, and that none of the files are limited by other means (e.g., ulimit on UNIX platforms).

BIP8218
Unable to clear messages for WebSphere MQ queue <insert_1> from queue manager <insert_2>.
Severity
20 : Error
Explanation
This command attempts to clear a WebSphere MQ queue but was unable to do so.
Response
Locate and resolve the problem and retry the command. This could be because a broker or a component from a previous version of the product is still running. Stop all processes associated with the queue manager, and retry the command.

BIP8219
Service binary path for component <insert_1> changed to <insert_2>; previous value was <insert_3>.
Severity
10 : Warning
Explanation
The service location for this component was incorrect for this installation. The location has been updated to the correct value.
Response
None.

BIP8220
Service binary path for component <insert_1> could not be changed to <insert_2>: error <insert_4>. Current value remains <insert_3>.
Severity
20 : Error
Explanation
The service location for this component is incorrect for this installation. The command attempted to change this location, but was unsuccessful.
Response
Determine why the change was unsuccessful, correct the problem, and re-run the command.

BIP8221
<insert_1>: <insert_2> (Version <insert_4>) - <insert_3>3
Severity
0 : Information

BIP8222
Unable to find ODBCINI file <insert_1>.
Severity
20 : Error
Explanation
Could not find the ODBCINI file <insert_1>, which is specified by the ODBCINI environment variable.
Response
Ensure that the ODBCINI environment variable points to an existing ODBCINI file.

BIP8223
User <insert_2> is not a member of group <insert_1>.
Severity
20 : Error
Explanation
User <insert_2> is not a member of group <insert_1> and therefore does not have the privilege to use this command.
Response
Talk to your system administrator to obtain the membership of group <insert_1> or login as a user who does have the membership.

BIP8224
Internal error while trying to load library <insert_1>.
Severity
20 : Error
Explanation
Could not load an internal library <insert_1>.
Response
Ensure that the library is correctly installed.

BIP8225
<insert_1> is not a known component.
Severity
20 : Error
Explanation
The name provided is not a known component.
Response
Provide a different component name.

BIP8226
Executing system command <insert_1>.
Severity
0 : Information

BIP8227
Force data in the broker's security cache to be reloaded.
mqsireloadsecurity brokerSpec [-u useridList] [-w timeoutSecs]
Severity
0 : Information
Explanation
Command Options:
'brokerSpec' is one of:
(a) 'brokerName' : Name of a locally defined broker
(b) '-n brokerFileName' : File containing remote broker connection parameters (*.broker)
(c) '-i ipAddress -p port -q qMgr' : hostname, port and queue manager of a remote broker
'-u useridList' A colon-separated list of user IDs that are to have their security cache entries reloaded. If no list is supplied, all entries in the cache are reloaded.
'-w timeoutSecs' maximum number of seconds to wait for message flows to start (default is 60)
Response
No action.

BIP8228
Force data in the broker's security cache to be reloaded. Syntax: reloadsecurity [u=userid list] [w=timeoutValue]
Severity
0 : Information
Explanation
Command Options:
'u=userid list' A colon-separated list of user IDs that are to have their security cache entries reloaded. If no list is supplied, all entries in the cache are reloaded.
'w=timeoutValue' Value in seconds to wait for the broker to reply to the deploy request.
Response
No action.

BIP8229
The command completed with the following number of warnings: <insert_1>.
Severity
0 : Information

BIP8230
mqsisetdbparms cannot be used to set a user name and password for the broker data source.
Severity
10 : Warning
Explanation
An attempt was made to set a user name and password for the broker ODBC data source name. This is not allowed. You may set user names and passwords only for ODBC data sources other than the broker data source.

BIP8231
Argument <insert_2> is not a valid integer value for flag <insert_1>.
Severity
20 : Error
Explanation
Ensure that the argument used is a valid integer, and in the permitted range (from <insert_3> to <insert_4>) or the special value <insert_5>.
Response
Correct the value and reissue the command.

BIP8232
The operation cannot be performed for multi-instance Broker <insert_1>, or an instance of that broker, because of directory permission settings for the shared workpath <insert_2>.
Severity
20 : Error
Explanation
The broker instance needs to reference the shared workpath, but the directory permissions do not allow this action.
Response
Use a different -e value, or consult your system administrator for possible causes of this error.

BIP8233
Multi-instance Broker <insert_1>, or an instance of that broker, cannot be created because the shared workpath <insert_2> does not exist.
Severity
20 : Error
Explanation
The broker instance needs to reference the shared workpath that cannot be accessed, or cannot be located.
Response
Check that the server hosting the shared workpath is accessible.
If the shared workpath does not exist, use the mqsicreatebroker command to create the broker and the shared workpath.

BIP8234
Unable to add broker instance <insert_1>, because the broker has not yet been created using the mqsicreatebroker command.
Severity
20 : Error
Explanation
A broker instance cannot be added if the broker has not yet been created.
Response
Create the broker using the mqsicreatebroker command, then rerun the mqsiaddbrokerinstance command.

BIP8235
The multi-instance Broker <insert_1> cannot be deleted because its associated queue manager <insert_2> is in standby mode.
The multi-instance queue manager is running elsewhere, and there might also be an active broker instance.
Severity
0 : Information
Explanation
The multi-instance broker needs to connect to the active multi-instance queue manager, in order to delete any WebSphere MQ resources owned by the broker.
An active broker instance might also be running elsewhere and this broker instance must also be stopped before the multi-instance broker can be successully deleted.
Response
Stop the active multi-instance queue manager that is running elsewhere before reissuing this command.
You should delete all broker instances, by using the mqsiremovebrokerinstance command, before deleting the multi-instance broker.

BIP8236
A standby instance of Broker <insert_1> has been started against the standby queue manager <insert_2>. The active broker instance and active queue manager instance are running elsewhere.
Severity
0 : Information
Explanation
The multi-instance broker has started in standby mode. The broker will not become active until the current active broker instance and active queue manager instance end, or are stopped.
Response
No action required.

BIP8237
The multi-instance broker <insert_1> detected that another broker instance is active, when it attempted to obtain access to the <insert_2> broker table. The DataFlowEngine process stops and restarts to maintain integrity of the broker data.
Severity
20 : Error
Explanation
Only one instance of a multi-instance broker can be active at any time. This broker instance has detected a problem, because another instance appears to be active at the same time.
This error might have been caused by a network problem connecting to the server where the shared data for the broker is stored.
Response
The broker instance should stop and restart automatically and the problem be resolved without the need for manual intervention.
If the problem persists, investigate the network shared server and all connections to it.
Ensure that all the mount points are still valid from client servers that host the broker instances.
Investigate any problems with the WebSphere MQ multi-instance queue managers associated with this broker.

BIP8238
The multi-instance broker <insert_1> has detected that another broker instance is active. This broker instance stops and restarts to maintain integrity of the broker data.
Severity
20 : Error
Explanation
Only one instance of a multi-instance broker can be active at any time. This broker instance has detected a problem because another instance appears to be active at the same time.
This error might have been caused by a network problem connecting to the server where the shared data for the broker is stored.
Response
The broker instance should stop and restart automatically and the problem be resolved without the need for manual intervention.
If the problem persists, investigate the network shared server and all connections to it.
Ensure that all the mount points are still valid from client servers that host the broker instances.
Investigate any problems with the WebSphere MQ multi-instance queue managers associated with this broker.

BIP8239
The broker has detected that the WebSphere MQ multi-instance Queue Manager <insert_1> is in Standby mode. The multi-instance Queue Manager must be active when the -e flag is used.
Severity
20 : Error
Explanation
The multi-instance broker cannot be created because the WebSphere MQ multi-instance queue manager is not active.
Response
Stop the active WebSphere MQ multi-instance queue manager where it is currently running, to allow the local instance of the queue manager to become active, and rerun this command.

BIP8240
Broker <insert_1> was configured as multi-instance, but cannot be deleted because it does not exist in the shared workpath <insert_2>.
Severity
20 : Error
Explanation
The command has attempted to delete a multi-instance broker from the shared workpath, which has been already been deleted.
Response
Check that the server hosting the shared workpath is accessible, or
Retry the operation, using the mqsiremovebrokerinstance command to remove the local multi-instance broker defintion.

BIP8241
A multi-instance broker <insert_1> cannot be deleted because it does not exist in the shared workpath <insert_2>.
Severity
20 : Error
Explanation
The multi-instance broker cannot be found in the shared workpath, or it has not yet been created using the mqsicreatebroker command.
Response
Check that the server hosting the shared workpath is accessible.

BIP8242
A broker instance <insert_1> cannot be deleted because it does not exist in the local workpath <insert_2>.
Severity
20 : Error
Explanation
The broker instance has already been removed, or was never created originally.
Response
No user action required.

BIP8243
The broker <insert_1> cannot be deleted with the removebrokerinstance command because it is not a multi-instance broker.
Severity
20 : Error
Explanation
The broker was not created as multi-instance using the mqsiaddbrokerinstance command.
The broker can only be deleted with the mqsideletebroker command.
Response
Check that the server hosting the shared workpath is accessible.

BIP8244
A broker instance <insert_1> cannot be started because it does not exist in the shared workpath <insert_2>.
Severity
20 : Error
Explanation
The broker instance cannot be started because a multi-instance broker has been deleted from the shared workpath.
Response
Recreate the multi-instance broker on another server using the same shared work path.

BIP8245
A multi-instance broker <insert_1> cannot be started because the shared workpath <insert_2> does not exist.
Severity
20 : Error
Explanation
The broker instance needs to reference the shared workpath that cannot be found, or has not yet been created using the mqsicreatebroker command.
Response
Check that the server hosting the shared workpath is accessible.
If the shared workpath does not exist, use the mqsicreatebroker command to create the broker and the shared workpath.

BIP8246
Cannot create the WebSphere MQ service for broker <insert_1> and queue manager <insert_2>.
The WebSphere MQ return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when creating the WebSphere MQ service to stop and start a broker.
Response
Check the reason for the WebSphere MQ error and take any suggested corrective action.

BIP8247
Cannot alter the WebSphere MQ service for broker <insert_1> and queue manager <insert_2>.
The WebSphere MQ return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when altering the WebSphere MQ service to stop and start a broker.
Response
Check the reason for the WebSphere MQ error and take any suggested corrective action.

BIP8248
Cannot delete the WebSphere MQ service for broker <insert_1> and queue manager <insert_2>.
The WebSphere MQ return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when deleting the WebSphere MQ services to stop and start a broker.
Response
Check the reason for the WebSphere MQ error and take any suggested corrective action.

BIP8249
Cannot start the WebSphere MQ service for broker <insert_1> and queue manager <insert_2>.
The WebSphere MQ return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when starting the WebSphere MQ service for a broker.
Response
Check the reason for the WebSphere MQ error and take any suggested corrective action.

BIP8250
Cannot stop the MQSeries services for broker <insert_1> and queue manager <insert_2>.
The MQSeries return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when stopping the MQSeries service for a broker.
Response
Check the reason for the MQSeries error and take any suggested corrective action.

BIP8251
Service dependencies for component <insert_1> changed to <insert_2>; the previous value was <insert_3>.
Severity
10 : Warning
Explanation
The service dependencies for this component were incorrect for this installation. The dependencies have been updated to the correct value.
Response
None.

BIP8252
Service dependencies for component <insert_1> cannot be changed to <insert_2>: error <insert_4>. The current value remains at <insert_3>.
Severity
20 : Error
Explanation
The service dependencies for this component are incorrect for this installation. The command attempted to change these dependencies, but was unsuccessful.
Response
Determine why the change was unsuccessful, correct the problem, and re-run the command.

BIP8254
The Java API framework could not create an instance of <insert_1>.
Severity
20 : Error
Explanation
An internal JNI error has occurred during object instantiation due to NumberFormatException.
Response
Ensure that the field causing this error is correct. Contact your IBM support center if the issue persists.

BIP8264
Broker <insert_1> is a local broker instance. The associated multi-instance broker does not exist in the shared workpath <insert_2>. The multi-instance broker has been deleted from the shared workpath.
Severity
20 : Error
Explanation
The multi-instance broker no longer exists because it has already been deleted from the shared workpath.
A broker instance exists only locally. You cannot delete a broker instance with the mqsideletebroker command.
Response
You must use the mqsiremovebrokerinstance command to remove the local broker instance.

BIP8265
Cannot stop the MQSeries services for broker <insert_1> and queue manager <insert_2>.
The MQSeries return code is <insert_3>.
Severity
20 : Error
Explanation
There was an error when stopping the MQSeries service for a broker.
Response
Check the reason for the MQSeries error and take any suggested corrective action.

BIP8266
The data for multi-instance broker <insert_1>, or an instance of that broker, cannot be found in the shared workpath <insert_2>.
Severity
20 : Error
Explanation
The shared workpath exists, but the command cannot find the broker data in the expected subdirectories.
Response
If the broker is missing, run the mqsicreatebroker or mqsiaddbrokerinstance command as appropriate.

BIP8267
Warning, there might be problems with datasource <insert_1>. See the preceding messages for more information.
Severity
10 : Warning
Explanation
The mqsicvp command has completed, but some potential problems have been identified with the datasource provided.

BIP8268
Datasource <insert_1> is compatible with datasource <insert_2>.
Severity
0 : Information
Explanation
The capability offered by these two datasources is basically the same.
Response
These datasources can be used together within message processing nodes that support interaction with multiple discrete datasources through ESQL; for example, Database, Compute and Filter nodes.

BIP8269
Datasource <insert_1> is not compatible with datasource <insert_2>.
Severity
10 : Warning
Explanation
The capability offered by these two datasources is not the same. These datasources cannot be used together within message processing nodes that support interaction with multiple discrete datasources through ESQL; for example, Database, Compute and Filter nodes.

BIP8270
Connected to Datasource <insert_1> as user <insert_2>. The datasource platform is <insert_4>, version <insert_5>.
Severity
0 : Information

BIP8271
Connected to secondary datasource <insert_1> as user <insert_2>. The datasource platform is <insert_4>, version <insert_5>. This datasource can now be compared to the primary datasource.
Severity
0 : Information

BIP8272
Datasource <insert_1> has not been associated with broker <insert_2>.
Severity
20 : Error
Explanation
This invocation of the mqsicvp command requires that the datasource name has been associated with the broker, using the mqsisetdbparms command.
Response
Check that this datasource has been associated with the broker.

BIP8273
The following datatypes and functions are not natively supported by datasource <insert_1> using this ODBC driver: Unsupported datatypes: <insert_2> Unsupported functions: <insert_3>
Severity
0 : Information
Response
Examine the specific datatypes and functions not supported natively by this datasource using this ODBC driver.
When using these datatypes and functions within ESQL, the associated data processing is done within WebSphere Message Broker rather than being processed by the database provider.

Note that "functions" within this message can refer to functions or predicates.

BIP8274
Warning. The following datatypes and functions are not natively supported by datasource <insert_1> using this ODBC driver: Unsupported datatypes: <insert_2> Unsupported functions: <insert_3>
Severity
10 : Warning
Explanation
Some problems have been identified with the datasource provided.
Response
Examine the specific datatypes and functions not supported natively by this datasource using this ODBC driver.
Use of these datatypes and functions within ESQL can cause problems, and should be avoided.

Note that "functions" within this message can refer to functions or predicates.

BIP8275
Verification passed for User Datasource <insert_1>.
Severity
0 : Information

BIP8276
One or more problems have been detected with User Datasource <insert_1>. Use the mqsicvp command against this datasouce to obtain further information on these problems, together with any limitations that these problems could cause.
Severity
10 : Warning

BIP8277
The configurable service name that you specified, <insert_1>, starts with a digit or contains characters that are not valid.
Severity
20 : Error
Explanation
The configurable service name must not start with a digit and must only contain characters that are supported by the platform on which the command is being processed.
Response
Correct the configurable service name and reissue the command.

BIP8278
The library is not available.
Severity
20 : Error
Explanation
The library could not be found; it may have been deleted by the Message Broker Toolkit or a CMP application.
Response
Use the Message Broker Toolkit or a CMP application to see if the library exists.

BIP8279
The application is not available.
Severity
20 : Error
Explanation
The application could not be found; it may have been deleted by the Message Broker Toolkit or a CMP application.
Response
Use the Message Broker Toolkit or a CMP application to see if the application exists.

BIP8280
Successfully initialized interface to the NT security domain, <insert_1>.
Severity
0 : Information
Explanation
A component of WebSphere Message Broker has successfully initialized the NT security domain.
Response
No user action required.

BIP8281
Error in initializing the NT security domain&colon. return code <insert_1>; subsystem error code <insert_2>.
Severity
20 : Error
Explanation
A component of WebSphere Message Broker is attempting to initialize the NT security domain for use as a supplier of user and group information, without success.
Response
Check NT security subsystem documentation for the reported error.

BIP8282
Error in call <insert_1> to the NT security domain with return code <insert_2>.
Severity
20 : Error
Explanation
A component of WebSphere Message Broker is attempting to call the NT security domain. The security subsystem returned an error code.
Response
Check NT security subsystem documentation for the reported error. Restart the relevant broker. Ensure that a Domain Controller, either Primary or Backup, is available.

BIP8283
Error in determining the domain controller in the NT security domain, return code <insert_1>.
Severity
20 : Error
Explanation
A component of WebSphere Message Broker is attempting to initialize the NT security domain for use as a supplier of user and group information. The security subsystem returned an error code.
Response
Check NT security subsystem documentation for the reported error.

BIP8284
Failed to find NT security domain, <insert_1>.
Severity
20 : Error
Explanation
A component of WebSphere Message Broker has failed to locate the specified NT security domain.
Response
Check that the domain name was correctly specified and that it is accessible from this machine.

BIP8285
Insufficient authority to access NT security domain, <insert_1>.
Severity
20 : Error
Explanation
A component of WebSphere Message Broker is attempting to initialize the NT security domain for use as a supplier of user and group information. The userid under which the component is running does not have the authority to access this information in the specified domain.
Response
Check that the correct domain name was specified in the configuration command that created this component and check that its service id has administrative or account operator privilege in that domain.

BIP8287
This command displays the content of response messages.
Severity
10 : Warning
Explanation
Syntax:
mqsiexplain [messageNumber]

Command Options:
'messageNumber' is the message for which the command will show the details. This value can be the number itself, or it can be preceded by BIP.

BIP8288
Unable to read ODBCINI file <insert_1>. Check that this file exists, and that the broker user ID has permission to read and write the file.
Severity
10 : Warning
Explanation
The broker cannot read the file <insert_1>, which is specified by the ODBCINI environment variable.
Response
Ensure that the ODBCINI environment variable points to an existing file, and that the broker user ID has permission to read and write the file.

BIP8289
Unable to read ODBCSYSINI file in specified directory <insert_1>. Check that this file exists, and that the broker user ID has permission to read the file.
Severity
10 : Warning
Explanation
The broker cannot read the odbcinst.ini file in directory <insert_1>, which is specified by the ODBCSYSINI environment variable.
Response
Ensure that the ODBCSYSINI environment variable, if specified, points to a directory that contains the odbcinst.ini file, and that the broker user ID has permission to read the file.

BIP8290
Verification passed for the ODBC environment.
Severity
0 : Information

BIP8291
The IE02_PATH environment variable is not set.
Severity
10 : Warning
Explanation
The broker cannot find the IE02_PATH environment variable, which is required by the IBM WebSphere Message Broker ODBC Database Extender.
Response
Ensure that the IE02_PATH environment variable is set, and reissue the command.

BIP8292
<insert_1> User data sources were not verified, because they do not have mqsisetdbparms credentials.
Severity
0 : Information
Explanation
<insert_1> User data source stanzas are listed in the ODBCINI file, but were not verified by this command, because they have not been associated with the broker.
Response
Associate the data sources with the broker explicitly by using the mqsisetdbparms command, then reissue this command.

BIP8293
Unable to read ODBCUOINI file <insert_1>. Check that this file exists, and that the broker user ID has permission to read and write the file.
Severity
10 : Warning
Explanation
The broker cannot read the file <insert_1>, which is specified by the ODBCUOINI environment variable.
Response
Ensure that the ODBCUOINI environment variable points to an existing file, and that the broker user ID has permission to read and write the file. This file is required by the IBM WebSphere Message Broker ODBC Database Extender.

BIP8294
ODBC environment verification was skipped because the ODBCINI environment variable is not set.
Severity
0 : Information
Response
Check that the ODBCINI environment variable is set.

BIP8295
ODBC environment variables have not been set, or are invalid.
Severity
20 : Error
Explanation
The broker cannot verify user data sources because the ODBCINI, ODBCSYSINI, or IE02_PATH environment variables are not set, or because the ODBCINI environment variable is set incorrectly.
Response
Ensure that the ODBCINI environment variable is set, and see earlier warning messages for further details.

BIP8296
The ODBCSYSINI environment variable is not set.
Severity
10 : Warning
Explanation
The broker cannot find the ODBCSYSINI environment variable, which is required by the IBM WebSphere Message Broker ODBC Database Extender.
Response
Ensure that the ODBCSYSINI environment variable is set, and reissue the command.

BIP8297
<insert_1> file <insert_2> is empty.
Severity
10 : Warning
Explanation
The broker has detected that the file <insert_2>, which is specified by the <insert_1> environment variable, has zero size.
Response
Ensure that the <insert_1> environment variable points to a valid and complete file.

BIP8401
Message associated with internal message number <insert_1> was not found: data supplied <insert_2>
Severity
20 : Error
Explanation
An internal message number was used for which no associated message text could be found.
Response
This is an internal error. Contact your IBM support center.

BIP8403
MAX_CLIENT_READ_THREADS was < 0, it must be >= 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value.
Response
Respecify the MAX_CLIENT_READ_THREADS value to be greater or equal to 0 and restart the broker. Note that MAX_CLIENT_READ_THREADS is 0 by default and should not be specified as non-zero in normal operation. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxClientReadThreads -v value

BIP8404
PING_TIMEOUT_MULTIPLE was <= 0, it must be > 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value.
Response
Respecify the PING_TIMEOUT_MULTIPLE value to be greater than 0 and restart the broker. Note that PING_TIMEOUT_MULTIPLE=3 is the default and usually does not require overriding. To change the value, use the following mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n pingTimeoutMultiple -v value

BIP8405
PING_MIN was <= 0, it must be > 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value.
Response
Respecify the PING_MIN value to be greater than 0 and restart the broker. Note that PING_MIN is 100 by default and usually does not require overriding. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n pingMin -v value

BIP8406
EXPECTED_MESSAGE_SIZE was <= 0, it must be > 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value.
Response
Respecify the EXPECTED_MESSAGE_SIZE value to be greater than 0 and restart the broker. Note that EXPECTED_MESSAGE_SIZE=200 by default. While setting this value to something more like the true expected size can improve performance slightly, this parameter does not affect correctness, and the default is normally satisfactory. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n expectedMessageSize -v value

BIP8407
MAX_MESSAGE_SIZE was <= 0, it must be > 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value. The MAX_MESSAGE_SIZE value is used for the Real Time transport to declare the maximum size for messages to be delivered to client applications
Response
Modify the configuration request to specify a valid value for the attribute, and retry the request. This can be set by using : mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxMessageSize -v value A broker restart is required to activate the change.

BIP8408
MESSAGE_SIZE_EXTRA_ALLOWANCE was < 0, it must be >= 0.
Severity
20 : Error
Explanation
A configuration request was received which specified an invalid value. The MESSAGE_SIZE_EXTRA_ALLOWANCE value is used for the Real Time transport to declare the extra allowance size for messages to be delivered to client applications
Response
Modify the configuration request to specify a valid value for the attribute, and retry the request. This can be set by using : mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n messageSizeExtraAllowance -v value A broker restart is required to activate the changes.

BIP8410
An exception occurred while attempting to specify a "strong" crypto library for use by MinCrypto. MinCrypto will default to the standard exportable library instead. The exception is <insert_1>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
This is an internal error and you should contact your IBM support center.

BIP8411
An attempt to specify the default "exportable" crypto library in MinCrypto failed with an exception. The exception is <insert_1>.
Severity
20 : Error
Explanation
A security error has occurred. The error is described in the message.
Response
This is an internal error and you should contact your IBM support center.

BIP8412
A failure has occurred when attempting to log an event. The type of event is <insert_1>, the severity of the event is <insert_2>, and the exception is <insert_3>.
Severity
10 : Warning
Explanation
An event recording error has occurred. The error is described in the message.
Response
This is an internal error and you should contact your IBM support center.

BIP8413
The broker received an invalid or unexpected control message. The type of the message is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8414
Authentication on a broker-broker connection failed. This is non-fatal but must be repaired in order to allow multibroker routing. The name of the attempted broker-broker connection is <insert_1>, and the InauthenticBrokerException that was caught is <insert_2>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
Correct the error and retry the operation.

BIP8415
Authentication on a broker-broker connection timed out after too many unsuccessful attempts. This is non-fatal but must be repaired in order to allow multibroker routing. The name of the attempted broker-broker connection is <insert_1>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
Correct the error and retry the operation.

BIP8416
The broker caught an exception while attempting to update its broker-broker connection status using a local SemaphoreClient. The attempted update is <insert_1> and the exception is <insert_2>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8417
A VMX message received on a broker-broker connection had a bad MDT. The associated connection will be closed. The MsgDistException which triggered the event is <insert_1>, and the name of the broker-broker connection is <insert_2>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8418
An error was encountered while parsing the BROKERS_THRU_SOCKS parameter. This is non-fatal but will disable any socksified broker-broker connections. The caught exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8419
An error occurred while attempting to instantiate the non-blocking IO library. The regular blocking IO library will be used instead. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8420
A request was made to add an initial state processor to a topic which was already assigned a processor. The requested processor is ignored. The full name of the requested topic is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error; contact your IBM support center.

BIP8421
A SecurityGeneralException was encountered while processing a message received on a connection. The caught exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8422
A client attempted to publish on a topic for which it was not authorized. The message was dropped. The client connection is <insert_1>, and the topic is <insert_2>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
Correct the error and retry the operation.

BIP8423
A client connection failed on authentication and will be disconnected. The hostname and port of the failed connection is <insert_1>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
Correct the error and retry the operation.

BIP8424
A client connection was closed because it failed to finish authentication within a preset time limit. The hostname and port of the failed connection is <insert_1>.
Severity
10 : Warning
Explanation
A security error has occurred. The error is described in the message.
Response
Correct the error and retry the operation by attempting to reconnect the client

BIP8425
The broker configuration of MAX_BROKER_QUEUE_SIZE is between 0 and 500 bytes. This size is rather small and might cause many broker to broker messages to be discarded. The value of MAX_BROKER_QUEUE_SIZE is <insert_1>.
Severity
10 : Warning
Explanation
A configuration request was received which specified an unexpected value.
Response
Modify the configuration request to specify a valid value for the object, and retry the request. The MAX_BROKER_QUEUE_SIZE is used for queuing Real-time transport broker to broker messages. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxBrokerQueueSize -v value

BIP8426
The broker configuration of MAX_CLIENT_QUEUE_SIZE is between 0 and 500 bytes. This is rather small and may cause many client-broker messages to be discarded. The value of MAX_CLIENT_QUEUE_SIZE is <insert_1>.
Severity
10 : Warning
Explanation
A configuration request was received which specified an invalid value.
Response
Modify the configuration request to specify a valid value for the attribute, and retry the request. This can be done using mqsichangeproperties: mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxClientQueueSize -v value A broker restart is required to activate the change

BIP8427
ENABLE_SOCKS is true but BROKERS_THRU_SOCKS is zero-length. Processing will continue but no broker-broker connections will be socksified. This may not be the intended behavior.
Severity
10 : Warning
Explanation
A configuration request was received which specified an invalid value.
Response
Modify the configuration request to specify a valid value for the attribute, and retry the request. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n enableThruSocks -v value

BIP8428
ENABLE_SOCKS is true but SOCKS_HOST is zero-length. Processing will continue but connections between brokers will not be SOCKS-enabled. This may not be the intended behavior.
Severity
10 : Warning
Explanation
A configuration request was received which specified an invalid value.
Response
Modify the configuration request to specify a valid value for the attribute, and retry the request. mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n socksHost -v value

BIP8429
An exception was caught in the run loop of the StatsEPImpl thread. Processing continues. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8430
An exception occurred while closing the segment reader portion of a non-blocking threaded socket segment. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8431
An exception occurred while closing the segment writer portion of a non-blocking threaded socket segment. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8432
An exception occurred while deregistering the client associated with a non-blocking threaded socket segment. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8433
An exception occurred while closing the socket associated with a non-blocking threaded socket segment. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8437
A broker connection on socket <insert_1> established with name <insert_2> received a topology message from broker <insert_3>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8438
An attempt to establish a broker connection on socket <insert_1> failed with exception <insert_2>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error may be caused by an application attempting to use the port that has been configured for broker connections.
Response
Investigate whether an application is incorrectly using the socket that has been configured for broker connections.

BIP8439
An alpha services reload was requested but the wrong directory is in use.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8440
An error occurred during locking. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8441
An exception occurred during reset after a lock error. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8442
A service failure was reported to BrokerControl. The service reference is <insert_1>, the reason for the failure is <insert_2>, and the exception is <insert_3>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8443
The LogRecorder generated an exception while recording a log entry. The log mask is <insert_1> and the exception is <insert_2>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8444
An exception was caught while changing the state of an internal ControlHandler. Processing continues. The exception is <insert_1>.
Severity
10 : Warning
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8445
An exception was caught at the end of the scheduling loop of StatsEPImpl. As a result, the statistics entry point is now disabled. Processing continues, but statistics are no longer be available from this broker. The exception is <insert_1>.
Severity
20 : Error
Explanation
An unexpected error occurred. The error is described in the error message.
Response
This is an internal error and you should contact your IBM support center.

BIP8446
Message queue exceeded limit. Discarded <insert_1> bytes in <insert_2> messages.
Severity
10 : Warning
Explanation
The message queue exceeded its configured limit for the Real Time transport.
Response
Consider increasing the value of MAX_CLIENT_QUEUE_SIZE and MAX_BROKER_QUEUE_SIZE. These can be set using mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxClientQueueSize -v value or mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxBrokerQueueSize -v value MAX_CLIENT_QUEUE_SIZE is used for Broker to Client messages. MAX_BROKER_QUEUE_SIZE is used for Broker to Broker messages.

BIP8447
Client <<insert_1>> tried to publish a <insert_2> byte message, exceeding the limit <insert_3>.
Severity
10 : Warning
Explanation
A client connection was closed (culled) because it tried to publish a message that exceeded the configured limit, MAX_MESSAGE_SIZE. A string giving the hostname and port of the failed connection is included as the first parameter of this event. The size of the message is the second parameter. And the configured maximum is the third parameter.
Response
If the failing client was publishing a message within the expected size range, consider increasing the value of the MAX_MESSAGE_SIZE This can be set using : mqsichangeproperties BrokerName -e ExecutionGroupLabel -o DynamicSubscriptionEngine -n maxMessageSize -v value A broker restart is required to activate the change parameter.

BIP8448
A broker-broker connection with <insert_1> has been disconnected due to failure to respond to a ping
Severity
10 : Warning
Explanation
A connection did not respond to pings to it is about to be reaped. A string representing the host and port of the remote broker is the sole parameter of this event.
Response
This message is for information only, to indicate disconnection of a broker due to its inactivity. Reconnection will be attempted automatically.

BIP8449
A broker-broker connection with <insert_1> has been disconnected due to Exception <insert_2>.
Severity
10 : Warning
Explanation
An exception occurred while processing messages on a broker-broker connection. The exception may have occurred either due to a message processing error or a dropped connection.
Response
This message is for information only, to indicate disconnection of a broker due to an exception. Reconnection will be attempted automatically.

BIP8450
Server-to-server authentication failed because id of other broker <insert_1> was not in the server principals directory.
Severity
10 : Warning
Explanation
The would-be partner broker authenticated with an id that was not known to this broker.
Response
Ensure that the id <insert_1> is known to the broker

BIP8451
Client-to-server authentication failed because id of the client <insert_1> was not in the client principals directory.
Severity
20 : Error
Explanation
The would-be client authenticated with an id that was not known to this broker.
Response
Ensure that the client <insert_1> is known to the broker

BIP8452
<insert_1> is not allowed in BROKER_AUTH_PROTOCOLS.
Severity
20 : Error
Explanation
We don't allow the use of protocol <insert_1> for broker to broker authentication.
Response
This is an internal error and you should contact your IBM support center.

BIP8453
Broker-Broker connection on socket <insert_1> with broker <insert_2> has been established
Severity
0 : Information
Explanation
Broker-Broker connection on socket <insert_1> with broker <insert_2> has been established and authenticated with id=<insert_2> and protocol=<insert_3>.
Response
This message is for information only

BIP8454
The authentication timeout thread for an instance of Security caught an exception
Severity
20 : Error
Explanation
The authentication timeout thread for an instance of Security caught the exception <insert_1>1
Response
This is a warning message, client authentication may be affected.

BIP8460
Could not create internal non-blocking socket on the loopback address 127.0.0.1. Using the address of the adapter associated with the host name of the machine.
Severity
0 : Information
Explanation
An exception occurred while creating an internal communication socket bound to the loopback address 127.0.0.1. The operation will be retried using the address of the adapter bound to the hostname of the computer.
Response
This message is for information only.

BIP8461
Broker <insert_1> has an incorrectly configured Broker Topology: <insert_2> with <insert_3> neighbors: <insert_4>.
Severity
10 : Warning
Explanation
A Broker Topology has been incorrectly configured.
Response
This is an internal error. Contact your IBM support center.

BIP8462
Disthub caught a fatal exception [<insert_1>].
Severity
30 : Severe error
Explanation
A fatal exception occurred within the Broker <insert_1>. The behavior of the Broker is now undefined and further use will produce unpredictable results
Response
Restart the broker, if the problem persists you should contact your IBM support center

BIP8463
Broker <insert_1> detected a cycle in its own topology configuration.
Severity
20 : Error
Explanation
The broker found a cycle in the topology. This will result in publications looping around brokers in the topology.
Response
This is an internal error. Contact your IBM support center.

BIP8464
Error while trying to open Interbroker Port <insert_1>.
Severity
20 : Error
Explanation
While trying to open port <insert_1> for Real-time Communications from a Neighbor, a java.net.BindException occurred.
Response
This normally occurs because another application is holding the socket open. If required, change the InterbrokerPort Broker property in the Message Broker Toolkit to a port that isn't in use. This can also be done programmatically using a CMP application.

BIP8465
A connection from client at <insert_1> has been disconnected due to inactivity.
Severity
10 : Warning
Explanation
A connection did not respond to pings so it is about to be reaped. A string representing the host and port of the reaped connection is the sole parameter of this event.
Response
This message is for information only, to indicate disconnection of a client due to its inactivity.

BIP8500
The value supplied for parameter <insert_1> contains an invalid value <insert_2>. Allowed values for <insert_1> are: <insert_3>.
Severity
10 : Warning
Explanation
An invalid value was specified for the supplied parameter. Valid values for this parameter are: <insert_3>.
Response
Ensure that the value specified for parameter <insert_1> is valid.

BIP8501
The supplied HTTP request body is missing the following required fields: <insert_1>.
Severity
10 : Warning
Explanation
The supplied HTTP request body is missing the following required fields: <insert_1>.
Response
Ensure that the request body contains the fields <insert_1>.

BIP8502
The value supplied for parameter <insert_1> contains an invalid value <insert_2>. The value must be a non-negative integer.
Severity
10 : Warning
Explanation
An invalid value was specified for the supplied parameter. The value must be greater than or equal to 0.
Response
Ensure that the value specified for parameter <insert_1> is valid.

BIP8503
The user name associated with role <insert_1> does not have permission to view the execution group <insert_2>.
Severity
10 : Warning
Explanation
The user with role <insert_1> does not have the required permissions to view execution group <insert_2>.
Response
Check that the user's role <insert_1> has the required permissions to access execution group <insert_2>.

BIP8504
The user name associated with role <insert_1> does not have the permission on the execution group <insert_2> that is required to view the data capture store <insert_3>
Severity
10 : Warning
Explanation
The user with role <insert_1> does not have the required permissions on execution group <insert_2> to view data capture store <insert_3>.
Response
Check that the user's role <insert_1> has the required permissions to access execution group <insert_2>.

BIP8505
Changing the password of the default user is not allowed.
Severity
10 : Warning
Explanation
Administration security is disabled, and an attempt was made to change the password of the default user. Changing the password or role of the default user is not permitted.
Response
None.

BIP8506
User does not have permission to view object <insert_1>.
Severity
10 : Warning
Explanation
The user does not have the required permissions to view object <insert_1>.
Response
Check that the user's role has the required permissions to access object <insert_1>.

BIP8601
This program requires VGA or better resolution.
Severity
20 : Error
Explanation
The installation of this product requires that you use a display with at least VGA resolution.
Response
Check your display/display settings.

BIP8602
Setup requires Windows NT Server 4.0/SP5 or later.
Severity
20 : Error
Explanation
The installation of this product requires that your system level is Windows NT Server 4.0/SP5 or later.
Response
Upgrade your NT system.

BIP8603
WebSphere Message Broker install or uninstall is already running.
Severity
20 : Error
Explanation
The install has detected a conflicting install/uninstall process running on your machine.
Response
Exit this instance of the install/uninstall and terminate the conflicting process.

BIP8604
The system has detected that you do not have administrator equivalent rights. You must log on as an administrator and run setup again.
Severity
20 : Error
Explanation
To install WebSphere Message Broker you need administrator authority.
Response
Terminate the installation, log off, log on as an administrator, and retry.

BIP8606
Before setup can display help, this computer's help system needs upgrading to HTML Help 1.3. Would you like to upgrade now? You might need to restart the computer.
Severity
10 : Warning
Explanation
Help for install and uninstall requires that HTML Help 1.3 to be installed.
Response
If you want to see the install/uninstall help then you can allow WebSphere Message Broker to upgrade your system. Note that in order to activate this help you might need to terminate this install, reboot and then start install again.

BIP8608
Unable to create WebSphere MQ Topic <insert_1> on Queue Manager <insert_2>.
Severity
20 : Error
Explanation
This command attempts to create a WebSphere MQ Topic but was unable to do so.
Response
Locate and resolve the problem and retry the command.

BIP8609
Unable to delete WebSphere MQ Topic <insert_1> from Queue Manager <insert_2>.
Severity
20 : Error
Explanation
This command attempts to delete a WebSphere MQ Topic but was unable to do so.
Response
Locate and resolve the problem and retry the command. This could be because a WebSphere MQ channel is still running. If this is the case, stop all WebSphere MQ channels running on behalf of this Queue Manager. If any applications are connected to your broker, you may need to stop these as well.

BIP8610
Help cannot be displayed as Internet Explorer level is less than 4.01.
Severity
10 : Warning
Explanation
The install or uninstall cannot display help unless IE 4.01 or later is installed on your machine.
Response
If you wish to see the help for install/uninstall then you must exit this instance of the installation or uninstallation and upgrade your system.

BIP8611
Uninstall cannot continue, administrator authority is required.
Severity
20 : Error
Explanation
You require administrator authority to uninstall WebSphere Message Broker.
Response
Access the machine with the same user authority that the product was installed with.

BIP8612
Select at least one component to proceed.
Severity
0 : Information
Explanation
You need to select at least one component for installation/uninstallation.
Response
Select one or more components to proceed.

BIP8613
WebSphere Message Broker setup or uninstallation is already running.
Severity
10 : Warning
Explanation
WebSphere Message Broker uninstall has detected that there is an instance of install or uninstall already running.
Response
Terminate this uninstall instance and restart (if necessary) when the already running install or uninstall has finished.

BIP8614
One or more problems occurred during uninstallation. Review <insert_1> for details.
Severity
10 : Warning
Explanation
One (or more) problems were encountered during uninstallation of the product. You may have seen a previous message(s) indicating the nature of the problem. The install/uninstall log <insert_1> may contain additional information on the nature of the problem.
Response
Review the install/uninstall log <insert_1> to aid resolution of the problem. If the problem persists, contact your IBM support center.

BIP8615
Problem encountered stopping broker <insert_1>. Return from wmqpsstop was <insert_2>.
Severity
10 : Warning
Explanation
The uninstall process attempted to stop a broker named <insert_1> using wmqpsstop but encountered an error. The return code from this command was <insert_2>.
Response
Choose Retry to run the command again; this is the suggested action. If you choose Abort or Cancel the uninstall process ends. Before relaunching the uninstall process try to stop the broker identified manually. If Ignore is available, and you choose this option, the uninstall process continues, but it is possible that the problem with wmqpsstop might cause additional errors to appear when the uninstall process attempts to delete the broker. Additional help is available using the Help button.

BIP8616
Unable to delete broker <insert_1>. Return Code from wmqpsdeletebroker was <insert_2>. Abort, Retry, or Ignore?
Severity
10 : Warning
Explanation
The uninstall process attempted to delete a broker (<insert_1>) but encountered an error. The return code from wmqpsdeletebroker was <insert_2>.
Response
Choose Retry to run the command again. If you choose Abort or Cancel the uninstall process ends. Before relaunching the uninstall process try to delete the broker identified manually. If Ignore is available, and you choose this option, the uninstall process continues, but it is possible that you will encounter additional errors later. Additional help is available using the Help button.

BIP8619
Unable to stop User Name Server. Return Code from wmqpsstop was <insert_1>. See message
Severity
10 : Warning
Explanation
The uninstall process attempted to stop the User Name Server using wmqpsstop but encountered a problem. The return code from wmqpsstop was <insert_1>.
Response
Choose Retry to run the command again. If you choose Abort or Cancel the uninstall process ends. Before relaunching the uninstall process try to stop the User Name Server manually. If Ignore is available, and you choose this option, the uninstall process continues, but it is possible that the problem with wmqpsstop might cause additional errors to appear when the uninstall process attempts to delete the User Name Server. Additional help is available using the Help button.

BIP8621
Install of <insert_1> has started
Severity
0 : Information
Explanation
The install of product <insert_1> has started. The end of the install will be signaled by BIP8622.
Response
No user action required

BIP8622
Install of <insert_1> has finished successfully
Severity
0 : Information
Explanation
Install of product <insert_1> has finished without any errors.
Response
No user action required

BIP8623
Uninstall of <insert_1> has started
Severity
0 : Information
Explanation
The uninstall of product <insert_1> has started. The end of the uninstall will be signaled by BIP8624.
Response
No user action required

BIP8624
Uninstall of <insert_1> has finished successfully
Severity
0 : Information
Explanation
Uninstall of product <insert_1> has finished without any errors.
Response
No user action required

BIP8640
symlink returned EACCES when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
Write access to the directory containing <insert_2> is denied, or one of the directories in the path prefix of <insert_2> did not allow search permission.

BIP8641
symlink returned EEXIST when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
<insert_2> already exists.

BIP8642
symlink returned EFAULT when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
This is an internal error, please contact your IBM support center.

BIP8643
symlink returned EIO when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
An I/O error has occurred. Check the state of the file systems and retry the command. If the problem persists, contact your IBM support center.

BIP8644
symlink returned ELOOP when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
Too many symbolic links were encountered in resolving <insert_2>.

BIP8645
symlink returned ENAMETOOLONG when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
<insert_1> or <insert_2> was too long for the file system to handle.

BIP8646
symlink returned ENOENT when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
A directory component in <insert_2> does not exist or is a dangling symbolic link, or <insert_1> is the empty string.

BIP8647
symlink returned ENOMEM when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
Insufficient kernel memory was available.

BIP8648
File rename operation returned ENOSPC when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
The device containing <insert_2> path prefix has no room for the <insert_2> directory entry.

BIP8649
symlink returned ENOTDIR when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
A component used as a directory in <insert_2> is not, in fact, a directory.

BIP8650
symlink returned EPERM when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
The file system containing <insert_2> does not support the creation of symbolic links.

BIP8651
symlink returned EROFS when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
<insert_2> is on a read-only file system.

BIP8652
symlink operation failed when attempting to create a symbolic link with target <insert_1> and link name <insert_2>.
Severity
30 : Severe error
Explanation
The operation failed for an unknown reason, please attempt to create the symbolic manually and resolve the errors before re-running the command.

BIP8653
Creating a symbolic link with target <insert_1> and link name <insert_2>
Severity
0 : Information

BIP8654
Moving file system artifacts from <insert_1> to <insert_2>.
Severity
0 : Information

BIP8655
Removing <insert_1>.
Severity
0 : Information

BIP8656
Cannot remove non-empty directory <insert_1> due to unhandled file <insert_2>
Severity
10 : Warning

BIP8657
Creating directory <insert_1>
Severity
0 : Information

BIP8658
Unable to determine necessary information for migrating broker <insert_1>, does it really exist?
Severity
20 : Error

BIP8659
Could not determine the Data Source Name for broker <insert_1>, could be wrong version or -1 option missing with -c option.
Severity
20 : Error

BIP8660
Could not determine the Queue Manager for broker <insert_1>, could be wrong version or -1 option missing with -c option.
Severity
20 : Error

BIP8661
Detected source version <insert_1>.<insert_2>.<insert_3>.<insert_4>4
Severity
0 : Information

BIP8662
Detected target version <insert_1>.<insert_2>.<insert_3>.<insert_4>4
Severity
0 : Information

BIP8663
The execution group <insert_1> is being migrated from 32-bit to 64-bit mode. You might need to re-compile your user defined extensions, parsers, and exits before it can be re-started.
Severity
10 : Warning
Explanation
This version of the product no longer supports 32-bit execution groups.
Response
Make sure that your user defined extensions, parsers, and exits are re-compiled in 64-bit mode, if not already available. Check that they are in a location that the broker can access.

BIP8669
Database migration successful
Severity
0 : Information

BIP8670
Database migration started
Severity
0 : Information

BIP8671
Database migration failed
Severity
20 : Error

BIP8673
Migration of broker <insert_1> from version <insert_2>.<insert_3>.<insert_4>.<insert_5> to version <insert_6>.<insert_7>.<insert_8>.<insert_9> failed, see previous messages for reasons.
Severity
20 : Error

BIP8676
Component <insert_1> of type <insert_2> cannot be migrated; only components of type 'Broker' can be migrated.
Severity
20 : Error
Explanation
Only broker components can be migrated to this version of the product. Other component types that existed in previous versions are no longer used and cannot be migrated.
Response
Refer to the migration documentation.

BIP8677
Component <insert_1> was specified with a source version of <insert_2>.<insert_3>.<insert_4>.<insert_5>, whilst version <insert_6>.<insert_7>.<insert_8>.<insert_9> was detected.
Severity
10 : Warning

BIP8679
Found a 64 bit execution group: <insert_1>. Brokers with 64 bit execution groups cannot be migrated to versions prior to 6.
Severity
10 : Warning

BIP8680
Pre-migration check succeeded.
Severity
0 : Information

BIP8681
Pre-migration check failed.
Severity
10 : Warning

BIP8682
Unable to open root registry key <insert_1> for query.
Severity
10 : Warning

BIP8683
Unable to query values under key <insert_1>.
Severity
10 : Warning

BIP8684
Rolling back WebSphere MQ changes
Severity
10 : Warning

BIP8685
Rolling back Registry changes
Severity
10 : Warning

BIP8686
Finished Rolling back WebSphere MQ changes
Severity
10 : Warning

BIP8687
Finished Rolling back Registry changes
Severity
10 : Warning

BIP8688
Following migration, Message Set <insert_1>(<insert_2>) must be redeployed to Execution Group <insert_3>(<insert_4>).
Severity
10 : Warning

BIP8689
The source and target version are compatible, no migration is necessary.
Severity
0 : Information

BIP8690
The registry information for the broker <insert_1> could not be retrieved from the location specified in the environment variable $MQSI_REGISTRY. The environment variable $MQSI_REGISTRY is set to <insert_2>.
Severity
20 : Error
Explanation
$MQSI_REGISTRY is used to locate the directory that contains the definitions files for the broker.
Response
Update the variable to point to the correct location.

BIP8700
Post-migration check started.
Severity
0 : Information
Explanation
The migration utility is checking the component configuration to ensure that migration was successful.
Response
None.

BIP8701
Post-migration check succeeded.
Severity
0 : Information
Explanation
The migration utility did not find any configuration errors for the component.
Response
None.

BIP8702
The post-migration check failed. See previous messages for possible causes.
Severity
10 : Warning
Explanation
Configuration errors for the component were found, signifying that the component configuration is not correct. The previous messages provide details of the errors.
Response
Examine the previous messages to determine the cause of the failure. If you are migrating, you might need to undo the migration by using the different options of the mqsimigratecomponents command. If you are creating a broker, check that the persistent store of the broker does not contain tables from a different broker version.

BIP8703
Column <insert_1> is missing from database table <insert_2>
Severity
30 : Severe error
Explanation
Table <insert_2> must have the correct set of columns for this component to function correctly, and column <insert_1> is missing. This could be because a migration step has not been performed, or because the table itself has become damaged.
Response
If this broker is being started after a migration, ensure all migration steps have completed successfully. If this broker is newly created, and the database tables were created manually by a database administrator, ensure all columns specified are correct.

BIP8704
Column <insert_1> should not be present in database table <insert_2>
Severity
30 : Severe error
Explanation
Table <insert_2> must have the correct set of columns for this component to function correctly, and an extra column <insert_1> is present. This could be because a migration step has not been performed, or because the table itself has become damaged.
Response
If this broker is being started after a migration, ensure all migration steps have completed successfully. If this broker is newly created, and the database tables were created manually by a database administrator, ensure all columns specified are correct.

BIP8705
WebSphere MQ queue <insert_1> is missing.
Severity
30 : Severe error
Explanation
The WebSphere MQ queue manager must have the correct set of queues for this component to function correctly, and queue <insert_1> is missing. This could be because a migration step has not been performed, or because the queue manager itself has become damaged.
Response
If this broker is being started after a migration, ensure all migration steps have completed successfully. If this broker is newly created, and the WebSphere MQ queues were created manually by a WebSphere MQ administrator, ensure all queues specified are correct.

BIP8706
WebSphere MQ queue <insert_1> exists, but is not accessible; reason code <insert_2>.
Severity
20 : Error
Explanation
The WebSphere MQ queue manager must have the correct set of queues for this component to function correctly, and queue <insert_1> is not accessible. This could be because the permissions have been changed, or because the queue manager itself has become damaged.
Response
If this broker is being started after a migration, ensure all migration steps have completed successfully. If this broker is newly created, and the WebSphere MQ queues were created manually by a WebSphere MQ administrator, ensure all queues specified are correct, and the correct permissions. Examine the reason code, and correct any faults that might lead to this code.

BIP8750
Starting registry migration for component <insert_1>.
Severity
0 : Information
Explanation
Registry data is being migrated for component <insert_1>.
Response
None.

BIP8751
Created top-level 'CurrentVersion' key.
Severity
0 : Information
Explanation
As part of the registry migration, the 'CurrentVersion' key has been created.
Response
None.

BIP8752
Created <insert_1> subkey
Severity
0 : Information
Explanation
As part of the registry migration, the <insert_1> key has been created.
Response
None.

BIP8753
Created value named <insert_1>; value data is <insert_2>
Severity
0 : Information
Explanation
As part of the registry migration, the <insert_1> value has been created and set to <insert_2>
Response
None.

BIP8754
Moving registry data into 'CurrentVersion'
Severity
0 : Information
Explanation
As part of the registry migration, the legacy data is being moved into the new location.
Response
None.

BIP8755
Copied value <insert_1> into the new location
Severity
0 : Information
Explanation
As part of the registry migration, the legacy data element <insert_1> is being copied into the new location.
Response
None.

BIP8756
Finished moving registry data into 'CurrentVersion'
Severity
0 : Information
Explanation
The registry portion of the migration process has completed.
Response
None.

BIP8757
Error moving registry value <insert_1>: <insert_2>.
Severity
20 : Error
Explanation
An error has occurred when moving registry value <insert_1>. The registry migration will now be reversed.
Response
None.

BIP8758
Reversing registry migration for component <insert_1>.
Severity
10 : Warning
Explanation
Registry data is being un-migrated for component <insert_1>.
Response
None.

BIP8759
Found registry subkey <insert_1> that is not valid in either source or target; left unchanged.
Severity
10 : Warning
Explanation
During migration, the command found a registry subkey <insert_1> that is not valid in either source or target version; this value will be left unchanged.
Response
None.

BIP8760
Found registry value <insert_1> that is not valid in either source or target; left unchanged.
Severity
10 : Warning
Explanation
During migration, the command found a registry value <insert_1> that is not valid in either source or target version; this value will be left unchanged.
Response
None.

BIP8761
Found registry value <insert_1> for DSN <insert_2> that is not valid in either source or target; left unchanged.
Severity
10 : Warning
Explanation
During migration, the command found a registry value <insert_1> in DSN-specific subkey <insert_2> that is not valid in either source or target version; this value will be left unchanged.
Response
None.

BIP8762
Copied registry value from <insert_1> to HTTP value <insert_2>; set to <insert_3>
Severity
0 : Information
Explanation
During migration, the command found a registry value <insert_1> whose name must be changed for the new version into <insert_2>. The value data is still <insert_3>.
Response
None.

BIP8763
Deleted value <insert_1> from the old location
Severity
0 : Information
Explanation
As part of the registry migration, the legacy data element <insert_1> is being copied into the new location.
Response
None.

BIP8764
Found registry subkey <insert_1> that is not valid in the source version; left unchanged.
Severity
10 : Warning
Explanation
During migration, the command found a registry subkey <insert_1> that is not valid in the source version; this value will be left unchanged.
Response
None.

BIP8765
Found registry value <insert_1> that is not valid in the source version; left unchanged.
Severity
10 : Warning
Explanation
During migration, the command found a registry value <insert_1> that is not valid in the source version; this value will be left unchanged.
Response
None.

BIP8766
Copied value <insert_1> for DSN <insert_2> into the new location
Severity
0 : Information
Explanation
As part of the registry migration, the legacy data element <insert_1> is being copied into the new location for DSN <insert_2>.
Response
None.

BIP8767
Found registry value <insert_1> that is not valid in the target version; not copied.
Severity
10 : Warning
Explanation
During migration, the command found a registry value <insert_1> that is not valid in the target version; this value will not be copied, though no functionality will be lost.
Response
None.

BIP8768
Finished registry migration for component <insert_1>.
Severity
0 : Information
Explanation
Registry data has been successfully migrated for component <insert_1>.
Response
None.

BIP8769
An error occurred when migrating broker <insert_1> to a previous version. You cannot remove the source version (<insert_2>) of the broker registry after migration.
Severity
10 : Warning
Explanation
An error occurred removing the source version (<insert_2>) of the broker registry when migrating broker <insert_1> to a previous version (<insert_3>). This error can occur if one or more of the files or folders in the registry are in use, are open in an application, or a folder is the current working directory in a Command Prompt.
Response
Ensure that none of the files or folders are in use and try again.

BIP8770
An error occurred when creating primary registry folders for broker <insert_1> in the filesystem, at location <insert_2>. Ensure that the user running the command has full access to this location.
Severity
10 : Warning
Explanation
The primary folders for broker <insert_1> could not be created in the filesystem at location <insert_2>.
Response
Ensure that the user running the command has the correct permissions.

BIP8771
An error occurred changing the location of the broker service for broker <insert_1>.
Severity
10 : Warning
Explanation
The location of the service for broker <insert_1> could not be updated to the new location.
Response
Ensure that the user running the command has the correct permissions.

BIP8772
An error occurred changing the permissions of the broker service for the broker <insert_1>.
Severity
10 : Warning
Explanation
The permissions for the broker service for the broker <insert_1> could not be updated.
Response
Ensure that the user running the command has the correct permissions.

BIP8773
An error occurred when migrating the registry for broker <insert_1>.
Severity
10 : Warning
Explanation
An error occurred when migrating the registry for broker <insert_1> from the old version to the new.
Response
See previous error messages for further details.

BIP8774
Warning: Unable to set the correct access permissions on a file or folder in the explicit workpath (-w) located at <insert_2> for broker <insert_1>. Migration will continue, but the permissions on the file(s) at this location have not been changed.
Severity
10 : Warning
Explanation
The permissions a file or folder in the explicit workpath (-w) at location <insert_2> for the broker <insert_1> could not be updated.
Response
Ensure that the user running the command has the correct permissions.

BIP8775
An error occurred when opening a required registry key <insert_2> for broker <insert_1>.
Severity
10 : Warning
Explanation
Could not access required registry key <insert_2>. Error code <insert_3>, last error <insert_4>.
Response
Ensure that the user running the command has the correct permissions.

BIP8776
An error occurred when creating a required registry folder at location <insert_2> for broker <insert_1>.
Severity
10 : Warning
Explanation
Could not create registry folder <insert_2>. Error code <insert_3>, last error <insert_4>.
Response
Ensure that the user running the command has the correct permissions.

BIP8777
An error occurred when opening registry file <insert_2> for migration under broker <insert_1>.
Severity
10 : Warning
Explanation
Could not open registry file <insert_2>. Error code <insert_3>.
Response
Ensure that the user running the command has the correct permissions.

BIP8778
An error occurred when opening registry file <insert_2> for migration under broker <insert_1>, the file does not exist.
Severity
10 : Warning
Explanation
Could not open a required file <insert_2> as it does not exist. Error code <insert_3>.
Response
Ensure that the user running the command has the correct permissions and that the file exists and is accessible.

BIP8779
An error occurred when reading from registry file <insert_2> during migration under broker <insert_1>, the file seems invalid or corrupt.
Severity
10 : Warning
Explanation
Could not read from the required file <insert_2> as it is not valid. Error code <insert_3>.
Response
Ensure that the user running the command has the correct permissions and that the file exists and that it is accessible.

BIP8780
An error occurred when writing to the registry file <insert_2> when migrating broker <insert_1>.
Severity
10 : Warning
Explanation
Could not write to the required file <insert_2>. Error code <insert_3>.
Response
Ensure that the user running the command has the correct permissions and that the file location is accessible.

BIP8781
A user defined Configurable Service with an invalid character in its name was encountered when migrating the Configurable Services under broker <insert_1>. The Configurable Service was called <insert_2> and is of type <insert_3>. This Configurable Service must be renamed before migration can take place.
Severity
10 : Warning
Explanation
The user defined Configurable Service <insert_2> of type <insert_3> has at least one invalid character in its name starting at position <insert_4>.
Response
Rename the Configurable Service and re-run the migration command.

BIP8782
A DataSource Name (DSN) called <insert_2> with invalid characters in its name was encountered when migrating the DSNs under broker <insert_1>. This DSN must be renamed before migration can take place.
Severity
10 : Warning
Explanation
The DSN <insert_2> has at least one invalid character in its name starting at position <insert_3>.
Response
Rename the DSN and re-run the migration command.

BIP8783
The broker <insert_1> does not exist at a previous level, and so cannot be migrated backwards.
Severity
10 : Warning
Explanation
The broker <insert_1> cannot be migrated backwards as it does not exist at the previous level.
Response
For a broker to be migrated backwards, it must exist at the previous level.

BIP8785
Starting WebSphere MQ queue migration for component <insert_1>.
Severity
0 : Information
Explanation
Queue data is being migrated for component <insert_1>.
Response
None.

BIP8786
Created WebSphere MQ queue <insert_1>
Severity
0 : Information
Explanation
As part of the WebSphere MQ queue migration, the queue <insert_1> has been created.
Response
None.

BIP8787
Cleared WebSphere MQ queue <insert_1>
Severity
0 : Information
Explanation
As part of the WebSphere MQ queue migration, the queue <insert_1> has been cleared of messages.
Response
None.

BIP8788
Deleted WebSphere MQ queue <insert_1>
Severity
0 : Information
Explanation
As part of the WebSphere MQ queue migration, the queue <insert_1> has been deleted.
Response
None.

BIP8789
Finished WebSphere MQ queue migration for component <insert_1>.
Severity
0 : Information
Explanation
Queue data has been successfully migrated for component <insert_1>.
Response
None.

BIP8790
Duplicate rows were detected in table <insert_1>. Migration cannot complete successfully.
Severity
30 : Severe error
Explanation
Duplicate rows were detected in table <insert_1>. The destination product requires unique indexes to be added to the table for correct operation, and duplicate rows prevent the index add from succeeding.
Response
Contact IBM service for more assistance; do not attempt to correct the problem.

BIP8791
Duplicate rows check started.
Severity
0 : Information
Explanation
The migration utility is checking the broker database for entries that could cause migration to fail.
Response
None.

BIP8792
Duplicate rows check passed.
Severity
0 : Information
Explanation
No duplicate rows were detected in the broker database.
Response
None.

BIP8793
Duplicate rows check failed.
Severity
30 : Severe error
Explanation
Duplicate rows were detected in the broker database. See previous errors for more information.
Response
Contact IBM service for more assistance; do not attempt to correct the problem.

BIP8794
Table <insert_1> has no duplicated rows.
Severity
0 : Information
Explanation
The destination product requires unique indexes to be added to the table for correct operation, and duplicate rows prevent the index add from succeeding.
Response
None.

BIP8797
Topic syntax check succeeded.
Severity
0 : Information
Explanation
No topic syntax errors where found in the broker database.
Response
None.

BIP8798
Topic syntax check failed; see previous messages for possible causes.
Severity
10 : Warning
Explanation
An invalid topic has been found in the Broker Database.
Response
Examine previous messages, and errors reported during migration steps, to determine the cause of the failure. The migration may need to be reversed, or completed manually.

BIP8799
Invalid topic syntax was detected in table <insert_1>. Topic is <insert_2>. This will prevent migration from succeeding.
Severity
20 : Error
Explanation
Invalid topic syntax was detected in table <insert_1>. Topic is <insert_2>. The destination product requires a new topic syntax and any invalid topic will cause the Broker to be unable to start.
Response
Contact IBM service for more assistance; do not attempt to correct the problem.

BIP8800
No invalid topic syntax was detected in table <insert_1>.
Severity
0 : Information

BIP8801
Unable to migrate the registry for broker <insert_1>1
Severity
10 : Warning
Explanation
The broker database for the given broker has been migrated successfully, however while attempting to migrate its registry to the current location a failure occurred.
Response
Migrate this broker's registry to the current location manually.

BIP8802
Sets the license processor count.
Severity
0 : Information
Explanation
Syntax:
mqsisetcapacity -c processorCount


Command Options:
'-c processorCount' is the number of processors on this machine for which WebSphere Message Broker is licensed.

BIP8803
Displays the license processor count. Syntax : mqsidisplaycapacity
Severity
0 : Information
Explanation
Shows the processor count entered via the mqsisetcapacity command.

BIP8804
This copy of WebSphere Message Broker is now running in Production mode.
Severity
0 : Information
Explanation
A Production license has been installed for this copy of WebSphere Message Broker.

BIP8805
No license installed for this copy of WebSphere Message Broker.
Severity
20 : Error
Explanation
No Production license has been installed for this copy of WebSphere Message Broker.
Response
A valid Production license must be installed before the WebSphere Message Broker product can be run, ensure that the product installation completed successfully.

BIP8806
A license could not be installed for this copy of WebSphere Message Broker.
Severity
20 : Error
Explanation
A Production license could not be installed for this copy of WebSphere Message Broker. This is because the 'nodelock' file in the '/bin' directory could not be created or updated.
Response
Check the ownership and permissions for the '/bin' directory.

BIP8807
The Production license for this copy of WebSphere Message Broker has expired.
Severity
20 : Error
Explanation
The production license for this copy of WebSphere Message Broker has an expiry date. This date has been passed.
Response
Contact your IBM support center.

BIP8808
License file <insert_1> not found or not valid. For more information refer to the WebSphere Message Broker online help.
Severity
20 : Error
Explanation
WebSphere Message Broker requires that the file <insert_1> is present and available and is a valid license file. For more information refer to the online help.
Response
Check that the specified file exists.

BIP8809
This copy of WebSphere Message Broker is already running in Production mode.
Severity
0 : Information
Explanation
A Production license has previously been installed for this copy of WebSphere Message Broker.

BIP8810
Insufficient license units.
Severity
10 : Warning
Explanation
The purchased processor allowance (<insert_1>) is less than the number of processors (<insert_2>) in this machine.
Response
Ensure sufficient license units have been purchased and use the WebSphere Message Broker mqsisetcapacity command to set the purchased processor allowance for this installation. For more information refer to the online help.

BIP8811
The purchased processor allowance is set to <insert_1>.
Severity
0 : Information
Explanation
The purchased processor allowance for this installation of WebSphere Message Broker has been set to <insert_1> using the mqsisetcapacity command.

BIP8812
The purchased processor allowance is <insert_1>1
Severity
0 : Information
Explanation
The purchased processor allowance is currently set to <insert_1>1
Response
Ensure sufficient license units have been purchased and, if necessary, use the WebSphere Message Broker mqsisetcapacity command to change the purchased processor allowance for this installation. For more information refer to the online help.

BIP8813
The number of processors in this machine is <insert_1>1
Severity
0 : Information
Explanation
The operating system reports that the number of processors in this machine is <insert_1>.

BIP8814
The number of license units is sufficient for all future possible upgrades to this machine.
Severity
0 : Information
Explanation
The purchased processor allowance for this installation of WebSphere Message Broker has been set to -1, which allows any permitted processor configuration.

BIP8815
Purchased processor allowance not set (use the mqsisetcapacity command).
Severity
10 : Warning
Explanation
The purchased processor allowance for this installation has not been set.
Response
Ensure sufficient license units have been purchased for WebSphere Message Broker and use the mqsisetcapacity command to set the purchased processor allowance for this installation. For more information refer to the online help.

BIP8816
QueueManagerName does not exist for component <insert_1>.
Severity
20 : Error
Explanation
No queues were deleted because QueueManagerName does not exist in the component registry.
Response
Ensure the component registry is correct and has not been deleted. Recreate the component registry if necessary.

BIP8817
DataSourceName does not exist for component <insert_1>.
Severity
20 : Error
Explanation
No database rows were deleted because DataSourceName does not exist in the component registry.
Response
Ensure the component registry is correct and has not been deleted. Recreate the component registry if necessary.

BIP8818
Creates queues on a WebSphere MQ queue manager for use with a migrated broker.
Severity
10 : Warning
Explanation
Syntax:
mqsimigratequeues brokerName


Command options
'brokerName' the name of broker whose queues are to be migrated.

BIP8819
Migrates WebSphere MQ queues for brokers. Syntax: mqsimigratequeues
Severity
10 : Warning
Explanation
Creates queues on a WebSphere MQ queue manager for use with a migrated broker.

BIP8820
Enter password for user ID
Severity
10 : Warning
Explanation
This is used to prompt for a password for service user ID on the console.
Response
Enter password for user ID

BIP8821
Enter password for user ID
Severity
10 : Warning
Explanation
This is used to prompt for a password for service user ID on the console.
Response
Enter password for user ID

BIP8822
The supplied password is invalid. Ensure that the password is within the range of 2 - 255 characters in length.
Severity
10 : Warning
Response
Re-enter the password.

BIP8823
Retype password for user ID
Severity
10 : Warning
Explanation
This is used to prompt for a password for service user ID on the console.
Response
Retype password for user ID

BIP8824
Retype password for user ID.
Severity
10 : Warning
Explanation
This prompts you for a password for the service user ID on the console.
Response
Retype the password for your user ID.

BIP8825
Passwords do not match.
Severity
10 : Warning
Explanation
Passwords do not match.
Response
Passwords do not match.

BIP8826
Invalid version identifier <insert_1> supplied.
Severity
30 : Severe error
Explanation
The supplied version is not valid as a function-level specifier
Response
Check that the string given to the '-f' argument is 'all', blank, or of the form <version>.<release>.<modification>.<fix>

BIP8827
Creates a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsicreatebroker. brokerName -q queueManagerName [-l userLilPath] [-1 | -2] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-v statisticsMajorInterval] [-P httpListenerPort] [-y ldapPrincipal -z ldapCredentials] [-x userExitPath] [-s adminSecurity] [-b cachePolicy] [-r cachePortRange]


Command Options
'brokerName' the name of the broker to create.
'-q queueManagerName' the WebSphere MQ queue manager that the broker will use. The queue manager is created if it does not exist.
'-1' creates only the broker's registry.
'-2' creates only the broker's WebSphere MQ resources.
'-l userLilPath' the directory from which the broker searches for user-supplied libraries.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'. The default is 'inactive'.
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.

BIP8828
Deletes a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsideletebroker. brokerName [-1 | -2] [-s]


Command Options:
'brokerName' name of the broker to delete
'-1' deletes only the broker's registry.
'-2' deletes only the broker's WebSphere MQ queues.
'-s' delete the broker and any current execution group administration security WebSphere MQ queues.

BIP8833
Changes the configuration of a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsichangebroker brokerName [-l userLilPath] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-v statisticsMajorInterval] [-P httpListenerPort] [-y ldapPrincipal] [-z ldapCredentials] [-x userExitPath] [-e activeUserExits] [-s adminSecurity] [-f function level] [-b cachePolicy] [-r cachePortRange]


Command options:
'brokerName' the name of the broker.
'-l userLilPath' the directory from which the broker searches for user-supplied libraries.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker HTTP listener uses.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-e activeUserExits' the active user exits. By default, user exits are inactive. Adding a userExit name to this list changes its default state to active for this broker. The default state can be overridden at the execution group or message flow level using the mqsichangeflowuserexits command. If a user exit name is specified, and no library is found to provide that user exit when the execution group starts, a BIP8860 message is written to the system log and the execution group fails to start. The separator character for the list is ':'.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'.
'-f function level' the effective function level of the broker, such as '7.0.0.1', '7.0.0.2', or 'all'
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.

BIP8840
Deploys a BAR file or deletes resources from an execution group. Syntax: deploy e=egName ((a=BARFileName [m=yes]) | d=resourcesToDelete) [w=timeoutSecs]
Severity
10 : Warning
Explanation
Command Options:
'e=egName' name of execution group to deploy to.
'a=BARFileName' deploy the specified BAR file.
'm=yes' empties the execution group before deployment.
'd=resourcesToDelete' deletes a colon-separated list of resources from the execution group.
'w=timeoutSecs' maximum number of seconds to wait for the broker to respond (default is 60).

BIP8841
Deploys a BAR file or deletes resources from an execution group.
Severity
0 : Information
Explanation
Syntax:
mqsideploy brokerSpec -e egName ((-a BARFileName [-m]) | -d resourcesToDelete) [-w timeoutSecs] [-v traceFileName]

Command options:
'brokerSpec' is one of:
(a) 'brokerName' : Name of a locally defined broker
(b) '-n brokerFileName' : File containing remote broker connection parameters (*.broker)
(c) '-i ipAddress -p port -q qMgr' : hostname, port and queue manager of a remote broker
'-e egName' name of execution group
'-a BARFileName' deploy the specified BAR file
'-m' empties the execution group before deployment
'-d resourcesToDelete' deletes a colon-separated list of resources from the execution group
'-w timeoutSecs' maximum number of seconds to wait for the broker to respond (default is 60)
'-v traceFileName' send verbose internal trace to the specified file.

BIP8846
Configuration data for component <insert_1> is not usable by this product version (level <insert_2>; should be <insert_3>).
Severity
30 : Severe error
Explanation
Each component has configuration data associated with it, and this data is versioned to ensure that the component can only be run under a product version that supports this level. The component level is <insert_2> and the current code level only supports <insert_3>.

BIP8847
migrates a components queues, registry, database and file-system information between different versions.
Severity
10 : Warning
Explanation
Syntax:
mqsimigratecomponents componentName [ -s sourceVersion ] [ -t targetVersion ] [ -c ] [ -1 ] [ -2 ] [ -3 ] [ -v ] [ -q ] [ -u ] [-m]


Command Options:
'componentName' is the name of the component to query for its registry data
'-s sourceVersion' The current version of the component.
'-t targetVersion' The version of the component to migrate to.
'-c' Do a pre-migration check of the specified component. This will attempt to determine whether the current state of the component is such that it can be safely migrated.
'-1' Do only registry and file-system related migration work. Use this when security restrictions prevent the command from migrating WebSphere MQ, registry and file-system and database in one step.
'-2' Do only WebSphere MQ related migration work. Use this when security restrictions prevent the command from migrating WebSphere MQ, registry and file-system and database in one step.
'-3' Do only database related migration work. Use this when security restrictions prevent the command from migrating WebSphere MQ queues, registry and file-system and database in one step.
'-v' Do a post-migration check of the specified component for the new version of the component.
'-q' Reduce the verbosity of the progress of the command.
'-u' Undo a failed migration step. At least one of -1, -2 or -3 must also be specified. This should only be used when migration has failed, and also failed to auto-recover.
'-m' Required when migrating a Version 6.1 broker to Version 8 on a Windows platform that uses Microsoft Cluster Server (MSCS).

BIP8848
Invalid version <insert_1>.<insert_2>.<insert_3>.<insert_4> supplied.
Severity
30 : Severe error
Explanation
The supplied version is not compatible to migrate to or from with this component.
Response
Check that the string given to the '-s' or '-t' argument is of the form <version>.<release>.<modification>.<fix>.
The minimum supported versions for migration to or from WebSphere Message Broker <insert_5>.<insert_6>.<insert_7>.<insert_8>, are versions 6.0.0.0 or later.
If the version has already been specified correctly the component cannot be automatically migrated.

BIP8849
Broker <insert_1> (Version <insert_4>.<insert_5>) with Queue Manager <insert_2> and Data Source <insert_3> specified for migration.
Severity
0 : Information

BIP8850
Displays broker property settings.
Severity
10 : Warning
Explanation
Syntax:
mqsireportodbcconnectioninfo -q dsn1 -u userName1 -p password1 [-c dsn2 -i userName2 -a password2] [-v]


Command Options:
'-q dsn1' First DataSource to query
'-u userName1' Username to use when connecting to DSN1
'-p password1' Password to use when connecting to DSN1
'-c dsn2' Second DataSource to compare to DSN1
'-i userName2' Username to use when connecting to DSN2
'-a password2' Password to use when connecting to DSN2
'-v' verbose output
Specifing only -q provides ODBC information about DSN1. If -c is also specified then DSN2 is compared to DSN1 for equality of functionality.

BIP8851
Migration Failed
Severity
30 : Severe error
Explanation
One of the migration steps failed, please see messages above for more details.

BIP8852
Sets list of active or inactive user exits.
Severity
10 : Warning
Explanation
Syntax:
mqsichangeflowuserexits brokerName -e egName [[-k applicationName] [-y libraryName] -f messageFlowName] (-a activeUserExitList |-i inactiveUserExitList)
Command Options:
'brokerName' name of the broker.
'-e egName' name of the execution group.
'-f messageFlowName' name of message flow.
'-k applicationName' name of application.
'-y libraryName' name of library.
'-a activeUserExitList' colon separated list of names of user exits to be set to active state.
'-i inactiveUserExitList' colon separated list of names of user exits to be set to inactive state.
The command does not alter the existing value of a user exit list, if the corresponding name/value pair is not specified. To clear a user exit list, use an empty string (""), for example, '-i ""'.

BIP8853
queries the lists of active and inactive user exits.
Severity
10 : Warning
Explanation
Syntax:
mqsireportflowuserexits brokerName [-e egName [[-k applicationName] [-y libraryName] -f messageFlowName]]


Command Options:
'brokerName' name of the broker
'-e egName' name of the execution group
'-f messageFlowName' name of message flow
'-k applicationName' name of application
'-y libraryName' name of library

BIP8854
User Exits active for Execution Group <insert_1>: <insert_2>.
Severity
0 : Information

BIP8855
User Exits inactive for Execution Group <insert_1>: <insert_2>.
Severity
0 : Information

BIP8856
User Exits active for Message Flow <insert_1>: <insert_2>.
Severity
0 : Information

BIP8857
User Exits inactive for Message Flow <insert_1>: <insert_2>.
Severity
0 : Information

BIP8858
Invalid user exit name <insert_1> specified
Severity
20 : Error
Explanation
User exit name <insert_1> specified on the <insert_2> flag does not correspond to any user exit available to the target execution group.
Response
Review the name provided. If the name is incorrect, reissue the command with the correct name. If the name is correct, ensure that the user exit library is being loaded by the execution group. Check settings for MQSI_USER_EXIT_PATH environment variable and/or userExitPath broker property to ensure one of them includes the directory containing the user exit library. Check system log when execution group starts for errors loading the user exit library.

BIP8859
User Exits active for broker <insert_1>: <insert_2>.
Severity
0 : Information

BIP8860
User Exit <insert_1> not found
Severity
20 : Error
Explanation
A User Exit name <insert_1> has been specified as active or inactive but that user exit was not provided by any library loaded by this execution group. No user message flows will be started until this is resolved.
Response
Review the name provided. If the name is incorrect, reissue the relevant command with the correct name. If the user exit was set at the broker level, then run mqsichangebroker to correct it. If it was set at the execution group level, then run mqsichangeflowuserexit to correct it. Issue mqsireportflowuserexit to help determine where the invalid user exit name was set. If the name is correct, ensure that the user exit library is being loaded by the execution group. Check settings for MQSI_USER_EXIT_PATH environment variable and/or userExitPath broker property to ensure one of them includes the directory containing the user exit library. Check system log when execution group starts for errors loading the user exit library.

BIP8861
User Exit <insert_1> not found for flow <insert_2>
Severity
20 : Error
Explanation
A User Exit name <insert_1> has been specified as active or inactive for message flow <insert_2> but that user exit was not provided by any library loaded by this execution group. This message flow will be not started until this is resolved.
Response
Review the name provided. If the name is incorrect, reissue the mqsichangeflowuserexit command with the correct name. If the name is correct, ensure that the user exit library is being loaded by the execution group. Check settings for MQSI_USER_EXIT_PATH environment variable and/or userExitPath broker property to ensure one of them includes the directory containing the user exit library. Check system log when execution group starts for errors loading the user exit library.

BIP8862
Sets the list of active or inactive user exits. Syntax: changeflowuserexits brokerName e=egName [[k=applicationName] [y=libraryName] f=messageFlowName] (a=activeUserExitList |i=inactiveUserExitList)
Severity
10 : Warning
Explanation
Command Options:
'brokerName' name of the broker.
'e=egName' name of the execution group.
'k=applicationName' name of application.
'y=libraryName' name of library.
'f=messageFlowName' name of message flow.
'a=activeUserExitList' colon separated list of names of user exits to be set to active state.
'i=inactiveUserExitList' colon separated list of names of user exits to be set to inactive state.

BIP8863
Queries the lists of active and inactive user exits. Syntax: reportflowuserexits brokerName [e=egName [[k=applicationName] [y=libraryName] f=messageFlowName]]
Severity
10 : Warning
Explanation
Command Options:
'brokerName' name of the broker.
'e=egName' name of the execution group.
'f=messageFlowName' name of message flow.
'k=applicationName' name of application.
'y=libraryName' name of library.

BIP8864
Internal Error: Unable to set RC and inserts (RC is <insert_1>).
Severity
20 : Error
Explanation
Unable to set RC and inserts as RC, <insert_1>, is unknown.
Response
Contact your IBM support center to report this error.

BIP8865
Bad flag combination. The flags in list (<insert_1>) can't be specified together.
Severity
20 : Error
Explanation
None.
Response
Correct and reissue the command.

BIP8866
The registry is not in the correct state for this step-by-step migration (using the '-2' or '-3' flags) from Version (<insert_1>.<insert_2>.<insert_3>.<insert_4>) to Version (<insert_5>.<insert_6>.<insert_7>.<insert_8>).
Severity
20 : Error
Explanation
For a forward migration, the correct order for step-by-step migration is to migrate the registry (by using the '-1' flag) before migrating any other components.
Response
Correct the migration order.

BIP8867
Migration from Version <insert_1>.<insert_2>.<insert_3>.<insert_4> to Version <insert_5>.<insert_6>.<insert_7>.<insert_8> is not supported.
Severity
20 : Error
Explanation
Direct migrations between two previous versions are not supported, i.e. either the source version or the target version must be the current product version.
Response
Correct migration strategy.

BIP8868
<insert_1> is not a known component. However, an attempt will be made to delete resources associated with this component name. Make sure that you spelt the component name correctly, and that you ran the command on the right computer. Also make sure that the component was created by, or was migrated to, the current version of WebSphere Message Broker.
Severity
10 : Warning

BIP8869
The registry is not in the correct state for this step-by-step reverse migration (using the '-1' flag) from Version (<insert_1>.<insert_2>.<insert_3>.<insert_4>) to Version (<insert_5>.<insert_6>.<insert_7>.<insert_8>).
Severity
20 : Error
Explanation
For a reverse migration, the correct order for step-by-step migration is to reverse migrate the registry (by using the '-1' flag) only after reverse migration of all other components (using the '-2' or '-3' flags, or both) is complete.
Response
Correct the migration order.

BIP8870
Trace nodes are: <insert_1> for execution group: <insert_2>, message flow: <insert_3>.
Severity
0 : Information
Explanation
Trace nodes are either 'on' or 'off' for each message flow. These settings take effect only if the execution group setting is 'on'.

BIP8871
Execution group: <insert_2> has trace nodes: <insert_1> for its message flows.
Severity
0 : Information
Explanation
When the execution group has trace nodes set to 'on' the individual settings on the message flows take effect.

BIP8872
Verifies a broker. Verifies a user datasource to be used within the broker, or compares primary and secondary datasources for equivalence.
Severity
10 : Warning
Explanation
Syntax (1):
mqsicvp <brokerName>
Syntax (2):
mqsicvp <brokerName> -n <primaryDatasource> [-c <secondaryDatasource>] [-v]
Syntax (3):
mqsicvp -n <primaryDatasource> -u <primaryDatasourceUserId> -p <primaryDatasourcePassword> [-c <secondaryDatasource> -i <secondaryDatasourceUserId> -a <secondaryDatasourcePassword>] [-v]


Command options, syntax (1):
<brokerName>
The broker name.

Command options, syntax (2):
<brokerName>
The broker name.
-n <primaryDatasource>
The name of the datasource to verify.
This datasource must have been previously associated with the broker using mqsisetdbparms.
-c <secondaryDatasource>
The name of the second datasource.
If specified, the function of this datasource is compared with that of <primaryDatasource>.
This datasource must have been previously associated with the broker using mqsisetdbparms.
-v
Causes extra, untranslated, diagnostics related to supported CASTS to be output by the command.

Command options, syntax (3):
-n <primaryDatasource>
The name of the datasource to verify.
-u <primaryDatasourceUserId>
The user identifier to be used to connect to <primaryDatasource>.
-p <primaryDatasourcePassword>
The password associated with <primaryDatasourceUserId>
-c <secondaryDatasource>
The name of the second datasource.
If specified, the function of this datasource is compared with that of <primaryDatasource>.
-i <secondaryDatasourceUserId>
The user identifier to be used to connect to <secondaryDatasource>.
-a <secondaryDatasourcePassword>
The password associated with <secondaryDatasourceUserId>
-v
Causes extra, untranslated, diagnostics related to supported CASTS to be output by the command.

BIP8873
Starting the component verification for component <insert_1>.
Severity
0 : Information

BIP8874
The component verification for <insert_1> has finished successfully.
Severity
0 : Information

BIP8875
The component verification for <insert_1> has finished, but one or more checks failed.
Severity
10 : Warning
Explanation
One or more of the component verification checks failed.
Response
Check the error log for preceding error messages.

BIP8876
Starting the environment verification for component <insert_1>.
Severity
0 : Information

BIP8877
The environment verification for component <insert_1> has finished, but one or more checks failed.
Severity
10 : Warning
Explanation
One or more of the environment verification checks failed.
Response
Check the error log for preceding error messages.

BIP8878
The environment verification for component <insert_1> has finished successfully.
Severity
0 : Information

BIP8879
Starting the database verification for component <insert_1>.
Severity
0 : Information

BIP8880
The database verification for component <insert_1> has finished, but one or more checks failed.
Severity
10 : Warning
Explanation
One or more of the database verification checks failed.
Response
Check the error log for preceding error messages.

BIP8881
The database verification for component <insert_1> has finished successfully.
Severity
0 : Information

BIP8882
Starting the WebSphere MQ verification for component <insert_1>.
Severity
0 : Information

BIP8883
The WebSphere MQ verification for component <insert_1> has finished, but one or more checks failed.
Severity
10 : Warning
Explanation
One or more of the WebSphere MQ verification checks failed.
Response
Check the error log for preceding error messages.

BIP8884
The WebSphere MQ verification for component <insert_1> has finished successfully.
Severity
0 : Information

BIP8885
Verification failed. Failed to connect to queue manager <insert_1>. MQRC: <insert_2> MQCC: <insert_3>3
Severity
20 : Error
Explanation
While attempting to connect to queue manager <insert_1>, a WebSphere MQ error generated return code <insert_2> and completion code <insert_3>.
Response
Check the WebSphere MQ completion and reason codes in the Application Programming Reference section of the WebSphere MQ information center to establish the cause of the error, and take any appropriate action.

BIP8886
Verification passed for queue <insert_1> on queue manager <insert_2>.
Severity
0 : Information

BIP8887
Verification failed for queue <insert_1> on queue manager <insert_2> while issuing <insert_3>. MQRC: <insert_4> MQCC: <insert_5>5
Severity
20 : Error
Explanation
The operation <insert_3> on the specified queue returned with the indicated WebSphere MQ completion and reason codes.
Typical causes of failures during queue verification are that the queue does not exist, or that the broker is unable to put or get a message.
Response
Check the WebSphere MQ completion and reason codes in the Application Programming Reference section of the WebSphere MQ information center to establish the cause of the error, and take any appropriate action.

BIP8888
Verification failed. Failed to disconnect from queue manager <insert_1>. MQRC: <insert_2> MQCC: <insert_3>3
Severity
20 : Error
Explanation
While attempting to disconnect from queue manager <insert_1>, a WebSphere MQ error generated return code <insert_2> and completion code <insert_3>.
Response
Check the WebSphere MQ completion and reason codes in the Application Programming Reference section of the WebSphere MQ information center to establish the cause of the error, and take any appropriate action.

BIP8889
Verification failed for table <insert_1> in broker datasource <insert_2>. Preceding messages contain further information.
Severity
20 : Error
Explanation
An operation on table <insert_1> in datasource <insert_2> has failed.
Response
See preceding messages, for example BIP2322, for further information about the cause of this failure and the actions that you can take to resolve it.

BIP8890
Verification passed for table <insert_1> in datasource <insert_2>.
Severity
0 : Information

BIP8891
Verification failed. Failed to connect to datasource <insert_1> with user ID <insert_2>. Preceding messages contain further information.
Severity
20 : Error
Explanation
While attempting to connect to datasource <insert_1> with user ID <insert_2>, an error occurred.
Typical causes of this error are incorrect user ID or password, or incorrect user ID permissions.
On z/OS, the user ID is blank because SQLConnect is performed by using the primary authorization ID, which resolves to the user ID of the started task.
Response
See preceding messages for further information about the cause of this failure, and the actions that you can take to resolve it.

BIP8892
Verification failed. The installed Java level <insert_1> does not meet the required Java level <insert_2>.
Severity
20 : Error
Explanation
The installed level of Java does not match the required level of Java.
Response
On z/OS, install the correct level of Java, and correct the component profile BIPBPROF or BIPCPROF. Submit BIPGEN to create the component's ENVFILE.
On distributed platforms, you must use the JVM that is supplied and installed with the broker. In mqsiprofile, correct the MQSI_JREPATH and PATH environment variables, and the appropriate library path environment variables for your operating system.

BIP8893
Unable to access file <insert_1> with user ID <insert_2> due to error <insert_3>. Additional information for IBM support: <insert_4> <insert_5>.
Severity
20 : Error
Explanation
The component has encountered an error trying to access file <insert_1>.
This error is typically caused by incorrect file permissions, insufficient storage or in the case of NULL because the directory doesn't exist. This is typically found when checking the broker's home directory, which is not correctly defined.
Response
Ensure that user ID <insert_2> has the correct permissions to access file <insert_1>, and that sufficient storage exists on the file system.
If this problem persists, contact your IBM support center.

BIP8894
Verification passed for <insert_1>.
Severity
0 : Information

BIP8895
Verification failed. Environment variable <insert_1> is incorrect or missing.
Severity
20 : Error
Explanation
The component requires environment variable <insert_1>.
Response
On z/OS, correct the broker's profile BIPBPROF and submit BIPGEN to recreate the ENVFILE.
On distributed platforms, check that you have run mqsiprofile, and that the environment variable <insert_1> exists and is set to the correct value.
Preceding messages might contain further information about the cause of this failure, and the actions that you can take to resolve it.

BIP8896
Verification failed. Unable to access the registry with user ID <insert_1>. Additional information for IBM support: <insert_2> <insert_3>.
Severity
20 : Error
Explanation
The component has encountered an error trying to access the registry.
Typical causes of this failure are incorrect file permissions or insufficient storage.
On Linux, UNIX, and z/OS systems, the location of the registry is defined by the MQSI_REGISTRY environment variable.
Response
Ensure that user ID <insert_1> has the correct permissions to access the registry, and that sufficient storage exists on the file system.
If this problem persists, contact your IBM support center.

BIP8897
Verification failed. Environment variable <insert_1> does not match the component name <insert_2>.
Severity
20 : Error
Explanation
The value of the environment variable must match the component name.
Response
Correct the environment variable <insert_1> in the component profile BIPBPROF or BIPCPROF. Submit BIPGEN to create the component's ENVFILE.

BIP8898
Verification failed. Table <insert_1> in datasource <insert_2> contains no columns.
Severity
20 : Error
Explanation
Table <insert_1> does not contain the set of columns that this component requires to function correctly. The table might have been damaged, or, if you have recently migrated the component, you might not have completed all the required steps successfully.
Response
If you have recently migrated the broker, check that you have completed all migration steps, and that they were all succeessful. If you have just created this broker as a new broker, and the datasource tables were created manually by a datasource administrator, ensure that all required columns are defined.

BIP8899
Verification failed. Table <insert_1> in datasource <insert_2> contains <insert_3> rows, but must contain exactly 1 row.
Severity
20 : Error
Explanation
Table <insert_1> does not contain the correct number of rows that this component requires to function correctly. The table might have been damaged, or the DB2 installation jobs might not have completed succesfully.
Response
Check that the DB2 installation jobs have completed succesfully, correct any errors that have been reported, and retry the operation.

BIP8900
Verification passed for APF Authorization of file <insert_1>.
Severity
0 : Information

BIP8901
Table <insert_1> is not empty. This table will be dropped after a migration to the target version is performed.
Severity
10 : Warning
Response
Manually backup the table, if required, before performing the migration.

BIP8902
Table <insert_1> is empty.
Severity
0 : Information

BIP8903
Verification failed. The APF Authorization check failed for file <insert_1>.
Severity
20 : Error
Explanation
WebSphere Message Broker requires that only bipimain is APF Authorized for successful operation. File <insert_1> fails that requirement.
Response
If the file indicated in the message is bipimain, use the USS command extattr to ensure that it is APF Authorized. If the file indicated in the message is not bipimain, use the USS command extattr to ensure that it is not APF Authorized. For more information, search the information center for "APF attributes".

BIP8904
Verification failed. Failed to stat file <insert_1> with return code <insert_2> and errno <insert_3>.
Severity
20 : Error
Explanation
The component has encountered an error trying to stat file <insert_1>. Typical reasons for this error are that the file does not exist, or the file name is a symbolic link that is either not valid or results in a pathname that is longer than the maximum path length.
Response
Ensure that the file exists and is available, and that any symbolic links can be resolved in less than 1024 characters, and then retry the operation. If the file location is incorrect, ensure that MQSI_FILEPATH points to the root directory of your WebSphere Message Broker installation. If the problem persists, contact your IBM support center.

BIP8905
Changes the monitoring options of a message flow.
Severity
10 : Warning
Explanation
Syntax:
mqsichangeflowmonitoring brokerName (-e executionGroupName | -g) ([-k application] [-y library] -f messageFlow | -j) [-c control] [-m monitoringProfileName] [-i eventState -s eventSources]

Command Options:
'brokerName' name of the broker
'-e executionGroupName' execution group name
'-g' indicates all execution groups
'-k application' application name
'-y library' library name
'-f messageFlow' message flow name
'-j' indicates all message flows
'-c control' starts or stops monitoring: values allowed are 'active' or 'inactive'
'-m monitoringProfileName' specifies the name of the monitoring profile to be used
'-i eventState' changes the state of events for event sources specified by the -s option: values allowed are 'enable' or 'disable' Applicable only with options -e and -f
'-s eventSources' specifies the event sources that are to have their event state changed by the -i option. Specify the event sources as a comma-separated list, where each event source is of the form <nodeLabel>.terminal.<terminalName> or <nodeLabel>.transaction.<Start, End or Rollback>. The latter form is applicable only to input nodes. Applicable only with options -e and -f.

BIP8906
Changes the monitoring options of a message flow. Syntax : changeflowmonitoring ( ,e=ExecutionGroupLabel | ,g=yes ) ( [,k=Application] [,y=Library] ,f=MessageFlow | ,j=yes ) [ ,c=Control ] [ ,m=monitoringProfileName ] [,i=eventState,s=eventSources]
Severity
10 : Warning
Explanation
Command Options
'e' Execution Group name.
'g' indicates all Execution Groups.
'f' Message Flow name.
'k' Application name.
'y' Library name.
'j' indicates all Message Flows.
'c' starts or stops monitoring: values allowed are 'active' or 'inactive'.
'm' specifies the monitoring profile name to be used
'i' changes the state of events for event sources specified by the s option: values allowed are 'enable' or 'disable' Applicable only with options e and f
's' specifies the event sources that are to have their event state changed by the i option. Specify the event sources as a comma-separated list, where each event source is of the form <nodeLabel>.terminal.<terminalName> or <nodeLabel>.transaction.<Start, End or Rollback>. The latter form is applicable only to input nodes. Applicable only with options e and f.

BIP8907
Verification failed. Unable to verify Java level.
Severity
20 : Error
Explanation
Unable to verify the installed Java level. This error is typically caused by Java not being installed, or a file permissions error.
Response
Ensure Java has been correctly installed, by running the command java -version.
If Java has been correctly installed, see the preceding messages for further information about the cause of this failure, and the actions that you can take to resolve it.

BIP8908
Verification failed for <insert_1>. Preceding messages contain further information.
Severity
20 : Error
Response
See preceding messages for further information about the cause of this failure, and the actions that you can take to resolve it.

BIP8909
Displays monitoring settings.
Severity
10 : Warning
Explanation
Syntax:
mqsireportflowmonitoring BrokerName ( -e executionGroupName | -g ) ([-k application] [-y library] -f messageFlow | -j ) [-a | -n | -s eventSource | -x -p pathToFile]

Command Options
'brokerName' name of the broker
'-e executionGroupName' execution group name
'-g' indicates all execution groups
'-k application' application name
'-y library' library name
'-f messageFlow' message flow name
'-j' indicates all message flows.
'-a' indicates that the command should report the monitoring properties for all event sources in the message flow, whether they have been configured or not. Applicable only with options -e and -f.
'-n' indicates that the command should report the monitoring properties for all event sources in the message flow where monitoring is configured. Applicable only with options -e and -f.
'-s' indicates that the command should report the monitoring properties for the specified event sources in the message flow. The event sources should be specified as a comma-separated list, where each event source is of the form <nodeLabel>.terminal.<terminalName> or <nodeLabel>.transaction.<Start, End or Rollback>. The latter form is applicable only to input nodes. Applicable only with options -e and -f.
'-x' indicates that the command should report the monitoring properties for all configured nodes in the message flow, in XML form. Applicable only with options -e, -f and -p.
'-p' indicates the file to which the output from the -x option should be written. Its argument is the path to the file. Applicable only with options -e, -f and -x.

BIP8910
Displays monitoring settings.
Syntax: mqsireportflowmonitoring ( e=ExecutionGroupLabel | g=yes ) ([,k=Application] [,y=Library] ,f=MessageFlow | ,j=yes ) [,a=yes | ,n=yes | ,s=eventSource | ,x=yes,p=pathToFile]
Severity
10 : Warning
Explanation
Command Options
'e' Execution Group name.
'g' indicates all Execution Groups.
'k' Application name.
'y' Library name.
'f' Message Flow name.
'j' indicates all Message Flows.
'a' indicates that the command reports the monitoring properties for all nodes in the message flow, whether they have been configured or not. Applicable only with options e and f.
'n' indicates that the command reports the monitoring properties for all nodes in the message flow where monitoring is configured. Applicable only with options e and f.
's' indicates that the command reports the monitoring properties for the specified event sources in the message flow. The event sources must be specified as a comma separated list, where each event source is of the form <nodeLabel>.terminal.<terminalName> or <nodeLabel>.transaction.<Start, End or Rollback>. The latter form is applicable only to input nodes. Applicable only with options e and f.
'x' indicates that the command reports the monitoring properties for all configured nodes in the message flow, in XML form. Applicable only with options e, f, and p.
'p' indicates the file to which the output from the x option will be written. Its argument is the path to the file. Applicable only with options e, f, and x.

BIP8911
Monitoring settings for flow <insert_1> in execution group <insert_2> - State?: <insert_3>, ProfileName: <insert_4>.
Severity
0 : Information

BIP8912
Event: <insert_1>, Event name: <insert_2>, Configured?: <insert_3>, State?: <insert_4>.
Severity
0 : Information

BIP8913
Event: <insert_1> not found in message flow <insert_2>
Severity
0 : Information
Explanation
The event with the name that you specified, using the -s parameter, was not found in the message flow.

BIP8914
Changes the configuration of a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsichangebroker brokerName [[-i generalDefaultUserId] -a generalDefaultPassword] [-t | -n] [-l userLilPath] [-r userLilPath64] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-v statisticsMajorInterval] [-P httpListenerPort] [-c ICU converter path] [-y ldapPrincipal] [-z ldapCredentials] [-x userExitPath] [-b userExitPath64] [-e activeUserExits] [-o operationMode] [-s adminSecurity]


Command options:
'brokerName' the name of the broker to change.
'-i generalDefaultUserId' the default user ID that the broker will use to connect to external resources.
'-a generalDefaultPassword' the password to be used with the generalDefaultUserId.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-n' WebSphere MQ fastpath for this broker not enabled.
'-l userLilPath' indicates from where user-written 32-bit LIL and JAR files are loaded.
'-r userLilPath64' indicates from where user-written 64-bit LIL and JAR files are loaded.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c ICU converter path' delimited ':' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all 32-bit user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-b userExitPath64' the directory from which the broker searches for all 64-bit user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-e activeUserExits' the active user exits. By default, user exits are inactive. Adding a user exit name to this list changes its default state to active for this broker. The default state can be overridden at the execution group or message flow level using the mqsichangeflowuserexits command. If a user exit name is specified and no library is found to provide that user exit when the execution group starts, a BIP8860 message is written to the system log and the execution group fails to start. The separator character for the list is ':'.
'-o operationMode' the broker operation mode. Valid values are 'express', 'standard', 'adapter', and 'advanced'.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'.

BIP8915
Creates a broker.
Severity
10 : Warning
Explanation
Syntax:
mqsicreatebroker. brokerName -q queueManagerName [-i generalDefaultUserId -a generalDefaultPassword] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-w workPath] [-l userLilPath] [-r userLilPath64] [-t] [-m] [-v statisticsMajorInterval] [-P httpListenerPort] [-c icuConverterPath] [-y ldapPrincipal -z ldapCredentials] [-x userExitPath] [-b userExitPath64] [-o operationMode] [-s adminSecurity]


Command Options:
'brokerName' the name of the broker.
'-q queueManagerName' the WebSphere MQ queue manager that the broker will use. The queue manager is created if it does not exist.
'-i generalDefaultUserId' the default user ID that the broker will use to connect to external resources.
'-a generalDefaultPassword' the password to be used with the generalDefaultUserId.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-w workPath' the directory in which trace logs are written.
'-l userLilPath' the directory from which the broker searches for user-supplied 32-bit libraries.
'-r userLilPath64' the directory from which the broker searches for user-supplied 64-bit libraries.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-m' indicates that migration is required from an WebSphere publish/subscribe broker.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c icuConverterPath' delimited ':' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all 32-bit user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-b userExitPath64' the directory from which the broker searches for all 64-bit user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-o operationMode' the broker operation mode. Valid values that you can set are 'express', 'standard', 'adapter', and 'advanced'. The default mode is 'advanced' unless you have the Trial Edition, in which case the default mode is 'trial'.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'. The default is 'inactive'.

BIP8916
Update monitoring profile configurable service <insert_1> to change monitoring properties for flow <insert_2>
Severity
0 : Information
Explanation
Message flow <insert_2> uses monitoring profile configurable service <insert_1> to set its monitoring properties. You cannot use the mqsichangeflowmonitoring command to update a configurable service.
Response
Use the mqsichangeproperties command to update the monitoring profile configurable service.

BIP8917
Event: <insert_1> not found in monitoring profile configurable service <insert_2>
Severity
0 : Information
Explanation
The event was specified in the -s parameter but no event with that name was found in the monitoring profile configurable service.
Response
Correct the name and then reissue the command.

BIP8918
The monitoring profile configurable service has not been updated
Severity
0 : Information
Explanation
The errors reported for this command have prevented the monitoring profile configurable service being updated.
Response
Correct and then reissue the command.

BIP8919
mqsireportproperties did not find any configured event sources. If this is not expected it could be because your profile failed to load correctly. Check for errors and correct if necessary.
Severity
10 : Warning
Explanation
mqsireportflowmonitoring did not find any configured event sources. The monitoring properties were loaded from a configurable service monitoring profile, which might contain errors.
Response
Check the monitoring profile source and messages and correct the profile as necessary.

BIP8920
Creates a broker.
Severity
10 : Warning
Explanation
Syntax (for Microsoft Windows platforms):
mqsicreatebroker. brokerName -i serviceUserId -a servicePassword -q queueManagerName [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-w workPath] [-e sharedWorkpath] [-l userLilPath] [-t] [-m] [-v statisticsMajorInterval] [-P httpListenerPort] [-c icuConverterPath] [-y ldapPrincipal -z ldapCredentials] [-x userExitPath] [-o operationMode] [-s adminSecurity] [-d MQService] [-b cachePolicy] [-r cachePortRange]


Command Options:
'brokerName' the name of the broker.
'-i serviceUserId' the user ID that the broker runs under and that by default is used to connect to external resources, or the special value 'LocalSystem'.
'-a servicePassword' the password for the broker user ID. If 'LocalSystem' was specified for the user ID, the password value is ignored.
'-q queueManagerName' the WebSphere MQ queue manager that the broker will use. The queue manager is created if it does not exist.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-w workPath' the directory in which trace logs are written.
'-e sharedWorkPath' the directory in which registry and configuration data is shared between multiple instances of this broker.
'-l userLilPath' the directory from which the broker searches for user-supplied libraries.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-m' indicates that migration is required from an WebSphere publish/subscribe broker.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c icuConverterPath' delimited ';' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-o operationMode' the broker operation mode. Valid values that you can set are 'express', 'standard', 'scale', 'adapter' and 'advanced'. The default mode is 'advanced' unless you have the Developer Edition or Trial Edition, in which case the default mode is 'developer' or 'trial' respectively.
'-s adminSecurity' activates broker administration security. Valid values that you can set are 'active' and 'inactive'. The default is 'inactive'.
'-d MQService' start the broker as a WebSphere MQ Service when the queue manager starts. Valid values that you can set are 'defined' and 'undefined'. The default is 'undefined'.
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.
'-B brokerDomainGroup' the Windows Domain Group that is used to secure files in the sharedWorkPath of a multi instance broker. Only used in conjunction with -e.
'-Q queueManagerDomainGroup' the Windows Domain Group that is used to secure the WebSphere MQ Queue Manager files in the sharedWorkPath of a multi instance broker. Only used in conjunction with -e and if the queue manager does not exist and is to be created.

BIP8921
Changes the configuration of a broker.
Severity
10 : Warning
Explanation
Syntax (for Microsoft Windows platforms):
mqsichangebroker brokerName [[-i serviceUserId] -a servicePassword] [-t | -n] [-l userLilPath] [-g configurationChangeTimeout] [-k internalConfigurationTimeout] [-v statisticsMajorInterval] [-P httpListenerPort] [-c ICU converter path] [-y ldapPrincipal] [-z ldapCredentials] [-x userExitPath] [-e activeUserExits] [-s adminSecurity] [-d MQService] [-f function level] [-b cachePolicy] [-r cachePortRange]


Command options:
'brokerName' the name of the broker to change.
'-i serviceUserId' the user ID that the broker runs under and, by default, will be used to connect to external resources.
'-a servicePassword' the password for the broker user ID.
'-t' enables WebSphere MQ fastpath for this broker (not supported on all platforms).
'-n' disables WebSphere MQ fastpath for this broker.
'-l userLilPath' indicates where user-written LIL and JAR files are loaded from.
'-g configurationChangeTimeout' the maximum time (in seconds) allowed for a user configuration request to be processed.
'-k internalConfigurationTimeout' the maximum time (in seconds) allowed for an internal configuration change to be processed.
'-v statisticsMajorInterval' the time (in minutes) for the duration of the interval for collecting statistics archive records.
'-P httpListenerPort' the port that the broker's HTTP listener uses.
'-c ICU converter path' delimited ';' list of paths to search for ICU converters or converter packages.
'-y ldapPrincipal' the LDAP Principal (user ID).
'-z ldapCredentials' the LDAP Credentials (password).
'-x userExitPath' the directory from which the broker searches for all user exits. This path is added to the system library search path (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) for the execution group process only.
'-e activeUserExits' the active user exits. By default, user exits are inactive. Adding a user exit name to this list changes its default state to active for this broker. The default state can be overridden at the execution group or message flow level using the mqsichangeflowuserexits command. If a user exit name is specified and no library is found to provide that user exit when the execution group starts, a BIP8860 message is written to the system log and the execution group fails to start. The separator character for the list is ':'.
'-s adminSecurity' activates broker administration security. Valid values that can be set are 'active' and 'inactive'.
'-d MQService' activates a WebSphere MQ Service for a multi-instance broker. Valid values that can be set are 'defined' and 'undefined'. The default is 'undefined'.
'-f function level' the effective function level of the broker, such as '7.0.0.1', '7.0.0.2', or 'all'
'-b cachePolicy' selects a policy to use for the cache manager. Built-in values that you can set are 'default', 'disabled' and 'none'. Alternatively, specify the absolute path to a cache policy file. The default value is 'disabled'.
'-r cachePortRange' selects a range of ports to be used by the cache manager. The value must be of the form 'startport-endport'. A valid range is generated by default.

BIP8922
Event source address <insert_1> was not found or is not configured.
Severity
20 : Error
Explanation
The event source address was specified in the -s parameter of the mqsichangeflowmonitoring command, but the event source was not found or is not configured.
Response
Issue the mqsireportflowmonitoring command with the -n and -a options to see details of event sources in the flow. Take corrective action and then reissue the mqsichangeflowmonitoring command.

BIP8923
The monitoring properties for the deployed message flow have not been updated.
Severity
20 : Error
Explanation
The deployed message flow cannot be updated because of errors that have already been reported.
Response
Correct the errors and then reissue the command.

BIP8924
The mqsireportbroker command displays broker registry entries.
Severity
10 : Warning
Explanation
Syntax:
mqsireportbroker BrokerName


Command Options:
'BrokerName' the name of the broker.

BIP8926
Broker Name <insert_1>
Severity
0 : Information
Explanation
Install path = <insert_2>
Work path = <insert_3>
Broker UUID = <insert_4>
Process id = <insert_5>
Queue Manager = <insert_6>
User lil path = <insert_7>
User lil path64 = <insert_8>
User exit path = <insert_9>
User exit path64 = <insert_10>
Active user exits = <insert_11>
LDAP principal = <insert_12>
LDAP credentials = <insert_13>
ICU converter path = <insert_14>
Trusted (fastpath) Queue Manager application = <insert_15>
Configuration change timeout = <insert_16> seconds
Internal configuration timeout = <insert_17> seconds
Statistics major interval = <insert_18> minutes
Operation mode = <insert_19>
Fixpack capability level = <insert_20> (effective level <insert_21>)
Broker registry format = <insert_22>
Administration security = <insert_23>

BIP8927
Broker Name <insert_1>
Severity
0 : Information
Explanation
Last mqsistart path = <insert_28>
mqsiprofile install path = <insert_2>
Work path = <insert_3>
Broker UUID = <insert_4>
Process id = <insert_5>
Queue Manager = <insert_6>
User lil path = <insert_7>
User exit path = <insert_8>
Active user exits = <insert_9>
LDAP principal = <insert_10>
LDAP credentials = <insert_11>
ICU converter path = <insert_12>
Trusted (fastpath) Queue Manager application = <insert_13>
Configuration change timeout = <insert_14> seconds
Internal configuration timeout = <insert_15> seconds
Statistics major interval = <insert_16> minutes
Operation mode = <insert_17>
Fixpack capability level = <insert_18> (effective level <insert_19>)
Broker registry format = <insert_20>
Administration security = <insert_21>
Multi-instance Broker = <insert_22>
Shared Work Path = <insert_23>
Start as WebSphere MQ Service = <insert_24>
HTTP listener port = <insert_25>
Cache manager policy = <insert_26>
Cache manager port range = <insert_27>

BIP8928
Broker Name <insert_1>
Severity
0 : Information
Explanation
Last mqsistart path = <insert_25>
mqsiprofile install path = <insert_2>
Work path = <insert_3>
Broker UUID = <insert_4>
Process id = <insert_5>
Queue Manager = <insert_6>
User lil path = <insert_7>
User lil path64 = <insert_8>
User exit path = <insert_9>
User exit path64 = <insert_10>
Active user exits = <insert_11>
LDAP principal = <insert_12>
LDAP credentials = <insert_13>
ICU converter path = <insert_14>
Configuration change timeout = <insert_15> seconds
Internal configuration timeout = <insert_16> seconds
Statistics major interval = <insert_17> minutes
Fixpack capability level = <insert_18> (effective level <insert_19>)
Broker registry format = <insert_20>
Administration security = <insert_21>
HTTP listener port = <insert_22>
Cache manager policy = <insert_23>
Cache manager port range = <insert_24>

BIP8929
Broker Name <insert_1>
Severity
0 : Information
Explanation
IBM Support override trace = <insert_2>
IBM Support override trace size = <insert_3> bytes
IBM Support override execution group trace = <insert_4>
IBM Support override execution group trace size = <insert_5> bytes
IBM Support override execution group trace label = <insert_7>
IBM Support override execution group user trace level = <insert_6>

BIP8934
Verification failed. The installed Java level is 31-bit.
Severity
20 : Error
Explanation
The level of Java installed does not meet the minimum requirement; a 64-bit Java assembly is necessary.
Response
On z/OS, install the correct level of Java, and correct the BIPBPROF component profile. Submit BIPGEN to create the ENVFILE for the broker.
On all other platforms, you must use the Java Virtual Machine that is supplied and installed with the broker. In the mqsiprofile command, correct the MQSI_JREPATH and PATH environment variables, and the appropriate library path environment variables for your operating system.

BIP8935
Adds a broker instance.
Severity
10 : Warning
Explanation
Syntax (for Linux and UNIX platforms):
&mqsiaddbrokerinstance. brokerName [-w workPath] -e sharedWorkPath


Command Options:
'brokerName' the name of the multi-instance broker.
'-w workPath' the directory in which trace logs are written.
'-e sharedWorkPath' the directory in which registry and configuration data is shared between multiple instances of this broker.

BIP8936
Adds a broker instance.
Severity
10 : Warning
Explanation
Syntax (for Microsoft Windows platforms):
&mqsiaddbrokerinstance. brokerName -i serviceUserId -a servicePassword [-w workPath] -e sharedWorkPath


Command Options:
'brokerName' the name of the multi-instance broker.
'-i serviceUserId' the user ID that the broker runs under and that by default will be use to connect to external resources.
'-a servicePassword' the password for the broker user ID.
'-w workPath' the directory in which trace logs are written.
'-e sharedWorkPath' the directory in which registry and configuration data is shared between multiple instances of this broker.

BIP8937
Removes a broker instance.
Severity
10 : Warning
Explanation
Syntax:
&mqsiremovebrokerinstance. brokerName


Command Options:
'brokerName' the name of the multi-instance broker.

BIP8938
Changes a broker's resource statistics options.
Severity
10 : Warning
Explanation
Syntax:
mqsichangeresourcestats brokerSpec [-e executionGroupName] -c control [-w timeoutSecs] [-v traceFileName]
'brokerSpec' is one of:
(a) 'brokerName' : Name of a locally defined broker
(b) '-n brokerFileName' : File containing remote broker connection parameters (*.broker)
(c) '-i ipAddress -p port -q qMgr' : hostname, port and queue manager of a remote broker

Command Options:
'-e executionGroupName' execution group name. If not specified, the command acts upon all execution groups.
'-c control' starts or stops collection: values allowed are 'active' or 'inactive'.
'-w timeoutSecs' maximum number of seconds to wait for the broker to respond (default is 60)
'-v traceFileName' send verbose internal trace to the specified file.

BIP8939
Displays statistics settings.
Severity
10 : Warning
Explanation
Syntax:
mqsireportresourcestats brokerSpec [-e executionGroupName] [-d detailLevel] [-w timeoutSecs] [-v traceFileName]

Command Options
'brokerSpec' is one of:
(a) 'brokerName' : Name of a locally defined broker
(b) '-n brokerFileName' : File containing remote broker connection parameters (*.broker)
(c) '-i ipAddress -p port -q qMgr' : hostname, port and queue manager of a remote broker
'-e executionGroupName' execution group name. If not specified, the command acts upon all execution groups.
'-d detailLevel' control how much information to display. Valid values are:
0 = display combined information (identical to previous versions of mqsireportresourcestats)
1 = display summary of configurable settings per execution group (default)
2 = display detailed information including non-configurable settings
'-w timeoutSecs' maximum number of seconds to wait for the broker to respond (default is 60)
'-v traceFileName' send verbose internal trace to the specified file.

BIP8940
Statistics collection for resource type <insert_1> in execution group <insert_2> is <insert_3>. Measurements: <insert_4>.
Severity
0 : Information

BIP8941
Statistics collection for resource type <insert_1> in execution group <insert_2> is <insert_3>.
Severity
0 : Information

BIP8942
Statistics resource measurements for <insert_1>: <insert_2>.
Severity
0 : Information

BIP8943
The -m flag was specified, but the original broker was not created with the -w "workPath" option. Remove the -m flag and run the command again.
Severity
10 : Warning
Explanation
The -m flag is not allowed in this scenario.
Response
Remove the -m flag and run the command again.

BIP8944
Service trace is enabled for the broker agent and HTTPListener - level: <insert_1>, mode: <insert_2>, size: <insert_3> KB.
Severity
0 : Information

BIP8945
Service trace settings for execution group <insert_1> - mode: <insert_2>, size: <insert_3> KB
Severity
0 : Information

BIP8946
Service trace is enabled for execution group <insert_1> with level <insert_2>.
Severity
0 : Information

BIP8947
Service trace is enabled for message flow <insert_1> with level <insert_2>.
Severity
0 : Information

BIP8948
User trace settings for execution group <insert_1> - mode: <insert_2>, size: <insert_3> KB
Severity
0 : Information

BIP8949
User trace is enabled for execution group <insert_1> with level <insert_2>.
Severity
0 : Information

BIP8950
User trace is enabled for message flow <insert_1> with level <insert_2>.
Severity
0 : Information

BIP8951
The following environment variable is set, which might affect current trace settings for the broker - <insert_1> = <insert_2>.
Severity
0 : Information

BIP8952
Service trace is not enabled for broker <insert_1>.
Severity
0 : Information

BIP8953
User trace is not enabled for broker <insert_1>.
Severity
0 : Information

BIP8954
Service trace is enabled for the HTTPListener - level: <insert_1>, size: <insert_2>.
Severity
0 : Information

BIP8960
Installs, uninstalls or lists Assemblies in Global Assembly Cache (GAC)
Severity
10 : Warning
Explanation
Syntax (1):
mqsiAssemblyInstall -i AssemblyName
Syntax (2):
mqsiAssemblyInstall -u AssemblyName
Syntax (3):
mqsiAssemblyInstall -l AssemblyName

Command Options:
'-i' installs an Assembly into the GAC
'-u' uninstalls an Assembly from the GAC
'-l' lists Assemblies that are installed in the GAC

BIP8961
The full .NET 4 framework in not installed or is not installed correctly.
Severity
30 : Severe error
Explanation
The full .NET 4 framework must be installed correctly before this command can be run.

BIP8962
The installation of the assembly into the Global Assembly Cache failed.
Severity
30 : Severe error
Explanation
The assembly could not be installed into the Global Assembly Cache.

BIP8963
The assembly could not be uninstalled from the the Global Assembly Cache.
Severity
30 : Severe error
Explanation
The uninstallation of the assembly from the Global Assembly Cache failed.

BIP8964
The listing of the assembly in the Global Assembly Cache failed.
Severity
30 : Severe error
Explanation
The assembly in the Global Assembly Cache failed could not be listed.

BIP8965
Use the mqsiwebuseradmin command to administer user accounts for the web user and RESTful interfaces.
Severity
10 : Warning
Explanation
Syntax:
mqsiwebuseradmin brokerSpec [-c | -m | -d | -l] [-u username] [-a password] [-r role] [-w timeout] [-v traceFileName]

Command options:
'brokerSpec' must have one of the following values:
'brokerName' : Name of a locally defined broker
'-n brokerFileName' : File containing connection parameters for a remote broker (*.broker)
'-i ipAddress -p port -q qMgr' : hostname, port, and queue manager of a remote broker

Also specify one of the following values:
'-c' : create web user account
'-m' : modify web user account
'-d' : delete web user account
'-l' : list web users

Specify the following options if required:
'-u username' : username to create/modify/delete
'-a password' : password for create/modify
'-r role' : role for create/modify
'-w timeoutSecs' : maximum number of seconds to wait for the broker to respond (default is 60)
'-v traceFileName' : send verbose internal trace to the specified file.

BIP8966
Use the mqsifindmqpath command to find the path for a Websphere MQ install.
Severity
10 : Warning
Explanation
Syntax:
mqsifindmqpath brokerName

Command options:

'brokerName' : Name of the broker to source the WebSphere MQ path for. Ommit to find the latest available install on the machine.

BIP8967
Failed to create the queue manager <insert_1> because the Websphere MQ environment has not been set up.
Severity
20 : Error
Explanation
The Websphere MQ environment must be set up for the command mqsicreatebroker to be able to create a queue manager. Run the setmqenv command from the install of the version of Websphere MQ you want to use to create the queue manager.

BIP8970
Starting WebSphere MQ service migration for component <insert_1>.
Severity
0 : Information
Explanation
The component is defined to run as a WebSphere MQ service. The WebSphere MQ service definition is being migrated for component <insert_1>.
Response
None.

BIP8971
Finished WebSphere MQ service migration for component <insert_1>.
Severity
0 : Information
Explanation
The WebSphere MQ service definition has been successfully migrated for component <insert_1>.
Response
None.

BIP8972
Removing the WebSphere MQ service definition for component <insert_1>.
Severity
0 : Information
Explanation
The broker has been defined to run as a WebSphere MQ service but it is not possible to migrate the WebSphere MQ service definition to an earlier version. The definition will be removed, but you can redefine the broker to run as a WebSphere MQ service using the mqsichangebroker command.
Response
To modify the migrated broker to start as a WebSphere MQ service, use the mqsichangebroker command with the -d parameter. For example, 'mqsichangebroker MyBroker -d defined'.

BIP8973
Finished removing the WebSphere MQ service definition for component <insert_1>. Use the mqsichangebroker command after migration to redefine the broker to run as a WebSphere MQ service.
Severity
0 : Information
Explanation
The broker has been defined to run as a WebSphere MQ service but it is not possible to migrate the WebSphere MQ service definition to an earlier version. The definition has been removed, but you can redefine the broker to run as a WebSphere MQ service using the mqsichangebroker command.
Response
To modify the migrated broker to start as a WebSphere MQ service, use the mqsichangebroker command with the -d parameter. For example, 'mqsichangebroker MyBroker -d defined'.

BIP8980
Fix ID: <insert_1>1
Severity
0 : Information

BIP8981
This command creates an object associated with a type of configurable service.
Severity
10 : Warning
Explanation
Syntax:
mqsicreateconfigurableservice brokerName -c configurableService -o object ( -n name -v value )
Command options:
'brokerName': name of the broker
'-c configurableService': configurable service type used by the broker
'-o object': object name belonging to the configurable service type
'-n name': attribute name
'-v value': attribute value

BIP8982
This command deletes an object name associated with a type of external resource that was previously created using the mqsicreateconfigurableservice command.
Severity
10 : Warning
Explanation
Syntax:
mqsideleteconfigurableservice brokerName -c configurableService -o object
Command options:
'brokerName': name of the broker
'-c configurableService': a type of configurable service used by the broker
'-o object': object name belonging to the type of configurable service

BIP8983
Configurable service object name <insert_1> already exists.
Severity
10 : Warning
Explanation
The user has tried to create a configurable service object name that already exists.
Response
Check the names of the existing configurable services using the mqsireportproperties command. Then modify the external resource object name and reissue the command.

BIP8984
Configurable service object name <insert_1> was not found.
Severity
10 : Warning
Explanation
The user has tried to delete or modify a configurable service object name that does not exist, or is not valid for UserDefined types.
Response
Check the names of the existing configurable services using the mqsireportproperties command. Then modify the external resource object name and reissue the command.

BIP8985
The broker cannot detect the PSMODE for WebSphere MQ queue manager <insert_1>. Return code: <insert_2>.
Severity
0 : Information
Explanation
A failure occurred when the broker queried the Publish Subscribe Mode for WebSphere MQ queue manager <insert_1>.
Response
Ensure that the queue manager is running. Review any other errors that are reported to identify the cause of the problem, then retry the operation.

BIP8986
A failure occurred when the broker tried to update the PSMODE for WebSphere MQ queue manager <insert_1>. Return code: <insert_2>.
Severity
0 : Information
Explanation
The Publish Subscribe Interface (PSMODE) within WebSphere MQ for queue manager <insert_1> is currently set to ENABLED. This setting is incompatible with WebSphere Message Broker in its default configuration. The broker tried to change the PSMODE to COMPATIBILITY but the request failed.
Response
Ensure that the WebSphere MQ command server is running and is able to process PCF requests.

BIP8987
The command server for WebSphere MQ queue manager <insert_1> is not running. Return code: <insert_2>.
Severity
0 : Information
Explanation
The WebSphere MQ command server must be running on the queue manager that hosts a broker. It is currently disabled.
Response
Check the status of the command server and start it if necessary.

BIP8988
The broker cannot detect the version of WebSphere MQ that is installed for queue manager <insert_1>. Return code: <insert_2>.
Severity
0 : Information
Explanation
A failure occurred when the broker queried the version of WebSphere MQ. The queue manager name that hosts the broker is <insert_1>.
Response
Ensure that the queue manager is running. Review any other errors that are reported to identify the cause of the problem, then retry the operation.

BIP8989
The command completed with warnings.
Severity
0 : Information
Explanation
The command completed successfully but generated warnings.
Response
Check the warning messages previously issued by this command.

BIP8990
The broker has detected that the version of WebSphere MQ that is installed for queue manager <insert_1> is not supported.
Severity
20 : Error
Explanation
The broker will not function using queue manager <insert_1> because it is using a version of WebSphere MQ that is not one of the supported versions.
Response
Check the product documentation for supported versions of WebSphere MQ, and compare this against the version of WebSphere MQ that is installed for queue manager <insert_1>. Migrate the WebSphere MQ queue manager to a supported version.

BIP8991
The broker has detected that the PSMODE for WebSphere MQ queue manager <insert_1> is set to DISABLED. The PSMODE will be updated to COMPAT.
Severity
10 : Warning
Explanation
The Publish Subscribe Interface (PSMODE) within WebSphere MQ for the specified queue manager is currently set to DISABLED. This setting is incompatible with WebSphere Message Broker. The broker will change the PSMODE to COMPAT.
Response
If this message occurs more than once, identify what is causing the PSMODE to be set to DISABLED and correct the problem.

BIP8992
A failure occurred when the broker tried to update the PSMODE for WebSphere MQ queue manager <insert_1>. Return code: <insert_2>.
Severity
20 : Error
Explanation
The Publish Subscribe Interface (PSMODE) within WebSphere MQ for the specified queue manager is currently set to DISABLED. This setting is incompatible with WebSphere Message Broker. The broker tried to change the PSMODE to COMPAT but the request failed.
Response
Ensure that the WebSphere MQ command server is running and is able to process PCF requests.

BIP8993
A component integrity check has failed.
Severity
20 : Error
Explanation
The command ran an integrity check on the component's configuration, and found errors. Previous messages indicate the errors found.
Response
Examine previous messages to determine the cause of the failure. Correct the errors, and rerun the command.

BIP8994
Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.
Severity
20 : Error
Response
Run the mqsicommandconsole command to get an elevated administrator command prompt, from which you can run this command.

BIP8996
Version: <insert_1>1
Severity
0 : Information

BIP8997
Product: <insert_1>1
Severity
0 : Information

BIP8998
CMVC Level: <insert_1>1
Severity
0 : Information

BIP8999
Build Type: <insert_1>, <insert_2> bit, <insert_3>3
Severity
0 : Information