Debug BizTalk Custom Pipelines Components using Pipeline.exe utility – Pipeline file name is already specified Error

  • Sandro Pereira
  • Apr 8, 2010
  • 2 min read

While trying to debug a custom pipeline component using the Pipeline.exe utility, I keep getting the following error message:

Pipeline file name is already specified
Error 80131600

First of all, to use the Pipeline utility to debug custom components, you have to edit the properties of your pipeline component project:

  • Select your pipeline component project
  • Right-click and select the option Properties.
  • Select the tag Debug
    • In Start Action, select the option Start external program and select the Pipeline.exe utility
      • Common path: C:\Program Files\Microsoft BizTalk Server 2006\SDK\Utilities\PipelineToolsPipeline.exe
    • In Start Options, you have to set the Command line arguments option:
      • “<path to your pipeline.btp>” –d “<path to your message>” –c
Debug BizTalk Custom Pipelines Components

📝 One-Minute Brief

Debugging custom pipeline components is significantly faster using the Pipeline.exe utility rather than deploying to the full BizTalk runtime. However, a common command-line syntax error—”Pipeline file name is already specified”—often stalls developers. This guide explains how to correctly format the command, ensuring that paths with spaces are properly quoted and that parameters are passed in the specific order required by the utility to avoid parsing conflicts.

Cause

  • The path I was specifying to my.btp file wasn’t in quotes, and spaces in the path were causing the problem
  • This also applies to the path of my message.

Solution

  • Put the path with quotes, my sample:
    • “C:\Development\MyProject\MyPipelines\MyReceivePipeline.btp” -d “C:\Development\MyProjec\Samples\MY_Message.txt” -c

Once you master the syntax of Pipeline.exe, your custom component development cycle will drop from minutes to seconds. Don’t let a “file name already specified” error stop you—just check your quotes and argument order.

Thanks for Buying me a coffe
Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

Leave a Reply

Your email address will not be published. Required fields are marked *

The Ultimate Cloud
Management Platform for Azure

Supercharge your Azure Cost Saving

Learn More
Turbo360 Widget

Back to Top