Introduction:
The following document will go through the functionality found within JetTrac Wait. The purpose of this module is to provide a small delay in a job to allow files locked by another module to be accessed in the next step.
Technical Support:
If you need assistance in installing and configuring JetTrac Wait™, call Pro Technology Automation, Inc. at 805-527-1248 or email us at support@protechinc.com. Please note that the JetTrac Wait™ license fee does not cover configuration services and technical support so there may be an additional charge. Please ensure you read these instructions carefully before calling for technical support.
How to run JetTrac Wait:
To run the program, you will need to have the following files located in the same folder:
- JTWait.exe
- ExitHandler.dll
JTWait.exe and ExitHandler.dll are files required for the program to run and should never be edited.
Default Functionality:
JetTrac Wait is a fairly simple module that simply pauses for a specified amount of seconds before proceeding on to the next step in a job.
Job Step Configuration Window in JobConfig for JetTrac Wait:
When setting up a job step using JTWait in JobConfig the only line of the config you need to worry about is the first, the Config file. This field should be filled with the fully qualified path to the JTWait Config file. Eg: C:\JetTrac\…\config.ini
In JobConfig, file paths entered should not be in quotes.
As with all modules, there is a dropdown to select whether or not the job should stop completely if this step fails. If you select Yes, any error will terminate the job process and write to the log file what happened, if no, then the job will try to continue anyways. However if any steps further down the line rely on the output of a job set to not stop on error, they may not work properly.
For more specifics go to the JetTrac Field ServiceJobConfig page.
JetTrac Wait Command Line:
The command line to run JetTrac Wait contains the location of the executable, the number of seconds to wait, and the log file. The following is an example of the command line used to run this module:
“C:\JTWait.exe” “5” “C:\JTWait.log”
Each part of the line is divided by spaces (the amount doesn’t matter), and contains the fully qualified file path to the file you are referencing surrounded by quotes. In the example all of the file paths reference the root of C:\, however, it is likely that none of these files will be located in the root of C:\ for your system, so this is simply demonstrating that the full file path is required.
Additional Notes:
This module was created to solve a very specific error when a module attempted to run and referenced a file that was accessed previously by another module in the job. Waiting a handful of seconds after running a module can solve the error stating that the file was locked and could not be accessed.
Please also note that the module requires the time input as a simple integer and is read as seconds. In order to specify to wait a minute you would need to input “60”, not “1 minute”.