Understanding BuildPlus processing messages

This section contains information about what you see during a build.

For more information about the BuildPlus windows, see Customizing the BuildPlus user interface


Messages that may appear during a build

Messages written in red in the BuildPlus processing window indicate possible errors. This could include:

Examples include:

BuildPlus will attempt to continue running, and by default, these messages from the main window are recorded in log files. For assistance, please contact GMCL.

Run PPA_Extractor to extract files...

In a new build, PPA_Extractor extracts graphics and submodels files for DBDOC. In a rebuild, it will rerun if any of the following are identified:

  1. New version of PPA_Extractor
  2. Data code change
  3. Missing extracted folder
  4. Missing 0_*.dmp or *.frg file
  5. Change in source

Run PG2XLS_Parser to extract files...

In a new build, PG2xls_parser.exe extracts graphics files for DBDOC. In a rebuild, it will rerun if any of the following are identified:

  1. New version of PG2xls_parser.exe
  2. Data code change: All XLS will be re-extracted
  3. Missing PG2 folder in local project directory: Folder of XLS files will be re-extracted
  4. Missing extracted .png or .dmp: Individual file re-extracted
  5. Timedate stamp change on source XLS: Individual file re-extracted

A full CAD rebuild will occur...

Decomposer extracts information from Composer databases and CLD files. In a rebuild, it will rerun if any of the following are identified:

  1. New version of Decomposer.exe
  2. Changed .ebp file
  3. Changed .CLD file
  4. No dbf files present in the DECOMPOSER# folder (this generates "The DECOMPOSER1 directory appears to be missing key components. Forcing a full rerun on the Composer database ...")

About DR2DT

DR2DT now is part of a service available to reconcile graphics and databases and get a .DT file and.DBF files that are as accurate as possible. For more information, please contact GMCL.

BuildPlus hang while running cscript.exe

When you see this happening, chances are you have some sort of script blocking turned on in your anti-virus software. When your anti-virus software is Norton Anti-Virus (NAV), here are the steps to go through to get your build going:

  1. Start Windows Explorer and navigate to your DBDOC programs directory - typically this is "C:\Program Files\GMCL\DBDOC\Programs". You may need to go into the "Decomposer" subfolder found there as well, depending on what script is being executed. Find the problem .VBS file and execute it (double click on it).
  2. NAV will report "possibly malicious script detected" and recommend that you not execute it.
  3. Choose the option "authorize this script" and continue.
  4. Repeat this process for any script that you hit. At present, these include mdbtype.vbs, xls2csv.vbs, and dbspec.vbs.

These steps will overcome Norton's script blocking without opening up your computer to other scripts that might be malicious.

About Hyperlink

Hyperlink is the DBDOC compiler. During the build you will see "Starting Hyperlink Compiler..." appear in the main BuildPlus window, while many messages appear in the sub-process window. If there is a problem during this stage, contact GMCL.

Dialog boxes that may appear during builds

The following dialogs will not hold up a build, but will allow the build to proceed after 5 minutes of inactivity:


Sibling Projects.png

Logging messages from the main BuildPlus window (Build Root option)

On the Tools menu, click Build Root Options.

When this option is checked, all messages that appear in the main BuildPlus message window will be logged. The file will be in the LOGS subdirectory of the project directory, and will be called <Project_name>_<Build_date>.LOG. This file can be helpful in analyzing any difficulties with the build.

Default: on

Buildplus log build messages.PNG

Running the build in Diagnostic/Maintenance Mode (Build Root option)

On the Tools menu, click Build Root Options.

Diagnostic/maintenance mode is used for debugging. With this option checked, BuildPlus will stop after each step in the build process and ask whether to proceed to the next step. This allows you to stop the build and analyze intermediate files and error logs that may be removed at later stages in the build.

Default: off

Buildplus maintenance mode.PNG

See also