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 |