MetraPipeline.FailurePlugIn.1
The Failure plug-in is used to fail a session even if no errors occur. This is useful for testing the Pipeline server’s error functionality and auditing capability. The Failure plug-in can be configured to fail a transaction at a specific interval or if a string property is set to a certain value, or both. The examples shown below describe the three modes of operation.
N/A (see description)
N/A (see description)
None.
In the following sample configuration information, the current transaction fails after two transactions are processed:
<configdata>
<failevery ptype="INTEGER">2</failevery>
</configdata>
In the following sample configuration information, the transaction fails if the specialinfo property is equal to FORCE FAILURE:
<configdata>
<failif>
<name>specialinfo</name>
<value>FORCE FAILURE</value>
</failif>
</configdata>
In the following sample configuration information, the current transaction fails after two transactions are processed and if the specialinfo property is equal to FORCE FAILURE:
<configdata>
<failevery ptype="INTEGER">2</failevery>
<failif>
<name>specialinfo</name>
<value>FORCE FAILURE</value>
</failif>
</configdata>
The Failure plug-in is useful in a development environment but is not recommended for a production system. Use of this plug-in could cause seemingly random failures.
This plug-in is also documented in the Platform Programmer’s Guide.