When PreLinked or PostLinked process(es) fail

Products

• CA Harvest Software Change Manager

Issue/Introduction

When the process being executed fails, and the Output Log shows "The PostLinked process(es) failed..." or "The PreLinked process(es) failed...", finding the root cause of the problem can be a challenge.  Here is an example error message:

---------- Begin  <Promote to Test>  Process ---------------
I00020017: The package MR- 000001 has been promoted to Test.
I00020015: The process execution completed successfully. The package count is: 1.
E03020134: couldn't delete the folder! at c:\Scripts\TestCheckout.pl line 21..
E03020516: Execution of server UDP program perl c:\Scripts\TestCheckout.pl SampleProject Development has failed. Exit code: 255.
S10060051: The PostLinked process(es) failed for parent process: Promote to Test.
E03060019: Process Execute failed. Process Name: Promote to Test.
---------- End  <Promote to Test>  Process ---------------

If you see check in succeed followed by a pause the above log may not be shown.

This can still indicate that the PostLink process is failing.

Environment

Release : 14.0

Component : CA HARVEST SCM CORE FUNCTIONALITY/PROCESS AUTOMATION

Resolution

In situations like this, a UDP (User Defined Process) is involved.  Often UDPs are configured to run a custom command or script.  The exact custom command or script that failed is included in the text of the error message.  Look for the line that starts with the error code "E03020516:".  In the above example, here it is:

E03020516: Execution of server UDP program perl c:\Scripts\TestCheckout.pl SampleProject Development has failed. Exit code: 255.

If you delete "E03020516: Execution of server UDP program" from the beginning of that line, and everything after "has failed", what remains is the exact command that the UDP was trying to run. 

E03020516: Execution of server UDP program perl c:\Scripts\TestCheckout.pl SampleProject Development has failed. Exit code: 255.

In most cases, the same command should run successfully from a command prompt window on the broker machine.

In the above example, when running the command from a command prompt window, the result is:

C:\Users\Administrator>perl c:\Scripts\TestCheckout.pl SampleProject Development
couldn't delete the folder! at c:\Scripts\TestCheckout.pl line 21.

This shows us the exact problem that is happening with the command.  If the command involves a custom-created script, such as a Perl script, Java program, or shell script, the resolution will be found by debugging the script or program involved.  Depending on the type of program or script involved, some programming expertise might be needed to accomplish this.