Running LDDTool and Verifying the Output
Bearing in mind the beta-test status of this software, there are some significant caveats and provisos involved in actually using it in a production environment.
The "operations" documentation provided with the LDDTool package is unmaintained and is at odds with actual tool behaviour in more than a few cases. The information below was compiled by running lddtool with various options and looking at the results produced using LDDTool version 0.1.8.9f, with the "IngestLDDTool.xml" file that came in the distribution package.
Note that errors in command invocation will send error messages to the command line, but these will always be followed by a dump of usage information, so most people will have to be able to scroll back through screen output to see the actual error message.
Also, note that LDDTool will silently ignore invalid switches, so type carefully.
Command Switches to Use
This switches seems to operate as described below.
|-l||Required||This switch must always be specified if you want to actually process the input file. Omitting it produces an error unless the -h switch is present.|
|-p||Required||This switch must always be specified if you want to actually process the input file. Omitting it produces an error unless the -h switch is present.|
|-h||Optional||This displays the command summary information. In this case all other switches and arguments are ignored.|
|--help||Optional||This is an alias for the -h switch.|
|-m||Optional||This switch causes LDDTool to create an additional output file with the same name as the output schema files and an extension of "|
|--merge||Optional||This is an alias for the -m switch.|
|-M||Optional||This switch adds a |
|--Mission||Optional||This is an alias for the -M switch.|
Command Switches to Ignore
Don't use these.
|-a||This switch has no effect.|
|--Attribute||This switch has no effect. It is defined as a synonym for the -a switch.|
|-c||This switch is supposed to direct LDDTool to create XML |
|--Class||This switch has the same effect as the -c switch.|
|--LDD||This is supposed to be an alternate way of including the required -l switch. It's not, and using it throws an error.|
|--PDS4||This is supposed to be an alternate way of including the required -p switch. It's not, and using it throws an error.|
These switches were discovered by accident during testing. Their behaviour is inferred from output. Use at your own peril...
||This switch appears to cause LDDTool to include |
|-v||This switch causes LDDTool to output its version number. To get the version number output, -v must be the only switch used. Specifically, using -h at the same time will suppress the output of the version number.|