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.

When you use the ASCII manager, Kerberos and SSO, enter the user by using the manager option and the dollar parameter user WCCOActrl -user $USER. When $USER is used, it is replaced by the current OS user. Note that in order to start the ASCII Manager, the bit4 (Administration) is required. The users para and root possess the bit 4 by default.

Command line structure

There are four possible command lines 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

Do not combine -in, -out and -get commands in one command line.

The ASCII manager exports the database of the current project (the last project in the proj_path list of the project). Therefore, the ASCII output should be executed on the machine where the data and event managers are running.

When using manager parameters for importing an ASCII file, it is necessary to state the full path of the ASCII file.

-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 data are loaded, albeit accompanied by higher CPU load.

  • Under Linux the default value is 10, which means that the ASCII Manager waits after 10 messages.
  • Under Windows the default value is 1 which means that the ASCII Manager waits after every message. This slows down input into the ASCII Manager but reduces CPU load.
  • 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