• Print
  • Share

Suspended Instances

  • Updated on 01 May 2018
  • 3 minutes to read
  • Contributors

Suspended Instances

When a service instance gets suspended, BizTalk automatically assigns it with an error code. In BizTalk360, you can see the list of service instances depending on their state such as In Progress, Running, and Suspended. BizTalk administrators are alerted when service instances are in the suspended state, and they would want to understand the reason and find a solution for the problem.

Let's take an example to understand the procedure of adding a KB article for one of the service instance error codes. Say, there is a service instance for an application "Contoso" and the service instance has moved to the Suspended (Resumable) state because the published message could not be routed as no subscribers were found for the message. The error code connected to this error is '0xc0c01680'. This information is available to the support team under the 'Error Description' section. With this information, the support team may/may not be able to identify the root cause of the error and fix it. The support team can find a solution/workaround by referring to multiple blogs, support articles and so on. BizTalk360 provides the flexibility to the support team to document these solutions (as a knowledge base article) which will be useful in the long run. Once they have the permissions, they can create a KB article for the corresponding error code.

Adding a KB Article for a Suspended Service Instance

  • Log into the application
  • Click 'Knowledge Base' icon at the top of the page
  • Click 'Service Instances' in the Manage Knowledge Base articles page
  • Click 'Add New' to create a new KB article
  • In the Add New Knowledge Base Article page, enter/select the following information. Only when the environment is selected in the drop-down, the application will allow the selection of other items
  1. Article title – Give a meaningful name for the article. For instance, if the article is for an error code 0xc0c01680, it can be named as "Article for error code 0xc0c01680".
  2. Error Code - Enter the error code for which the KB article is created, say 0xc0c01680
  3. Article Description – Enter the detailed information for the KB Article in the text editor space provided. The text can be formatted with the appropriate font/colours/bold/italics and so on.
  4. Environment – Choose the environment for which the KB Article is to be displayed. If the default option (Choose Environment) is chosen, the KB article will be applied to all the environments.
  5. Service Class – Choose the service class of the service instance. All the service classes in the environment will be displayed in the drop-down.
  6. Application name – Select the application for which the service instance corresponds
  7. Error Text – This field can contain the token from the description of the error message. This field is restricted to 20 characters.
  8. Host Name – Select the host instance for the corresponding application that was selected previously 9. Service Status – Select the state of the service instance (active, suspended, dehydrated, and so on)
  9. Service Name – Select the name of the service instance**
  • Click 'Save and Close' to save the KB article for the corresponding event log/error code
  • Click 'Save and Add Another' to save the KB article and immediately create another new KB Article
  • Click Close to close the KB article creation window and display the list of created KB articles. It will prompt the user with a confirmation message as 'Are you sure you want to close?'
  • Click OK to close the KB article creator window.

suspended instances 1.gif

Create multiple articles for the same Service Instance error code

In a real-time environment, a service instance can fail due to some error and BizTalk attaches the error with an error code. In the same way, another service instance can fail for the same reason as the first one. In these situations, the same error code is tagged with the error. But the workaround may not be the same for both scenarios, and the support person has different workaround steps to fix the problem. In this case, the support person needs to create multiple KB articles for the same error code, and tag them according to the service instance. This will ensure the correct KB article is displayed depending on the service instance name.

When creating multiple articles for the same error code, follow the exact same steps as shown in "Adding a KB Article for a Suspended Service Instance" section and select the appropriate tags (Environment, Service Class, Application Name, Error Text, Host Name, Service Status, Service Name) for the error code. The tags will play the differentiator role to display the appropriate KB article.