Desktop Management Scripting › Desktop Management Script Interpreter › dmscript Flags

dmscript Flags

A flag is not case-sensitive and does not need a space before related information.

Note: On the Windows systems, you can replace the – (hyphen) with a / (slash). Thus -w_dms has the same meaning as /w_dms.

The interpreter flags are as follows:

-e error_file

Records error messages in the file error_file. On Windows, you can use the flag /e instead.

Example for Windows

dmscript /e c:\errorreport.txt testscript.dms 

-d environment_variables

Indicates that the environment variables coded are stored to the temporary environment of the script execution. The variables are of the form variable_name=value. For each environment variable, a separate -d environment_variables must be coded. Instead of -d, /d could be coded.

Example for Windows

dmscript /d firstname=var1 /dname=var2

> file_name

Redirects the provided output into the file file_name.

Note: If you use command line, use an escape character for the right arrow character. The script interpreter interprets the line and not the command-line interpreter.

Example for Windows

dmscript "> d:\temp\protocol.txt

-o_dms: file_name

Redirects the provided output into the file file_name. Instead of -o_dms, /o_dms could be coded.

For example,

dmscript -o_dms: d:\temp\protocol.txt

-l_dms: locale

Reserved.

-script

Passes the content of the argument line following this flag as arguments to the script. From this point, the interpreter no longer triggers flags to be interpreted.

-u: unitType

Specifies the value of the asset management constant, unitType.

-w_dms

Shows the interpreter window from the start of the interpreter. The error messages or the final message are shown in separate message boxes during the termination phase of the interpreter.

Note: This flag applies to Windows only.

-w_nofinw

Disables the final message box with OK prompt . Use this flag only when the –w_dms flag is used and is optional.

Note: This flag applies to Windows only.

-dms_trace_compile

Provides an interface trace of the compile phase and writes to the log file. Use this flag only for Level 1 or Level 2 Support.

-dms_trace_run

Provides an interface trace of the run phase and writes to the log file. Set this flag only for Level 1 or Level 2 Support.

-dms_verbose

Writes status information to the status line during the processing of a script (Windows only).

-dms_include

Expands or replaces the include search path as defined in the dmscript.cnf temporarily for the runtime of the interpreter.

The flag has the following syntax:

-dms_include: {[+;]search path| <search path>;+}

After the dms_include: you can insert some blank spaces.

<search path>

The search path replaces the search path of dmscript.cnf.+;<search path>

The <search path> appends the search path of dmscript.cnf.

<search path>;+

The <search path> expands the search path of dmscript.cnf, which precedes the first one.

<search path>

A list of directories with semicolons as separators.

Note: The include-flag modifies the include paths for the runtime of an interpreter only. To change the entries permanently, use a normal editor.

-i_dms: <Asset Management configuration file>

On a Windows platform, replace the dash (-) with a slash (/). After the i_dms: there can be spaces but they are not necessary.

The specified file is taken as the asset management configuration file to determine the value of the asset management constants of the interpreter. If the file name includes a relative path, the file is relative to the current directory; otherwise it exists in the specified absolute location.

If the specified file is not found, asset management constants are unavailable for this interpreter run.

Example: dmscript flags

dmscript.exe -t.dms -i_dms: c:\TestConfig\test_1.ini

The file c:\TestConfig\test_1.ini determines the asset management constants.