Understanding the BlackBox Configuration File

This article explains the BlackBoxTCP '.ini' configuration file, breaking down each section and line to clarify its purpose and usage.

Requirements

BlackBoxTCP software version 4.x or 5.x.

Product Information

Below is a detailed breakdown of each section of the .ini (initialization) file. Each subsection explains the purpose and configuration options within that section.

TCP Section

The TCP section defines the server connection details required for establishing communication with the BlackBox.

1. Address=127.0.0.1
   • Specifies the server's IP address.
   • Default is localhost.
2. Port=11111
   • Defines the port used for TCP communication.
   • Default is 10101.
3. RFCCodes=1
   • Enables standard HTTP status codes.

Options Section

The Options section configures the BlackBox's settings for logging, concurrency, and debugging.

1. NumberOfThreads=4
   • Controls concurrent optimizations.
2. LogFolder=C:\MagicLogic\BB5\log
   • Specifies the directory for logs.
3. LogToFile=1
   • Enables logging to files.
4. Verbosity=9
   • Sets the logging level.
   • Maximum detail = 9.
5. Profiling=0
   • Disables performance profiling.
6. LogOptimizer=1
   • Logs optimization details.
7. CLELog=1
   • Activates CLE-specific logging.
8. LogXML=1
   • Includes XML element information in logs.
9. FeatureCode=022;Locus;013;
   • Configures feature-specific options.

Data Section

The Data section defines file paths and behavior for input, output, and backup data handling.

1. OverwriteExistingData=1
   • Allows overwriting existing files.
2. InputFolder=C:\MagicLogic\BB5\input
   • Defines the input file directory.
3. OutputFolder=C:\MagicLogic\BB5\output
   • Specifies the output file directory.
4. OriginalDataFolder=C:\MagicLogic\BB5\original
   • Sets the backup folder for processed files.
5. StaticDataFile=C:\MagicLogic\BB5\Totes.json
   • Points to the static data file.
6. OutputFormat=auto
   • Defines the output format.
7. DeleteAfterProcessing=0
   • Retains input files post-processing.
8. UseDefaults=0
   • Disables default settings.
9. Delay=25
   • Introduces a delay between file processing.
10. UseFlagFile=0
    • Disables flag file usage.
11. UseFrquency=0
    • Disables frequency-based optimizations.

Graphics Section

The Graphics section manages visualization options for generating load plan images.

1. CreateLoadImage=1
   •  Enables load visualization.
2. CreateLoadImageFromTCP=1
   • Generates images for TCP-based loads.
3. ImageFolder=C:\MagicLogic\BB5\images
   • Sets the directory for image storage.
4. SplitBlocks=1
   • Displays individual boxes instead of groups.
5. ShowIDs=1
   • Labels boxes with IDs.
6. Width=1024
   • Specifies image width.
7. Height=768
   • Specifies image height.
8. Format=jpg
   • Defines the image format (bmp, jpg, or pdf).

Reports Section

The Reports section configures settings for creating manifest and load plan reports in PDF format.

1. - Manifest=1
   • Generates a PDF manifest.
2. LoadPlan=1
   • Creates a step-by-step load plan report.
3. DiagramDetails=1
   • Combines load plan and manifest into a single report.

Assistance

If any further assistance is needed, please contact our Support team.