Resolving problems when creating resources

Use the advice given here to help you to resolve common problems that can occur when you create resources.

About this task

Look for the problem that you have encountered, and follow the guidance provided to recover from the error.

Problems when creating an integration node:

Problems when creating other resources:

Error message BIP2624 is issued when creating an integration server

Message BIP8081 is issued when creating an integration node

Procedure

Scenario: Message BIP8081E is displayed when you are creating an integration node, the inserted message does not format correctly, and the integration node is not created.
Explanation: This problem occurs because you are not a member of the correct group.
Solution: Read the explanation of message BIP8081, and ask your IBM® App Connect Enterprise administrator to give your user ID access to the mqbrkrs group.

Message BIP8246 is issued when creating an integration node that is configured to start as an IBM MQ service

Procedure

Scenario: Message BIP8246E is displayed when you are creating an integration node that is configured to start and stop with the queue manager that is associated with the integration node.
Explanation: You must be a member of the mqm group to run the mqsicreatebroker command with the -d parameter.
Solution: Ask your IBM App Connect Enterprise administrator to give your user ID access to the mqm group.

Message BIP8087 is issued when creating an integration node on Windows

Procedure

Scenario: When you create an integration node on Windows that has the same name as an integration node that you recently deleted, the following message might be displayed:
```
BIP8087E integrationNode already exists and cannot be created.
```
Explanation: The Windows service that is associated with the integration node that you deleted might be in a "Pending deletion" state. You cannot create an integration node with the same name, until the deletion of the Windows service has completed. The "Pending deletion" state can occur if a Windows system tool has a handle on the service.
Solution: Close the system tool that has a handle on the Windows service and the service should be deleted.

You cannot create files when creating an integration node on AIX

Procedure

Scenario: When you run the mqsicreatebroker command on IBM App Connect Enterprise for AIX®, the following message is displayed:
```
BIP8135E	Unable to create files. Operating System return code 1
```

Explanation: The user ID that you create for IBM App Connect Enterprise testing must have a primary group of mqbrkrs. The following example shows an AIX SMIT panel listing the Change / Show Characteristics of a User:

                   Change / Show Characteristics of a User  

   Type or select values in entry fields. 
   Press Enter AFTER making all desired changes.  
   [TOP]                               [Entry Fields] 
   * User NAME                         peterc 
     User ID                           [202]                    #
     ADMINISTRATIVE USER?              false                    +
     Primary GROUP                     [mqbrkrs]                +
     Group SET                         [mqbrkrs,mqm,system,sys> +

Error message BIP2624 is issued when creating an integration server

Procedure

Scenario: When you create an integration server, you get several BIP2624 messages (MQRC=2012 (MQRC_ENVIRONMENT_ERROR)), and no IBM MQ messages are processed.
Explanation: You have created the integration node to run as an IBM MQ trusted application (that is, the integration node runs in the same process as the IBM MQ queue manager), but the user ID that you specified does not have the required authority.
Solution: If you request the trusted application option on the mqsicreatebroker command by specifying the -t parameter, perform the appropriate steps for your operating system:

Windows

Using the -i parameter on the mqsicreatebroker command, specify a service user ID that is a member of IBM MQ group mqm.

Linux® and UNIX systems

Specify the user ID mqm on the -i parameter on the mqsicreatebroker command.