En Data Spooler Configuration
En Data Spooler Configuration
Created by GSP/ORM
Status: 26/11/2013
CONTENT
2. BATCH MODE 4
3. CONFIGURATION FILES 5
Parameter Description
-nongui Batch mode active
-f <Directory> Directory which contains all spooler configuration files for the
batch mode.
-outDir Base output directory for the batch mode.
-type <spoolerType> Indicates the spooler type.
Possible values: ‚asra‘ or ‚ssl‘
Default: ‚asra‘
For the batch mode, a separate configuration file must be created in a directory for each
desired language/output format/time format combination. This directory must also be
specified as the command line parameter –f of the spooler when running the batch mode (see
Chapter 1).
The data spooler reads each individual configuration file from this directory and creates the
desired output files for this configuration variant.
In addition, the parameter –outDir <outputdir> must be specified for the batch mode (see
Chapter 1)
SSL spooler:
startSSLSpooler.bat –nongui –f c:\data\spoolerBatchConfig\ -outDir c:\ewa\spooler\ssl\
ASRA spooler:
startASRASpooler.bat –nongui –f c:\data\spoolerBatchConfig\ -outDir c:\ewa\spooler\ssl\
The configuration files of the data spooler are located in the installation directory of the
spooler in the sub-directory “config/”.
There are basically two formats for configuration files. These are the XML files and the so-
called Property files which contain parameter names/value pairs. In the Property files, the
parameter name and the value are separated from each other with an equals sign. Lines which
start with "#" are comment lines.
# ------------------------------------------------------------------------------------
# Name: asraSpooler.properties
# Version 1.0, 11/16/2011
# ASRA Data Spooler
# Description: Configuration file with options for the ASRA data spooler. These
# will be used to spool out the AWAT files.
# ------------------------------------------------------------------------------------
XML configuration files have an assigned schema file (XSD), which defines the format and the
value ranges of the individual attributes.
To carry out the character replacement, the data spooler must know which characters are to
be replaced with which replacement characters. For this purpose, an XML configuration file is
used according to the following schema:
awatCharset.xsd
</awatCharset>
The <language> element defines which language the replacement rules apply to. For this
purpose, either "default" for the default replacement rules or the 2-place ASRA language code
with leading zeros must be entered in the "code" attribute. The "default" language must always
be present. It contains the default replacement rules and is also used if the language
specified in the "code" attribute is not found during the spooler runtime.
Several <language> elements with the corresponding <char> sub-elements can be present.
For details, see the definition and comments in the schema file.
The data spooler has an XML configuration file from which the assignment of a category/family
to book/column is read out. Should new families be added, then this file must be expanded, as
otherwise the spooler only specifies the assignment with "??".
bookColumnMapping.xsd
A new <family> element complete with <bookColumn> element must be inserted for each new
mapping. All attributes of the two elements must be specified.
3.1.3 Logging
The data spooler uses Log4J as a log system. The logging configuration can be adjusted with
the Log4J XML configuration file. Additional details can be viewed under the following link:
http://wiki.apache.org/logging-log4j/Log4jXmlFormat
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<!-- define the appenders -->
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<appender name="console" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %-5p %c{1} - %m%n"/>
</layout>
</appender>
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<!-- Silence loggers of the frameworks as they would -->
<!-- clatter the log (do not remove) -->
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<logger name="org.apache.commons.digester3">
<level value="error" />
</logger>
<logger name="org.apache.commons.beanutils">
<level value="error" />
</logger>
<logger name="org.hibernate.validator">
<level value="error" />
</logger>
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<!-- root logger and level -->
<!--+++++++++++++++++++++++++++++++++++++++++++++++++++-->
<root>
<level value="info"/>
<appender-ref ref="console" />
<appender-ref ref="file" />
</root>
</log4j:configuration>
To adjust the log level, use the value attribute of the <level> element under the <root>
element. Permissible values are:
• trace
• debug
• info
• warn
• error
• fatal
Please note that the log output also impairs the spooler runtime, and therefore the value
should not be set more detailed than INFO.
There is an "asraSpooler.properties" configuration file for the ASRA spooler. It is located in the
installation directory of the spooler in the config/ subdirectory.
This file contains the same options as in the user interface of the spooler:
Parameter Description
display.name Name of the spooler. This is shown in the user interface as a window
title.
gui.language Language in which the user interface is displayed.
Permissible values are:
00 for German
02 for English
output.dir Directory into which the output files are to be written.
spoolout.language Language in which the spoolout is to be carried out. Data are written
in the output files in this language.
Permissible values:
Double-digit number with leading zero. All values located in the WIS
database.
spoolout.format File format in which the output files are to be written.
Permissible values:
UCS2
UTF8
ASCII
spoolout.uppercase Indicates whether the data are to be output in upper case letters
(only with ASCII).
Permissible values:
true Upper case letters
false As in the database
spoolout.timemode Specification of the time mode which is to be used for the spoolout
(only with the language German – in all other languages only "foreign"
is permissible)
Permissible values:
foreign decimal hours (Export)
domestic work units (domestic)
spool.file.326.master data Indicates whether the file "326 master data“ is to be output.
Permissible values:
true File is created
false File is not created
spool.file.326SD2.master data Indicates whether the file "master data 326 II“ is to be output.
Permissible values:
true File is created
false File is not created
spool.file.84.table data Indicates whether the file "84 table data" is to be output.
Permissible values:
true File is created
false File is not created
The spooler loads these options when the spooler is started and initializes the user interface
with them. When the spooler is closed, changes to the settings are saved back to this file.
# ------------------------------------------------------------------------------------
# Name: asraSpooler.properties
# Version 1.0, 11/16/2011
# ASRA Data Spooler
# Description: Configuration file with options for the ASRA data spooler. These
# will be used to spool out the AWAT files.
# ------------------------------------------------------------------------------------
# Flag indicating if included work texts of AWAT file 326 should be written.
# Supported values are: ‘true’ or ‘false’
file326.datatype20.included.work=true
# Flag indicating if note and additional operations of AWAT file 326 should be written.
# Supported values are: ‘true’ or ‘false’
file326.datatype31.note.addition=true
There is an "internal" configuration file "asraGeneral.properties" for the ASRA data spooler; it
should not be changed by the end user. This file contains a negative list of the languages for
which the ASCII format and the spoolout in upper case letters are not permitted. This also
includes the specifications for the file name and the size specifications for the calculation of
the required hard disk space for the spoolout.
Parameter Description
disallow.ascii.languagelist Negative list (comma-separated) with 2-digit numeric language code
(with leading zero) for which no ASCII spoolout is possible.
disallow.uppercase.languagelist Negative list (comma-separated) with 2-digit numeric language code
(with leading zero) for which no spoolout in upper case letters is
possible.
awatfile.name.<language code> The five character strings (separated by commas) after the equals sign
of each line represent the name of the spoolout files for a language
which appear on the user interface of the ASRA data spooler as
default file names.
6 entries must always appear in the comma-separated list. The
sequence must be observed:
File name 1: 326 Master data,
File name 2: 326 Master data II,
File name 3: 84 Table data,
File name 4: 140 Model designation,
File name 5: 80 Model designation,
File name 6: 80 Total AWERT
326s, 84s, 140s, 80s model designation and 80s AWert.
If entries are missing here, the file names in the spooler user interface
are not correctly preassigned (language change, spooler start-up).
data.size.326.operation texts Specifies how much memory (in kilobytes) the record type 10 will
probably require on the hard disk in the spoolout file "326 master
data" in the ASCII format. Three times this value is assumed for the
formats UCS2 and UTF8.
data.size.326.included work texts Specifies how much memory (in kilobytes) the record type 20 will
probably require on the hard disk in the spoolout file "326 master
data" in the ASCII format. Three times this value is assumed for the
formats UCS2 and UTF8.
data.size.326.work units Specifies how much memory (in kilobytes) the record type 30/31 will
probably require on the hard disk in the spoolout file "326 master
data" in the ASCII format. Three times this value is assumed for the
formats UCS2 and UTF8.
data.size.326sd2.additional operations Specifies how much memory (in kilobytes) the record type 32 will
probably require on the hard disk in the spoolout file "326 master data
II" in the ASCII format. Three times this value is assumed for the
formats UCS2 and UTF8.
data.size.84.table data Specifies how much memory (in kilobytes) the spoolout file "84 master
data" will probably require on the hard disk in the ASCII format. Three
times this value is assumed for the formats UCS2 and UTF8.
data.size.140.model designation Specifies how much memory (in kilobytes) the spoolout file "140
model designation" will probably require on the hard disk in the ASCII
format. Three times this value is assumed for the formats UCS2 and
# ---------------------------------------------------------------------------------------
# Name: asraGeneral.properties
# Version 1.0, 11/16/2011
# EWA Data Spooler
# Description: This configuration contains a negative list consisting of language
# codes for which the ASCII format and/or the spoolout in upper case letters
# is not permitted. Default AWAT file name and size specifications for the
# disk space calculation of a spoolout
# ---------------------------------------------------------------------------------------
# Comma-separated list with language codes for which the spool format ASCII is not permitted
disallow.ascii.languagelist=12,17,20,22,28,86
# Comma-separated list with language codes for which spooling in upper case letters is not permitted
disallow.uppercase.languagelist=12,17,20,22,28,86
# Default awat file names for the different languages (comma separated list must be ordered)
awatfile.name.00=VZ002A,VZ003A,VZ004A,VZ008A,VZ046A,VZ000A
awatfile.name.01=VZ042A,VZ043A,VZ044A,VZ008A,VZ046A,VZ040A
awatfile.name.02=VZ082A,VZ083A,VZ084A,VZ008A,VZ086A,VZ080A
awatfile.name.03=VZ122A,VZ123A,VZ124A,VZ008A,VZ126A,VZ120A
awatfile.name.04=VZ162A,VZ163A,VZ164A,VZ008A,VZ166A,VZ160A
awatfile.name.05=VZ402A,VZ403A,VZ404A,VZ008A,VZ406A,VZ400A
awatfile.name.06=VZ202A,VZ203A,VZ204A,VZ008A,VZ206A,VZ200A
awatfile.name.07=VZ482A,VZ483A,VZ484A,VZ008A,VZ486A,VZ480A
awatfile.name.08=VZ322A,VZ323A,VZ324A,VZ008A,VZ326A,VZ320A
awatfile.name.09=VZ282A,VZ283A,VZ284A,VZ008A,VZ286A,VZ280A
awatfile.name.10=VZ362A,VZ363A,VZ364A,VZ008A,VZ366A,VZ360A
awatfile.name.12=326GRI,326IIG,084GRI,VZ008A,vz046a,80GAWG
awatfile.name.15=VZ242A,VZ243A,VZ244A,VZ008A,VZ246A,VZ240A
awatfile.name.17=VZ442A,VZ443A,VZ444A,VZ008A,VZ446A,VZ440A
awatfile.name.20=VZ522A,VZ523A,VZ524A,VZ008A,VZ526A,VZ520A
awatfile.name.21=326HUN,326IIH,084HUN,vz008a,vz046a,80GHUN
awatfile.name.22=326RUS,326IIR,084RUS,vz008a,vz046a,80GAWR
awatfile.name.24=326CZE,326IIC,084CZE,VZ008A,VZ046A,80GAWC
awatfile.name.25=326POL,326IIP,084POL,VZ008A,VZ046A,80GAWP
awatfile.name.27=326BUL,326IIB,084BUL,VZ008A,VZ046A,80GBUL
awatfile.name.28=326CHI,326IIZ,084CHI,VZ008A,VZ046A,80GCHI
awatfile.name.29=326ROM,326IIR,084ROM,VZ008A,VZ046A,80GROM
awatfile.name.81=326SLO,326IIS,084SLO,vz008a,vz046a,80GAWS
awatfile.name.82=326KRO,326IIO,084KRO,vz008a,vz046a,80GAWK
awatfile.name.86=326KOR,326IIK,084KOR,vz008a,vz046a,80GKOR
There is an "sslSpooler.properties" configuration file for the SSL spooler. It is located in the
installation directory of the spooler in the config/ subdirectory.
This file contains the same options as in the user interface of the spooler:
Parameter Description
display.name Name of the spooler. This is shown in the user interface as a window title.
gui.language Language in which the user interface is displayed.
Permissible values are:
00 for German
02 for English
output.dir Directory into which the output files are to be written.
spoolout.language Language in which the spoolout is to be carried out. Data are written in the
output files in this language.
Permissible values:
Double-digit number with leading zero. All values located in the WIS
database.
spoolout.format File format in which the output files are to be written.
Permissible values:
UCS2
UTF8
ASCII
spoolout.uppercase Indicates whether the data are to be output in upper case letters (only with
ASCII).
Permissible values:
true Upper case letters
false As in the database
spool.file.SSLRule Indicates whether the file "SSL Rules" is to be output.
Permissible values:
true File is created
false File is not created
spool.file.SSLPart Indicates whether the file "Damaged part designation" is to be output.
Permissible values:
true File is created
false File is not created
spool.file.SSLType Indicates whether the file "Damage type designation" is to be output.
Permissible values:
true File is created
false File is not created
spool.file.SSLFGR Indicates whether the file "Function group" is to be output.
Permissible values:
true File is created
false File is not created
The spooler loads these options when the spooler is started and initializes the user interface
with them. When the spooler is closed, changes to the settings are saved back to this file.
# ------------------------------------------------------------------------------------
# Name: sslSpooler.properties
# Version 1.0, 11/16/2011
# SSL Data Spooler
# Description: Configuration file with options for the SSL data spooler. These
# will be used to spool out the SSL files.
# ------------------------------------------------------------------------------------
There is an "internal" configuration file "sslGeneral.properties" for the SSL data spooler; it
should not be changed by the end user.
This file contains a negative list of the languages for which the ASCII format and the spoolout
in upper case letters are not permitted. This also includes the specifications for the file name
and the size specifications for the calculation of the required hard disk space for the spoolout.
Parameter Description
disallow.ascii.languagelist Negative list (comma-separated) with 2-digit numeric language code
(with leading zero) for which no ASCII spoolout is possible.
disallow.uppercase.languagelist Negative list (comma-separated) with 2-digit numeric language code
(with leading zero) for which no spoolout in upper case letters is
possible.
ssltfile.name.<language code> The five character strings (separated by commas) after the equals sign
of each line represent the name of the spoolout files for a language
which appear on the user interface of the ASRA data spooler as default
file names.
5 entries must always appear in the comma-separated list. The
sequence must be observed: SSL rules, Damaged part designation,
Damage type designation, Function group and IDIS/DAVIS plausibility.
If entries are missing here, the file names in the spooler user interface
are not correctly preassigned (language change, spooler start-up).
data.size.SSLRule Specifies how much memory (in kilobytes) the spoolout file "SSL rules"
will probably require on the hard disk in the ASCII format. Three times
this value is assumed for the formats UCS2 and UTF8.
data.size.SSLPart Specifies how much memory (in kilobytes) the spoolout file "Damaged
part designation" will probably require on the hard disk in the ASCII
format. Three times this value is assumed for the formats UCS2 and
UTF8.
data.size.SSLType Specifies how much memory (in kilobytes) the spoolout file "Damage
type designation" will probably require on the hard disk in the ASCII
format. Three times this value is assumed for the formats UCS2 and
UTF8.
data.size.SSLFGR Specifies how much memory (in kilobytes) the spoolout file "Function
group" will probably require on the hard disk in the ASCII format. Three
times this value is assumed for the formats UCS2 and UTF8.
data.size.SSLPlausi Specifies how much memory (in kilobytes) the spoolout file "IDIS/DAVIS
plausibility" will probably require on the hard disk in the ASCII format.
Three times this value is assumed for the formats UCS2 and UTF8.
# ---------------------------------------------------------------------------------------
# Name: sslGeneral.properties
# Version 1.0, 11/16/2011
# EWA Data Spooler
# Description: This configuration contains a negative list consisting of language
# codes for which the ASCII format and/or the spoolout in upper case letters
# is not permitted. Default SSL file name and size specifications for the
# disk space calculation of a spoolout
# ---------------------------------------------------------------------------------------
# Comma-separated list with language codes for which the spool format ASCII is not permitted
disallow.ascii.languagelist=12,17,20,22,28,86
# Comma-separated list with language codes for which spooling in upper case letters is not permitted
disallow.uppercase.languagelist=12,17,20,22,28,86
# Default awat file names for the different languages (comma-separated list must be ordered)
sslfile.name.00=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.01=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.02=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.03=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.04=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.05=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.06=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.07=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.08=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.09=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.10=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.12=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.13=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.15=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.17=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.20=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.21=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.22=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.25=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.28=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
sslfile.name.86=XZD25A.Z.SSLREGIE,XZD25A.Z.SSLTEIL,XZD25A.Z.SSLART,XZD25A.Z.SSLFGR,DZ09A.Z.V05070S
# Size for each data type to calculate required hard disk space
# Size must be given in kilobytes for ASCII spoolout type
data.size.SSLRule=25000
data.size.SSLPart=900
data.size.SSLType=10
data.size.SSLFGR=21
data.size.SSLPlausi=42000
Daimler AG
GSP/ORM
Werk 002, HPC R802
70546 Stuttgart
Deutschland
Telefon: +49 711 17 40070
E-Mail: [email protected]