Resolving problems that occur during deployment of message flows
Use the advice given here to help you to resolve problems that can arise during deployment of message flows or message sets.
Procedure
- You receive a warning message about the mode of your integration node
- The message flow deploys on the test system, but not elsewhere
- Error messages about your integration node mode are issued when you create an integration server
- Error messages about your integration node mode are issued when you deploy
- Error messages about your function level are issued when you deploy
- Error messages are issued when you deploy to z/OS
- Expected serialization of input is not occurring for a shared queue that serves multiple instances of a message flow on z/OS
- You create a configurable service, then deploy a message flow and inbound adapter, but the deployment fails
- You have created a WebSphere Adapters message flow that uses secondary adapters, and a naming clash has occurred in the secondary adapters or message sets
- You get an authority check failure when you deploy to z/OS
- Deployment fails when you have circular project dependencies
- Error messages are issued when you deploy
You receive a warning message about the mode of your integration node
About this task
Message BIP1806
- Scenario: Warning message BIP1806 is displayed.
- Explanation: Your integration node timed out before the command completed. You can set the timeout value on the -w parameter of the mqsimode command, or accept the default value of 60 seconds; see mqsimode command.
- Solution: Check that the integration node is started: if it is not started, start it by using the mqsistart command. If it is started, increase the timeout value and run the command again.
Message BIP1808
- Scenario: Warning message BIP1808 is displayed.
- Explanation: Your integration node is running in a previous version of the product. You must migrate integration node that you created in a version earlier than V6.1.0.2 before you can change the operation mode.
- Solution: Upgrade your integration node to at least V6.1.0.2, and run the command again.
Message BIP1821
- Scenario: Warning message BIP1821 is displayed.
- Explanation: Your integration node is running in a mode that restricts the number of integration servers that you can use; see Restrictions that apply in each operation mode.
- Solution: Contact your IBM® representative to upgrade your license, or remove the required number of integration servers; see Deleting an integration server.
Message BIP1822
- Scenario: Warning message BIP1822 is displayed.
- Explanation: Your integration node is running in a mode that restricts the number of message flows that you can use; see Restrictions that apply in each operation mode.
- Solution: Contact your IBM representative to upgrade your license, or delete the required number of message flows; see Deleting a message flow or subflow.
Message BIP1823
- Scenario: Warning message BIP1823 is displayed.
- Explanation: Your integration node is running in a mode that restricts the types of node that you can use in a message flow; see Restrictions that apply in each operation mode.
- Solution: Contact your IBM representative to upgrade your license, rework your message flow to use nodes that are valid in the current mode, or remove the message flows that contain unsupported nodes; see Deleting a message flow or subflow.
Message BIP1824
- Scenario: Warning message BIP1824 is displayed.
- Explanation: Your integration node is running in the Trial Edition mode and your trial period of 90 days has expired; see Restrictions that apply in each operation mode.
- Solution: Contact your IBM representative to upgrade your license.
The message flow deploys on the test system, but not elsewhere
Procedure
Error messages about your integration node mode are issued when you create an integration server
About this task
Message BIP1825
- Scenario: Error message BIP1825 is displayed.
- Explanation: The integration server cannot be created because the maximum number of integration servers for the mode of the target integration node has been reached, and creating the integration server causes this limit to be exceeded; see Restrictions that apply in each operation mode. The integration server was not created.
- Solution: Reuse an existing integration server, or delete an existing integration server and try the command again; see Deleting an integration server. Alternatively, contact your IBM representative to upgrade your license.
Error messages about your integration node mode are issued when you deploy
About this task
Message BIP1826
- Scenario: Error message BIP1826 is displayed.
- Explanation: The BAR file cannot be deployed because it causes the integration node to run more message flows than are valid for the current mode of operation of the target integration node; see Restrictions that apply in each operation mode. The BAR file was not deployed.
- Solution: Delete message flows from the integration node and try the command again; see Deleting a message flow or subflow. Alternatively, contact your IBM representative to upgrade your license.
Message BIP1827
- Scenario: Error message BIP1827 is displayed.
- Explanation: The BAR file cannot be deployed because it contains nodes that are not valid for the current mode of the target broker; see Restrictions that apply in each operation mode. The BAR file was not deployed.
- Solution: Rework your message flow to use nodes that are valid in the current mode, or remove the message flows that contain unsupported nodes; see Deleting a message flow or subflow. Alternatively, contact your IBM representative to upgrade your license.
Message BIP1828
- Scenario: Error message BIP1828 is displayed.
- Explanation: The target integration node is running in a trial mode that has expired; see Restrictions that apply in each operation mode. The BAR file was not deployed.
- Solution: Contact your IBM representative to upgrade your license. If you have already purchased a valid license for the target integration node, change the integration node to the correct mode by using the mqsimode command; see mqsimode command.
Message BIP1829
- Scenario: Error message BIP1829 is displayed.
- Explanation: The BAR file cannot be deployed because the maximum number of integration servers for the mode of the target integration node has been reached; see Restrictions that apply in each operation mode. The BAR file was not deployed.
- Solution: Delete an existing integration server and try the command again; see Deleting an integration server. Alternatively, contact your IBM representative to upgrade your license.
Error messages about your function level are issued when you deploy
About this task
Message BIP2276
- Scenario: Error message BIP2276 is displayed.
- Explanation: The integration node received an instruction
to create a message flow node of type Node_type in
message flow Message_flow. The integration node
cannot create nodes of this type because the new functions have not
been enabled for this integration node. Use the following command
to enable this function, and all other functions:
mqsichangebroker IBNODE -f all
- Solution: Either change the flow to avoid using the unavailable node, or enable the new functions by using the mqsichangebroker command; see mqsichangebroker command.
Error messages are issued when you deploy to z/OS
Procedure
Expected serialization of input is not occurring for a shared queue that serves multiple instances of a message flow on z/OS
Procedure
You create a configurable service, then deploy a message flow and inbound adapter, but the deployment fails
Procedure
- Scenario: You create a configurable service, then deploy a message flow and inbound adapter, but the deployment fails.
- Explanation: When you create a configurable service for an adapter that has not yet been deployed, the connection properties are not fully validated until you deploy the adapter and the message flow that uses that adapter. Therefore, the properties that you set on the configurable service might be invalid.
- Solution: Inspect the error message that is returned from the deployment and determine whether the deployment failed because of invalid connection properties on the configurable service. If so, use the mqsichangeproperties command to correct the properties, or use the mqsideleteconfigurableservice command to use the properties that are set on the adapter. Restart the integration node and redeploy the message flow.
You have created a WebSphere Adapters message flow that uses secondary adapters, and a naming clash has occurred in the secondary adapters or message sets
Procedure
You get an authority check failure when you deploy to z/OS
Procedure
Deployment fails when you have circular project dependencies
Procedure
Error messages are issued when you deploy
About this task
Additional error messages that might be generated during a deployment are explained in this section.
Message BIP1106 with WebSphere MQ reason code 2030
- Scenario: Error message BIP1106 is issued with reason code 2030 when you are deploying a large message set.
- Explanation: The size of the message exceeds the maximum message length of the transmission queue to the integration node queue manager.
- Solution: Increase the maximum message length for the transmission
queue using the WebSphere MQ alter
qlocal command, where the maximum message length (maxmsgl)
is in bytes:
For more information about this command, see the System Administration Guide section of the WebSphere MQ Version 7.5 product documentation online.alter ql(transmit_queue_name) maxmsgl(104857600)
Message BIP2066
- Scenario: You have initiated a deployment request; for example, you have deployed a BAR file to an integration server. Error message BIP2066 is returned one or more times.
- Explanation: The deployment request was not acknowledged by the integration server before the sum of the values for the integration node timeout parameters ConfigurationChangeTimeout and InternalConfigurationTimeout expired.
- Solution: Increase these timeout values by specifying the -g and -k parameters of the mqsicreatebroker or mqsichangebroker command. See Setting configuration timeout values for information about factors that affect timeout values, and how to set appropriate values.
Message BIP2080
- Scenario: The integration node has started an integration server; for example, if you have issued mqsistart for the integration node, or an error has occurred and the integration server is being recovered. Error message BIP2080 is displayed one or more times.
- Explanation: The internal configuration request was not acknowledged by the integration server before the value of the InternalConfigurationTimeout (default 60 seconds) expired.
- Solution: Change the configuration timeout by specifying the -k parameter of the mqsicreatebroker or mqsichangebroker command. See Setting configuration timeout values for information about factors that affect timeout values, and how to set appropriate values.
Message BIP2241
- Scenario: Error message BIP2241 is displayed.
- Explanation: You are attempting to deploy a message flow containing a node that is not available on the target integration node.
- Solution: Ensure that the version of the IBM Integration Toolkit in which the message flow has been developed matches the version of the integration node to which the message flow is being deployed. If the message flow is using a user-defined node, or a node supplied in a SupportPac, ensure that the runtime node implementation has been correctly installed on the computer on which the integration node is running. If your message flow includes a user-defined node, see Installing user-defined extension runtime files on an integration node. If your message flow includes a node provided in a SupportPac, see the installation information, if supplied, for the SupportPac.
Message BIP2242
- Scenario: Error message BIP2242 is displayed.
- Explanation: The deployment request (configuration change) was not accepted before the timeout value set by the integration node parameter ConfigurationChangeTimeout expired. This configuration timeout value must be long enough for the message flow to complete processing its current message, then accept the deploy request; the default is 300 seconds.
- Solution: Set the configuration timeout values by specifying the -g and -k parameters of the mqsicreatebroker or mqsichangebroker command.
Message BIP3226
- Scenario: Error message BIP3226 is displayed;
for example:
The first insert in BIP3226 (in this example,(Semipersistent_Compute1.Main, 27.89) : Array index evaluated to '0' but must evaluate to a positive, nonzero integer value.
Semipersistent_Compute1.Main
) identifies the node and routine in which the statement occurs. The second insert (in this example,27.89
) identifies the approximate line and column of the index value shown in the third insert (in this example, '0'). - Explanation: The validity of using a field reference index
of zero was corrected in WebSphere Message
Broker Version 7.0.
If you have statements in your ESQL modules that include an index
of zero, error BIP3226E is generated.
For example, your ESQL module might contain the following statement:
SET OutputRoot.XMLNSC.Top.A[0].B = 42;
- Solution:
You must correct all ESQL statements that use an index of zero to use an index of 1. Statements might use a variable as well as a literal value for the index; check for both possible situations. For example, your changed code might read:
SET OutputRoot.XMLNSC.Top.A[1].B = 42;
Message BIP7053S
- Scenario: When you deploy to an integration node, error message BIP7053S is displayed.
- Explanation: This error occurs in a multi TCP/IP stack
environment, and indicates that the UNIX System
Services (USS) TCP/IP environment has not been set up correctly.IBM Integration Bus uses USS functions to obtain the host name for a particular system. The following error message is displayed if the default host name is not set up correctly in the USS environment:
The host name that is reported in the error message is the one that has been returned to the integration node as a result of theBIP7053S: Integration node $SYS_mqsi 0 unexpected Java exception java.lang.Error: -2103399272!java.net.UnknownHostException : Hostname: Hostname
gethostname
call. - Solution: Ensure that the TCP/IP environment is configured correctly in USS.
Tagged/Delimited String (TDS) Validator error
- Scenario: You try to deploy a message set with a TDS wire format that has an error.
- Explanation: The following extract from an error log illustrates
what you might see for a TDS Validator error. In this case, the cause
of the problem is that the element
Town
does not have a tag defined.TDS Extractor Trace File ======================== Beginning Extract.. Extracting Identification Info Extracting Project Info Extracting Messages Extracting Elements Extracting Compound Types Extracting Type Members Extracting Type Members Extracting Type Members Extracting Type Members Extracting Type Members Beginning Indexing.. Creating Member IDs to Tags Index Table. Beginning Validation.. Validating Project Validating Types ERROR: TDSValidator::ValidateTypeMemberSimpleElement: Simple elements in a type with Data Element Separation attribute = Tagged Delimited must have the following attribute set: Element Level - Tag (Element ID: Town) (Type ID: AddressType) Return Code: -80 Validating Messages Trace Info =========== EXCEPTION: TDSValidator::Validate: TDS Validation failed. 1 errors 0 warnings Return Code: -1
- Solution: Use the information in the error log to correct the problem.