The Parasoft Async Tool enables asynchronous execution of chained outputs after a configured delay.

In this section:

Installation

The tool can be installed from the UI or command line.

UI Installation

1. Go to Parasoft > Preferences and click System Properties.
2. Click Add JARs and choose com.parasoft.soavirt.async.tool-<VERSION>.jar.
3. Click Apply.
4. Restart Virtualize.

Command Line Installation

Add the com.parasoft.soavirt.async.tool-<VERSION>.jar file to the system.properties.classpath property in your settings properties file. For example:

system.properties.classpath=<PATH_TO_JAR>/com.parasoft.soavirt.async.tool-<VERSION>.jar

Alternatively, you could add the com.parasoft.soavirt.async.tool-<VERSION>.jar file to the VirtualAssets/system_jars folder. Create this folder if it does not already exist. Make the following API call to reload the .jar file:

http://<VIRTUALIZE_SERVER_HOST>:<VIRTUALIZE_SERVER_PORT>/soavirt/api/<VERSION>/preferences/systemProperties/reload

Usage

The Async Tool is used to enable the asynchronous execution of chained outputs after a delay you configure. Multiple outputs can be chained to the same Async Tool.

1. Right-click the desired responder in your virtual asset and choose Add Output. 

2. Select an output type on the left and choose Async Tool.
    

   Choosing Outgoing Response > Transport Header as the output type, as shown in the image above, will cause the chained tool to run only after the response is sent. With the other output types, the chained tool is run as soon as the responder is deemed valid (that is, when correlation succeeds), so if you have set any performance delays at either the responder or responder suite level, it is possible for the chained tool to run before the response is sent.

3. Click Finish and configure the tool options.
   
   
   • Delay: Enter the numeric value of delay.
   • TimeUnit: Enter the time unit for the delay. Acceptable values are nanoseconds, microseconds,
     milliseconds, seconds, minutes, hours, and days. The default is milliseconds.
4. Right-click the Async Tool you just configured and choose Add Output.
5. Choose the tool you want to chain and click Finish.
   
   

6. Configure the selected tool as needed. Multiple delayed outputs can be added to the same Async Tool.
   

   You can nest Async Tools in order to create staggered asynchronous delayed outputs.

Third-Party Content

This tool does not contain any third-party software.