Command line of execution of Objland.exe file may contain a set of parameters determining the execution mode.
Every parameter is a string (parameter name) before which there should be a separating character “/” or “-“. The order of parameters in the command line is of no importance. The character case of the parameter name does not make any difference either. For example, variants of writing the parameter “/Debug”, “/debug” and “-DEBUG” are equal. For some parameters a value separated from the parameter name by characters “=” or “:” may be assigned.
Parameter GdbPath=<GDB file name> is used for assigning GDB file name which should be opened during the system start. The name may be preceded by indication of the path to the corresponding folder. In the file name gdb extension should be necessarily indicated. If the file or folder name contains spaces, the parameter value should be put in quotation marks, according to Windows requirements.
Parameter GdbOpenMode=<string> is used only if GdbPath parameter is present. GdbOpenMode value determines the mode for opening GDB. For more detailed description of open modes please see chapter 5 “GDB opening”, subsection “GDB open modes”.
The string specified as the value for GdbOpenMode parameter is checked for the presence of one or several letters shown in table 2-1.
Open mode | ||
Letter | With the presence of the letter | With the absence of the letter |
S | shared access | exclusive access |
R | read only access | read/write access |
F | change file is used | without change file |
Table 2-1. Assigning an open mode by using GdbOpenMode parameter
Any other characters in the string, except for the ones enumerated in the table, are not taken into account. If GdbOpenMode parameter is absent, GDB open mode is determined by ObjectLand settings.
Debug parameter affects the system work only in the case when some internal ObjectLand error appears. The standard reaction provided for such a case is opening a window with a message about the error. If Debug parameter is assigned then instead of a brief message a window with detailed debugging information will appear. This information can be stored in the file which later should be sent to the system developers with detailed description of the situation where the error occurred.
In the next example all the parameters described above are used. It is supposed that the current folder is “Program files\ObjectLand\BIN” folder where all the main system program files are usually located.
objland /debug /GdbPath=”..\Demo\City.gdb” /GdbOpenMode=F
This command will start ObjectLand, open GDB “City” in the mode of exclusive access with permissions to read and write, using the change file, and if an error is detected, will give detailed debugging information. Quotation marks around the path to GDB file in this case are not necessary (since there are no spaces) but they are not prohibited.
 |  |
