ASCII Manager

The ASCII Manager allows you to input and output and thus edit data points and data point types and to configure data points.

The data is passed to the ASCII Manager in an ASCII file (hence the name).

The default certificates in a standard project were created for the user root. Therefore, start the ASCII manager with the user root in a standard project.

Note:

If you use Kerberos and SSO, specify the user using the manager option and the $USER dollar parameter when you start ASCII Manager: WCCOAascii -user $USER. If $USER is used, the current OS user will be used. Note that administration rights ( bit4 (Administration) ) are required if an ASCII import is to be performed.

Command line structure

There are four possible command line options when using the ASCII Manager:

Optional Command
WCCOAascii [-filter TDAOPH] [-filterDp Name*;] [-filterDpType Typ] [-localTime] [-outputVersion version] [-langList list] -out filename
WCCOAascii [-wait] [-inactivateAlert] [-localTime] [-yes] -in filename
WCCOAascii [-localTime] -set dpname value
WCCOAascii [-localTime] -get dpname
CAUTION:

Combinations of -in, -out and -get statements in a command line are not allowed!

The ASCII Manager exports the database of the specified project. An ASCII output is only possible directly on the server, because there is a file access to the database.

-help Help function

The command line WCCOAascii -help displays a list of ASCII Manager functions and command line options.

-commit

By entering the keyword "commit" in the <proj_path>/config/ config file under the [ascii] section or by specifying the command line option -commit, you specify how many messages the ASCII Manager waits for a reply from the Event Manager. The larger the number, the faster the import, but accompanied by a higher CPU load.

  • The default value is 10, which means that the ASCII Manager waits after 10 messages.
  • Specifying 0 means that the ASCII Manager only waits after having sent all values.

Option -localTime

If the command line does not contain any time formatting information, the data are input and output in GMT format. If you want to input or output the data in local time format, you must use the command line option -localTime. In this way, you can input older or manually created ASCII files in local time format. You can also output the data in GMT format in the database in local time format by using the command line option -localTime.

Chapter Description
ASCII Manager, basics Introduction and links to the topics
Output files Command to export data
General filter Command for filtering
Filter for DPT, DP and configs Possibility to filter for DPT, DP and configs
Setting/getting alert texts Setting and getting data with ASCII Manager
Command line options Special options of the ASCII Manager
Combining filters All filters can be combined. All filter types are connected with an AND operator.
Input files Command to import data
Creating data point types Data point types defined in a table
Creating data points Data points defined in a table
Inputting attributes Importing attributes and values
Command line options Special options of the ASCII Manager
Direct Get and Set mode Setting and getting values with the ASCII Manager
ASCII Manager panel, basics Introduction to the panel
ASCII panel The panel with the buttons
General panel components Description of the panel
Input options Settings for importing data
Output options Settings for exporting data
Data point type _AsciiConfig Description of the data point elements
WCCOAascii ASCII Manager Error Codes