TerraSlave is a stand-alone application for executing TerraScan macros. It is included the installation package of full TerraScan version but it can also be installed on a computer independently of TerraScan and MicroStation. A permanent or network license for TerraScan is valid for TerraSlave on the same computer. If a temporary license for TerraScan is used, or if TerraSlave runs on a computer without TerraScan, a separate license file is required for TerraSlave. TerraSlave must be configured before it can be used the first time.
Processing a macro
TerraSlave is usually launched from the Run macro on blocks dialog of TerraScan when a macro process is started. See Run macros in TerraSlave for more information.
- The TerraSlave Processing status window opens:
By default, the window is minimized immediately, so you should maximize it in order to check that the macro is processed. It is empty, if no task is running. If a macro is executed, it shows the status of the process including the macro file, the processed block, and the processing step.
When TerraSlave is started for macro execution, it performs the following actions:
- TerraScan writes a task file (*.TSK) into the \QUEUE folder of the TerraSlave installation directory, for example C:\TERRA\TSLAVE\QUEUE. Further, it launches TerraSlave if it is not yet running.
- TerraSlave checks the \QUEUE folder every 2 seconds. If there is a task file, it moves it to the folder \TASK in the TerraSlave installation directory.
- While TerraSlave processes a block binary file, it writes a report in the \PROGRESS folder of the TerraSlave installation directory.
- After TerraSlave completed the processing for a block binary file, it moves the report to the\REPORT folder of the TerraSlave installation directory.
- After TerraSlave completed the task, it moves the .TSK file from the \TASK folder to the \REPORT folder. Then, the application continues with step 2.
The task file is a text file consisting of all information that is required for TerraSlave to perform the task. The task file is named automatically according to the point of time when it is created by TerraScan. The name structure is <DATE>_<TIME>.TSK, for example 20150523_093349.tsk.
The reports are stored in text files and include information about the processing steps performed on the blocks and a status remark. Report files are named in the same way as task files with the addition of a block number. The name structure is <DATE>_<TIME>_<BLOCKNUMBER.TXT, for example 20150523_093349_000001.txt.
A task can be stopped by clicking on the Abort button in the TerraSlave Processing status window. This stops the processing of the block binary file that is currently busy. An new button Activate appears in the window. Click this to restart the task. This restarts the macro execution with the next block binary file.
The TerraSlave Processing status window can be changed into the Monitor active task window by selecting the Monitor active task command from the View pulldown menu. The Monitor active task window provides some more information about the active task.
It shows a list of the block binary files to be processed, the name of the executing computer, and the processing status of each block binary file. The window also provides buttons for stopping and restarting the process, and for deleting a task file.
TerraSlave windows: running task (upper left figure) and aborted task (lower right figure).
Refreshes the Monitor active task window. The application refreshes the window automatically every few seconds.
Stops the processing of the block binary file that is currently busy. The status of the busy binary file is set to Aborted, all other binary files that are not yet processed are set to status Removed. The buttons Restart block and Clear task appear. The task file is still stored in the \TASK folder of the TerraSlave installation directory.
Restarts the processing of selected block binary files. Select the binary files in the list before clicking on the button. Binary files with status Aborted or Removed can be restarted. They get the status Pending and the application starts to process the first selected binary file. If one or more blocks with status Pending are selected in the list, the Remove block button appears.
Removes a block binary file from the list of files to process. Binary files with status Aborted or Pending can be removed. They get the status Removed. If one or more blocks with status Removed are selected in the list, the Restart block button appears.
Removes a task file completely. This moves the task file and any report files to the \REPORT folder of the TerraSlave installation directory. The task can not be restarted within TerraSlave.
If a task is stopped and not cleared with the Clear task button, or if TerraSlave crashes, the task file remains in the \TASK folder in the TerraSlave installation directory. Make sure to delete the task file from the folder manually before you start the next macro in TerraSlave. If a task file is in the \TASK folder, TerraSlave always tries to execute this task file first and any other task file is stored in the \QUEUE folder. This may lead to the unwanted execution of old task files or, if the execution is no longer possible, if prevents TerraSlave from doing anything.