Command line options (input)

-wait

If you launch the ASCII Manager with the option -wait, the manager is not stopped as soon as it finishes processing the file specified at start-up but continues to run.

By means of the internal data point element _AsciiManager.FileName, you can pass online additional files for processing to the manager by setting the config/attribute _original.._value.

The path for the file containing the configuration data must be absolute. If this value is sent, the specified file will be processed. The value can be sent either individually or in any combination with other data point elements.

A relative path refers to the directory from which the ASCII Manager has been started.

Example

Passing the file /users/parameterdata to a running ASCII Manager:

main()
{
  dpSet("_AsciiManager.FileName:_original.._value", "/users/parameterdata");
}

-yes

If the ASCII Manager is used to input ASCII files that modify existing data point types, it is necessary to confirm these modifications interactively during import. In order to avoid this prompt, start the input process with the command line option -yes.

-no

The option -yes (see above) allows the automatic change of existing data point types if the ASCII Manager is used to input ASCII files that modify data point types. Contrary to the option -yes, the option -no does not change the existing data point types but ignores the changes.

-in <wildcard pattern>

The command line parameter "-in" allows to import multiple files that match the stated wildcard pattern.

Example

The Parameter "-in *.txt" defines that all files with the ending ".txt" will be imported.

-inactivateAlert

If an input file contains data that change alarm handlers, this file must be input with the command line option -inactivateAlert. This deactivates the alarm handlers to be changed. After completing the input, the setting of the attribute _active in the input file determines whether the alert handling is activated again (when the value is 1) or remains deactivated (when the value is 0).

This command line option has no effect on ASCII files in the formats V3 or V4.

Make certain that the "_active" attribute is set to 1 if you want to reactivate the alert handling of a specific DPE after having changed the handling through the option "-inactivateAlert".

-noAlertConfigHist

If this option is used, alert configs will be imported without increasing the RAIMA configuration history. The alert configs are sent with a timestamp of 0 and overwrite the previous entry of this config in the configuration history.

For the same purpose, the config entry noAlertConfigHist (bool; default = 0; [ascii] section) can be used. The command line option has precedence over the config entry.

If noAlertConfgiHist = 0 or the option -noAlertConfigHist is not used the known behavior of the ASCII manager remains, i.e. new alert configs will be created in the configuration history.

This command line option is not supported for the formats V3 and V4.

-exportTimestamp

This option exports time stamps of online values. If an ASCII file contains time stamps and this option is used, the online values are exported with the time stamps.