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.
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 |
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 |
