Professional Documents
Culture Documents
14 Logging e
14 Logging e
System logs
1
Free definable logs
SIMATIC 2
Creating free protocols based on
Stepping logs 3
Automation system Step logging
4
BRAUMAT/SISTARClassic V5.3
Logging of user operations
Logging 5
What to do on errors?
Manual 6
Edition 11/2007
A5E00239388-04
Safety Guidelines
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring to property damage only have no safety alert symbol. The notices shown below are
graded according to the degree of danger.
Danger
! indicates that death or severe personal injury will result if proper precautions are not taken.
Warning
! indicates that death or severe personal injury may result if proper precautions are not taken.
Caution
! with a safety alert symbol indicates that minor personal injury can result if proper precautions are not
taken.
Caution
without a safety alert symbol indicates that property damage can result if proper precautions are not
taken.
Attention
indicates that an unintended result or situation can occur if the corresponding notice is not taken into
account.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The device/system may only be set up and used in conjunction with this documentation. Commissioning and
operation of a device/system may only be performed by qualified personnel. Within the context of the safety
notices in this documentation qualified persons are defined as persons who are authorized to commission,
ground and label devices, systems and circuits in accordance with established safety practices and standards.
Prescribed Usage
Note the following:
Warning
! This device and its components may only be used for the applications described in the catalog or the
technical description, and only in connection with devices or components from other manufacturers
which have been approved or recommended by Siemens.
Correct, reliable operation of the product requires proper transport, storage, positioning and assembly
as well as careful operation and maintenance.
Trademarks
All names identified by ® are registered trademarks of the Siemens AG.
The remaining trademarks in this publication may be trademarks whose use by third parties for their own
purposes could violate the rights of the owner.
Siemens AG
Automation and Drives
Postfach 4848, D- 90327 Nuernberg, Germany ©Siemens AG 2007
Technical data subject to change.
Siemens Aktiengesellschaft A5E00239388-04
Preface
Purpose of the Manual
This manual describes the logging with BRAUMAT/SISTAR Classic V5.3 and gives you an
overview of the following topics:
¾ system logs
¾ step logs
¾ free definable logs
¾ create free definable logs based on stepping logs
¾ changes log
This manual is intended for those responsible for configuring, commissioning and servicing
automation systems.
Required Basic Knowledge
This manual forms part of the BRAUMAT/SISTAR Classic V5.3 documentation package.
The following schematic of the document architecture show the individual manuals as well
as their thematic grouping within the entire program package
Description of the
System Installation and
Configuration
Administration
Communication
EPE-creation
Batch-
processing
Application for
Batch curves 'based on S7'
Logging Message
Building block
description S5 Engineering of the
Route Control
Training Centers
Siemens offers a number of training courses to familiarize you with the SIMATIC S7
automation system. Please contact your regional training center or our central training center
in D 90327 Nuremberg, Germany for details:
Telephone: +49 (911) 895-3200.
Internet: http://www.sitrain.com
You can reach the Technical Support for all A&D products
• Via the Web formula for the Support Request
http://www.siemens.com/automation/support-request
• Phone: + 49 180 5050 222
• Fax: + 49 180 5050 223
Additional information about our Technical Support can be found on the Internet pages
http://www.siemens.com/automation/service
1 System logs
1.1 General
The process control system supports system logs, where the following ones are included in
the system delivery:
¾ Recipe log
¾ Stepping log
¾ Parameterization log
¾ Order system log
¾ Message archive log
¾ Curve archive log
¾ Curve input log
¾ Maintenance log
¾ Changes log
After you have selected and enabled a master recipe, you can output the following lists to
the printer:
¾ Process parameters list
¾ Process input list
Recipe procedure window
After you have opened the recipe procedure, you can output the following information to the
printer:
¾ The recipe procedure diagram with optiosn for selecting:
- the current size
- the complete recipe procedure on one page
- Poster print
BRAUMAT/SISTAR Classic V5.3 1-1
Logging
A5E00239388-04
System logs
In order to initiate the automatic print-out of the stepping log at the end of a technological
sequence (after the last unit operation), the flag M 101.2 must be set to 1 within this last unit
operation.
The user can start printing out a stepping log after selecting (application ‘stepping log’):
¾ year
¾ recipe type
¾ order number
¾ batch number
¾ unit
The selected stepping log is shown on the screen and via 'file, print' the user has two
possibilities:
¾ print log for the selected unit only
¾ print log for all units
Note:
The stepping logs are stored on a IOS (server) only if the datagram type 5 is configured for
FIFOs related to this IOS.
Via the application 'parameterization, FIFO’, the stepping log can be dis- or enabled.
In addition the user can enable or disable the logging of a certain step (basic operation) by
setting the flag M 102.5 to 1 (disable) or 0 (enable). These unit operations do not appear in
no stepping log.
In the application 'parameterization' a record is opened via the selection of the plc and the
object class. This record set is shown on the display. With 'file, printing' the user can select,
what to print:
¾ print all data sets (records)
¾ current record
¾ range ‚record from ... to ...’
application ‘text parameterization’:
Within the application 'text parameterization' we have two types of text lists:
¾ global text lists (plc independent)
¾ plc related text lists
After selecting ‚global' or a plc related text file, it is shown on the screen. Via ‘file, print’ a
dialog appears where two kinds of printouts can be selected::
¾ current file (means whole list)
¾ current range
Another possibilty is the modification via a shareware text editor like ‘Ultra Edit’. In this case
the identical textstrings for ‘customer’ and ‘plant’ may be replaced commonly for all files with
one ‘Search/Replace in files’ command.
Global footer definition files in folders ‘…\windcs\texte.x’:
File Description
ARCH_FRM Footer for printing curve archives
BALIFRM Footer for printing order system
BRGRFRM Footer for printing recipe procedures
BRLIFRM Footer for printing of RUP lists
DATACONN_FRM Footer for printing graphical source views
KURVFRM Footer for printing input curves
MAINTFRM Footer for printing maintenance data
MELDFRM1 Footer for printing message logs
PARAMFRM Footer for printing of parameterization data records
PTXTFRM Footer for printing of text parameterization data
RECCLFRM Footer for printing the process input list of recipes
RECIOFRM Footer for printing the process input list of one batch job
RECMAFRM Footer for printing process parameters
RECOVFRM Footer for printing recipe overviews
SRPROTFR Footer for printing stepping logs
1.11 Printer
One printer can be installed per IOS according to the operating system WINDOWS NT.
Parameter
sub datagram number TTNR iPartTeleNr;
DB186, DW130, KF DB580.DBW148, INT
Batch number CHNR; iBatch;
DB186, DW131, KF DB580.DBW150, INT
Order number ATNR iOrder;
DB186, DW132, KF DB580.DBW152, INT
Recipe number RPNR iRecipe;
DB186, DW133, KF DB580.DBW154, INT
Recipe type RTNR iRecType;
DB186, DW134, KF DB580.DBW156, INT
Identification for OB WHETHER not used as the FB580
DB186, DW135, KF recognizes itself by what OB it
has been called
Depending on the call to the FB<FREE DEF. LOG > the telegram is assembled and stored
to the calling ranges 1 or 2 according to calling type. At the end of the block the
corresponding user data is transferred into the temp. buffer. After at most 5 user data words
are collected, all data is written into a FIFO through a call to the FB<FREE DEF. LOG>
(where type = 0) and sent to the server (IOS). Data gram type 6 has to be configured before
for this FIFO.
The parameters shown in gray back color in the table above are updated by the system
when a datagram is sent and must not be modified by the user.
On the hard disk of a IOS a dBASE file is created after arrival of the telegram. Depending on
the date and the recipe type the server (PROT_006.DLL) creates the folder and file name.
According to the order and batch number one record is created.
The definition file (FEPR_<Rezepttypnr.>.DEF) provides the structure of the dBASE files
and where the user data is written to (offset within the record). Data set elements
corresponding sub data gram number are written, all other ones remain unconsidered.
Many of the calling methods shown below are useful only if we use a complete system since
system blocks are called inside: (refer to ‘system blocks‘)
Using indirect parameterization ( calling type = -1) the parameters are fetched from the
instance DB<FREE DEF. LOG>.
The following table indicates the available range of the parameters. Below the parameter
names the corresponding DW-Nr of the instance DB<FREE DEF. LOG> is given.
Parameter list of the FB<FREE DEF. LOG>:
Parameter Description
sub sub data gram number
data gram -4: The corresponding record with order number / batch number is reset
number (texts are overwritten with blanks, numbers set to 0).
S5: -3: The corresponding record with order number / batch number is transferred
TTNR into the corresponding copy archive (same recipe type).
S7: iPartTeleNr -2: end of a batch, only the sub data gram number the telegram is used.
-1: only the time of the datagram is read by the IOS.
0: all data of the telegram is read and written into the database record
1 - n: sub datagram number; writing posiion within the dBASE file depends on
the corresponding definition file (*.DEF).
= 1: Reading the actual value (double-word) of the DFM-module with the index
(number) given by ‘ANA’:
001 ... 255 : DFM-group 0
257 ... 511 : DFM-group 1
513 ... 767 : DFM-group 2
769...1023 : DFM-group 3
The parameter 'identification for block transfer' indicates the offset (start address)
DW (1...5) within a telegram.
= 2: Reading the set point value (Double-word).
please refer to 'calling type' = 1.
= 3: Reading the actual value (double-word) of a DFM-module of the corresponding
unit with the relative number (1...13) given by the identifier 'ANA'. The parameter
'identification for block transfer' provides the offset of the DW (1...5) within the
telegram.
= 4: Reading of the set point value (double-word).
please refer to 'calling type' = 3.
= 5: not used
= 6: Reading the actual value of the block MESS addressed by the identifier 'ANA'. The
parameter 'identification for block transfer' addresses the offset of a DW (1...5)
within the telegram.
= 7: Loading a word from a DB. For Block number and DW number (address) see
parameter 'data block' and 'data word'. The parameter 'identification for block
transfer' addresses the beginning (DW) within the telegram.
= 8: not used.
= 9: Loading a word from identifier 'ANA'.
Here 'ANA' is not interpreted as a DFM number (index), but as a user defined
value. The parameter 'identification for block transfer' addresses the offest DW
within the telegram.
= 10: not used
= 11: Loading a double-word addressed by the identifier 'floating-point number'. The
parameter 'identification for block transfer' indicates the address (offset) DW (1...5)
within the telegram.
(not reasonably for dBASE archives, therefore don’t use)
= 12: Loading the data of the real-time clock of the plc S7-400;
Format: month, day, day of the week (1 = sunday), year;
the dates are always located in the 1st and 2nd DBW in the telegram.
(not reasonably for dBASE archives, therefore don’t use)
= 13: Loading the time from the real-time clock of the plc S7-400; Format: minute, hour,
0, second;
the dates are always located in the 1st and 2nd DBW in the telegram.
(not reasonably for dBASE archives, therefore don’t use)
= 14 - 19: not used
= 20 Loading an input byte addressed by the identifier 'ANA'.
= 21 Loading an input word addressed by the identifier 'ANA'.
= 22 Loading an input double word addressed by the identifier 'ANA'.
= 23 Loading an output byte addressed by the identifier 'ANA'.
= 24 Loading an output word addressed by the identifier 'ANA'.
= 25 Loading an output double word addressed by the identifier 'ANA'.
= 26 Loading a flag byte addressed by the identifier 'ANA'.
= 27 Loading a flag word addressed by the identifier 'ANA'.
= 28 Loading a flag double word addressed by the identifier 'ANA'.
= 32 Loading a time value (BCD, time base and value) addressed by the identifier
'ANA'.
= 33 Loading a counter value (BCD) addressed by the identifier 'ANA'.
= 34 - 98: not used
= 99 Initialization of the temporary entry (DB<FREE DEF. LOG>) and the temp. buffer
(DB<FREE DEF. LOG>) with zero.
In this example, five data words of DB300, i.e. DBW10, DBW12, DBW14, DBW16 and
DBW18 are copied to DB580 for datagram element 1.
In this example, the DFM process value of DFM4 is copied from DFM group 0 to user data 3
and 4 of DB580.
DFM 0/ 4 process value DB580
DB736 DBW366 and DBW367 DBW126 and 128 or DBW326 and 328
Parameter interface values description
: U M x.y;
: BEB;
: Call FB 580, DB580; Tyke over malt quantity from DFM groats flowmeter
iPartTeleNr := 1
iBatch := 0 Batch data is taken from current record
iOrder := 0
iRecipe := 0
iRecTyp := 0
2-8 BRAUMAT/SISTAR Classic V5.3
Logging
A5E00239388-04
Free definable logs
In this example, the DFM setpoint of DFM3 is copied from DFM group 0 to user data 1 and 2
of DB580.
DFM 0/ 3 setpoint DB580
DB736 DBW342 and DBW344 DBW122 and 124 or DBW322 und 324
In this example, the value (2) of parameter ANA is copied to user data 1 of DB580.
Parameter ANA DB580
2 DBW122 or DBW322
In this example, the five data words DBW10, DBW12, DBW14, DBW16 and DBW18are
copied from DB100 to datagram element 1.
In this example, datagram element 1 is transmitted as datagram 6. The data to be sent must
be available in DB580 prior to the call. The folder and file names are based on the year, the
month and the recipe type.
The error code is returned by the FB80 via DB186, DW40. Additional information is returned
via AKKU1 and AKKU2.
The error code consists of 2 bytes in a hexadecimal format. The calling type indicates the
first byte, the second byte is a continuous number within calling type (sub type).
Error code DB581.DBW12:
Error with error code. declaration
calling type= xy
(DBB13,
(DBB12, hexadecimal)
hexadecimal)
01 or 07 01 DB not available or too short
Xy 02
FF 03 no data exists in the data words
1 to 5
FF 04 Error writing data into FIFO
Up to line 'TEILTELNR' the structure is fix for all use cases, however, except for the order
number and batch number the other parameters are optional. The lines below ‘TEILTELNR’
are optional, too, but can be configured in many different ways. Allowed are 16 bit, 32 bit
values as well as texts from text lists. The corresponding address within the telegram
received from the plc is given in the right most column (normally comment column).
Description file
Offset
record
length
offset of element name data type element size comment or
element [.decimal points] description of user data
The Offset defines the number of the bytes at the beginning of the (dBASE) file that does not
contain any user data (header data), but they are necessary for the file organization. These
header data contains the dBASE file size, number of records and record structure.
2-14 BRAUMAT/SISTAR Classic V5.3
Logging
A5E00239388-04
Free definable logs
In case of using `Free def. logs’ this value may equal 0, as during evaluation of the
telegrams this offset is computed.
Record length:
The record length is the record size in bytes. Normally it is the sum of all elements (4th
column of DEF file). As it is allowed to leave some elements in the DEF file, this record
length parameter can be higher than this byte sum.
data element structure:
This value gives a (relative) offset within the record, where the data of this element is stored
(start with byte address 0).
element name:
This is the symbolic name of the element, contains at most 10 characters whereas the first
must start with a character. This name becomes later the column name within a dBASE file.
Data type:
As only ASCII characters are allowed within a dBASE file, there is only a subset of all
possible data types for DEF files allowed to be used:
type description
CHAR: Character string
CINT: Number as a character string,
is printed / displayed later with right justification
Based on this two parameters and together with the additional information given in squared
brackets the system takes certains data out of the data gram an assigns it to specific
elements (lines in DEF file), and therefore of course to the dBASE file record.
Every data gram contains up to 5 data words (10 bytes) of user data. As a record may
contain more than 5 words normally, several data grams have to be sent. Using sub data
gram numbers provides the possibility to the separate a record and assign it to several (sub)
data grams.
According to the element number the system extracts the value(s) from the data gram(s). If
byond the number of decimal spaces the name of a file has been specified, the system uses
it as a index within the text file to retrieve a text line.
The syntax of the squared brackets [ ... ] is as follows:
[plc number, sub data gram number, element number, data size in words]
or for text files:
[plc number, sub data gram number, element number, 1, “file name”]
Meaning of the different elements:
Element Description
plc number Number of the plc, whose telegram contains a value that is supposed to be
extracted (valid range: 1 - <number of plc’s of system>).
sub data gram Number of the (sub) telegram, which a value is supposed to be taken from
number (valid range: 1 - <number of sub data grams>).
element number Number of the user data element within the data gram, whose value is
supposed to be taken (valid range: 0 ... 4).
data size in words number of user data elements, that are supposed to be read as a value. valid
range:
= 1 for data words
= 2 for data double words
= 1 if a text file name is specified
= 3 if a data / time identifier is specified (‘DT’ or ‘DT1’)
additions-/ ‘+’ the newly received value is added to the old value or
subtraktions ‘-‘ the newly received value is substracted from the old value
flag (optional) or The newly received value is the value taken from the telegram currently
handled.
Text file name: The value in element number corresponds with the text number in the text
(optional) file. if 'RecipeMode=GLOBAL' in SYS.INI, the textfile is read from Folder
WINDCS\TEXTE.X\ …otherwise from Folder WINDCS\PCU.xxx\TEXTE\
Note: Umlauts in text files
To ensure correct processing of Umlauts, parameter Konv=1 must be set in
[KonvChar] of "DB.ini"
date/time: (optional) if the element size 1 is specified and in addition ‘DT’ or ‘DT1’, than the first 3
words (user data) of the data gram is interpreted as a date/time in long or
short format.
DT Æ for example "10.01.1995 12:55:00"
DT1 Æ for example "10.01.1995 12:55"
2.8 Examples
¾ The value 1278 sent via sub data gram 3 (1st user data) is logged at byte offset 55
into the dBASE record.
¾ 55 the beginning of the data type within the definition. This offset starts at 0 and is
incremented.
¾ The next definition begins at 62 as at 55 a data type of size 7 (bytes) is specified.
¾ ‘Weight’ is the column name of the record in the dBASE file.
Remark: Don’t use special characters, e. g. "ß" as in ‘Durchfluß’.
¾ The CINT 7.2 value is supposed to be stored as a number with a maximum of 7
characters (comma included) and 2 decimal places.
¾ [1,3,0,1] describes where the data is located within the data gram. [plc number, sub
data gram number, offset of the first user data word, number of data words].
Additional information is possible, as some other examples show (‘Textliste’, ‚Add’
‚Subtract' etc.).
Annotation: The assignment of a datagram to the DEF file is related to the recipe type.
[REZ_001]
month=00
year=00.
The syntax of the file name results in:
FE_<year>_<month>.DBF (for example FE_00_00.DBF)
Block_Order=50
;Global for all recipetypes. It means, how much datasets get in one
file, dependent on batchno.. (Only for new path-systematic.)
Block_Batch=50
This model may be defined for the individual recipe types as well, by setting the same
switches in the corresponding Areas [Rez_xxx].
[TAB2]
Name = Freies Protokoll: Hand-Daten
PathDat = \FRPROT\FRJA_??\REZ_???\FH_??_??.DBF
List1 = Jahr
List2 = Rezepttyp
Ref3 = 1
List4 = Monat
DEF = \frprot\fhpr_def.def
Typ = 1
[TAB3]
Name = Freies Protokoll: Sende-Daten
PathDat = \FRPROT\FRJA_??\REZ_???\FS_??_??.DBF
List1 = Jahr
List2 = Rezepttyp
Ref3 = 1
List4 = Monat
DEF = \frprot\fspr_def.def
Typ = 1
[TAB4]
Name = Freies Protokoll: Kopier-Daten
PathDat = \FRPROT\FRJA_??\REZ_???\FK_??_??.DBF
List1 = Jahr
List2 = Rezepttyp
Ref3 = 1
List4 = Monat
DEF = \frprot\fkpr_def.def
Typ = 1
[TAB5]
Name = Fr.Prot.: Empfangs-Daten/Neu
PathDat = \FRPROT\FRJA_??\REZ_???\ANR?????\FE_?????.DBF
List1 = Jahr
List2 = Rezepttyp
List3 = Auftr.Nr.-Block
List4 = Chargen.Nr.-Block
DEF = \frprot\fepr_def.def
Typ = 1
[TAB6]
Name = Fr.Prot.: Hand-Daten/Neu
PathDat = \FRPROT\FRJA_??\REZ_???\ANR?????\FH_?????.DBF
List1 = Jahr
List2 = Rezepttyp
List3 = Auftr.Nr.-Block
List4 = Chargen.Nr.-Block
DEF = \frprot\fhpr_def.def
Typ = 1
[TAB7]
Name = Fr.Prot.: Sende-Daten/Neu
PathDat = \FRPROT\FRJA_??\REZ_???\ANR?????\FS_?????.DBF
List1 = Jahr
List2 = Rezepttyp
List3 = Auftr.Nr.-Block
List4 = Chargen.Nr.-Block
DEF = \frprot\fspr_def.def
Typ = 1
[TAB8]
Name = Fr.Prot.: Kopier-Daten/Neu
PathDat = \FRPROT\FRJA_??\REZ_???\ANR?????\FK_?????.DBF
List1 = Jahr
List2 = Rezepttyp
List3 = Auftr.Nr.-Block
List4 = Chargen.Nr.-Block
DEF = \frprot\fkpr_def.def
Typ = 1
[TAB9]
;[TAB10]
;Name = Schrittprotokoll Typ 5
;PathDat = \SRPROT\SRJA_??\REZ_???\ANR?????\S???????.DBF
;List1 = Jahr
;List2 = Rezepttyp
;List4 = Auftragsnummer
;From4 = 3
;To4 = 7
;DEF = \sys\srpdbf.def
;Typ = 2
Note:
Note:
If an error occurs when data are written to the archive, you can perform a diagnosis by
means of the "Tracesvr.exe" program. The cause of error is in most cases found in a faulty
*.def file.
2.12.1 Installation
The MS Access application "PI_CHA32.MDB" (Access 2000 Database format) supplied with
the software package can be used for the evaluation and visualization of *.dbf archive files
stored on the hard disk drive, and to print these data. This file is copied to the new
‘…\windcs\Access32’ folder by the Braumat Setup.
The MS Access Runtime Kit required for opening the MDB file (for users who do not have
the full version of MS Access), is found on the BRAUMAT/SISTAR Classic V5.3 Toolset CD
and must be installed seperately after running the Braumat Setup. Call the MSI setup file:
‘...\sis_sys.53\SISTAR.530_V0503xxxx\MicrosoftMS_AccessRuntime_Office_2003\Accessrt
.msi’.
If an earlier version of Access Runtime (before Access 2000) is installed on your PC, it
should be unistalled first.
If the application should be selectable from the menue, then the appropriate entry in file
‘menuv460.ini’ (in folders ‘texte.0’, ‘texte.1’ and ‘texte.10’ each) have to be integrated, as
explained by the following example:
Example:
[Chapter_3]
Name=Process archive
Desc=Trend view; Step and free protocols; mesages
Bitmap=mnu_archiv.bmp
Applications=6
App1=Trends;kurven.exe
App2=Step logs; srpneu.exe
App3=Free protocols;c:\Program Files\Microsoft
Office\Office11\msaccess.exe /runtime
d:\windcs\access32\pi_cha32.mdb
App4=Message archive; meldarch.exe
App5=Delta logging;proview.exe
App6=Maintenance data;wartdat.exe
Note:
The application is started from the Main menu Æ Register Tab ‘Process archives’ Æ
application ‘Free Protocols’
With menue item Functions Æ Select archive the following dialog box is shown for
selecting the required archive.
You can select the required protocol variant and archive file from the data found according
to the search criteria configured in PROTDIDA.TXT (picture shows the default configuration
at system delivery).
Start by selecting the protocol type from the "Selection" list box. In the next step, the
program generates a dialog, also using the wildcard characters stored in the search path,
until all data of the archive file and the full path name is entered.
Confirm the search item selected in the list box with OK or double-click.
2-30 BRAUMAT/SISTAR Classic V5.3
Logging
A5E00239388-04
Free definable logs
By clicking NEW in the "Archive selection" dialog box, you can directly type in the path in an
input box, instead of selecting it in the selection list box. The function generates an archive
file which does not yet contain any data, according to user specifications.
The file PROTDIDA.TXT is stored in the Braumat system directory SYS. For further
information, please refer to chapter 2.10.
Note:
Protcol variants with the ‘…/New’ extension refer to the Order – Batch folder structure (see
chapter 2.9.3).
Opening the database table
Select the Functions menu, and then select the Archive table command to open the data
records of the archive in continuous (table) format.
(must have been configured by the user)
Opening a form (example: „Formular: Freies Protokoll“)
Select the Functions menu, and then select the Archive form command to open the data
fields of a record in a standard form.
(must have been configured by the user)
Opening a report (example: „Bericht Freies Protokoll“)
Select the Functions menu, and then select the Archive report command to open the data
records of the archive in a report format.
(must have been configured by the user)
Zoom function
The print preview shows only a section of the report, depending on the page format. You
can always open the print preview window to obtain a more detailed view of the printed file.
You can zoom the print preview in and out by double-clicking any area of the report with the
mouse pointer which changes to a magnifying glass form.
Print
The elements described below are available for all applications. The user can preset all
further dataset elements of the archive.
AUFTR_NR Order number
CHARG_NR Batch number
SZ_JAHR Start time: year
SZ_MONAT Start time: month
SZ_TAG Start time: day
SZ_STUNDE Start time: hour
SZ_MINUTE Start time: minute
SZ_SEKUNDE Start time: second
REZ_TYP Name of the recipe type
REZEPT Name of the recipe
The structure of the archive database is determined individually for each log type in a DEF
file (e.g.: FEPRDBF.DEF ffor the log type "Received data"). For information on how to
configure the DEF file, please refer to the configuration manual (see chapter 2.7 )
2.13 Summary
Note the following points for working with Free Protocols:
¾ Datagram 6 must be enabled in a FIFO
¾ The definition files must be created in "windcs\frprot" (see section 2.7).
Fepr_xxx.def xxx = recipe type (range = 1 to 255)
You can copy and edit the fepr_def.def template file.
¾ The data of datagrams type 6 in the controls must be programmed by calling
FB<Free Protocols> in DB<Free Protocols>. (see section 2.4)
S7 controller FB 580/DB580 with iFunction > 0 e.g. 7
S5 controller FB 80/DB80 with type > 0 e.g.. 7
After you have entered a maximum of five values, transfer these data in a datagram
subset (see item 5), and then continue with the data for the next datagram subset.
¾ In the controls, the datagrams type 06 must be initialized for each datagram subset
by calling the FB<Free Protocols> (see section 2.4)
S7 controller FB 580 with iFunction=0
S5 controller FB 80 with type=0
¾ These datagrams are generating Dbase files in
Windcs\frprot\frja_YY\rez_XXX\fe_MM_YY.dbf:
YY = year set in the datagram
XXX = recipe type set in the datagram
MM = month set in the datagram
¾ In order to view the archived datagrams by menas of the Free Protocols application,
the according DEF file must be defined in "windcs\sys\protdida.txt"
3.1 General
As a lot of information is already included in stepping logs, a selection can be applied via a
filter table to additionally select and store a subset from them as 'Free def. Log data' instead
of sending the same information twice (via stepping and via free def. logs).
3.3 Installation
To install and enable the functionality "Free def. logs by stepping logs’, you must do the
following:
¾ Copy files (see below)
¾ Modify ini file switch in ..\windcs\sys\SRPROT5.INI file
[SR_FRPT]
ForwardDGrams = 1/0
¾ Create the filter table
¾ Create the assignment table PCU/TA to recipe type number
"dd.mm.yyyy hh:mm"
3 and 4, when start-up or
end time
PARAMTYPE = GOP
5 time =, format
"hhhh:mm:ss"
6 time =, format
"hhhh:mm"
5 and 6 when
PARAM_IDX = 0 (Step
operating time) and
PARAMTYPE = 0/1
(setpoint-/Actual value)
Z SPALTENAM Character Field name (Name of the --- --- CHAR 9
string column) of the parameter
in the db-File, "CIS day
name" describes unique a
column of the above table
Z TEXTDATEI Character Text file name without --- --- CHAR 9
string TXT extension
Only available, when text
DATA_TYPE =, is ignored
else
Legend:
¾ The step number is not evaluated currently, as it is not included in a step data gram
in the current version of BRAUMAT/SISTAR Classic V5.3 – therefore it cannot be
used as filter criteria at the moment !
¾ A line within the filter table describes always only one data item from a step
telegram. If for example several DFMs setpoint and/or actual values of the same
GOP are supposed to be stored, several lines must be configured within the table.
¾ The Filter-DFM, means the number of the DFM is only necessary, if a Filter-ID was
indicated (Filter-ID > 0), otherwise both values are ignored.
¾ plc-number (PCU_NR), GOP-number (GOP_NR), recipe type (RTYP_NR) and
recipe number (=recipe number, GR_NR) are ignored if they are 0. If they are larger
than 0, they are used as a filter criterion.
¾ The type of parameter (PARAMTYPE) and parameter index (PARAM_IDX) indicate
which data element is supposed to be stored from the step telegram.
¾ The parameter index is only relevant if the type of the parameter indicates an actual
or set point value to be stored.
¾ The parameter table type (TABLETYPE) and column name (COLNAME) of the filter
table indicate, where the value from the step telegram is supposed to be stored to.
The data type (DATATYPE) indicates in which format the value is stored. If the data
type "text" is specified, also the parameter "text file name" (TEXTFILE) has to be
configured. The value from the step telegram is taken as an index within the given
text file. The character string from the text file is stored in the dBASE files of the
Free def. log and not the value itself.
¾ Old value: Value from dBASE file (Value which is read from record)
¾ New value: Value for dBASE file (Value which is written in record)
¾ Value from telegram: Value from the step telegram
The keys, that start with the prefix "DG_" are independent of each other. They can be used
to trace individual parameter from a step telegram.
[GenFrPr]
;0 = Tracing disabled; 1 = Tracing enabled
TraceToFile=0
;default trace file name if other trace file name couldn't be
generated, see key TraceToFile
TraceFileName=c:\tmp\genfrpr.txt
;Tracing of messages during check, whether a datagram is important
(data from step data gram should be saved as free protocol data), 0
= Tracing disabled; 1 = Tracing enabled
TraceFilterMsg=0
;0 = tracing disabled, 1 = Tracing enabled; tracing of all software
exceptions in module GenFrPr.C
ExceptLoggingOn=0
;0 = Don't display; 1= Display a message box if an internal software
exception occurs in module GenFrPr.c
ExceptShowMsgBox=0
;trace file name where information will be stored, if an internal
software exception occurs in module GenFrPr.c
ExceptFileName=c:\tmp\FrPrExc.txt
;0 = Tracing disabled; 1 = Tracing enabled; Tracing of time stamps
during evaluation of step datagram
TraceTimeStamp=0
;0 = Don't fill dynamically, 1=Fill dynamically Filtertable with
recipe type number, based on recipe type number of step datagram
FillFilterTableDynamic=0
;1=Trace step data gram if it isn't relevant, 0=don't trace it
TraceIfNotFound=0
;1=Trace step data gram type, 0=don't trace it
DG_Typ=0
;1=Trace plc nr of data gram, 0=don't trace it
DG_PCU=0
;1=Trace data gram time stamp, 0=don't trace it
BRAUMAT/SISTAR Classic V5.3 3-5
Logging
A5E00239388-04
Creating free protocols based on Stepping logs
DG_TelTime=0
;1=Trace path year param of step data gram, 0=don't trace it
DG_PathYear=0
;1=Trace recipe type of step data gram, 0=don't trace it
DG_RezTyp=0
;1=Trace recipe number of step data gram, 0=don't trace it
DG_RezNr=0
;1=Trace order number of step data gram, 0=don't trace it
DG_AuftragsNr=0
;1=Trace batch number of step data gram, 0=don't trace it
DG_ChargeNr=0
;1=Trace unit number of step data gram, 0=don't trace it
DG_TeilanlNr=0
;1=Trace data set length of step data gram, 0=don't trace it
DG_DSLen=0
;1=Trace start time of step, 0=don't trace it
DG_StartTime=0
;1=Trace end time, 0=don't trace it
DG_EndTime=0
;1=Trace GOP number, 0=don't trace it
DG_GOPNr=0
;1=Trace set point time (Sollzeit) of step data gram, 0=don't trace
it
DG_SollZeit=0
;1=Trace (Istzeit) of step data gram, 0=don't trace it
DG_IstZeit=0
;1=Trace number, set point and actual value dfm's of step data gram,
0=don't trace it
DG_DFM=0
;Path for trace files, name will be generated automatically, e.g.
c:\tmp\genfrpr_xxxxxxxx.txt
TraceFilePath=c:\tmp
;max file size for each trace file
TraceSplitSize=65536
;or'd bits,1=norm.msg,2=wrns,4=err,8=err level2,16=fatal
errors,32=filter,64=filter warnings,128=filter errors,256=function
begin,512=fct end,1024=err def file,2048=dmp tbl,4096=lock
line,8192=info
TraceCat=29
In the log file the following appears (depending on which keys have been set to 1):
-----------------------------------------------------
DGram isn't relevant, additional information follows...
cTyp = 5
cPCUNr = 99
3-6 BRAUMAT/SISTAR Classic V5.3
Logging
A5E00239388-04
Creating free protocols based on Stepping logs
ANZ-DFM= 13
NR = 1 SOLL = 1 IS = 2
NR = 2 SOLL = 1 IS = -1
NR = 3 SOLL = 4567 IS = -4567
NR = 4 SOLL = -2147483648 IS = -2147483648
NR = 221 SOLL = 1234567890 IS = -1234567890
NR = 276 SOLL = 1234567890 IS = -1234567890
NR = 331 SOLL = 1234567890 IS = -1234567890
NR = 386 SOLL = 1234567890 IS = -1234567890
NR = 441 SOLL = 1234567890 IS = -1234567890
NR = 496 SOLL = 1234567890 IS = -1234567890
NR = 551 SOLL = 1234567890 IS = -1234567890
NR = 606 SOLL = 1234567890 IS = -1234567890
NR = 661 SOLL = 1234567890 IS = -1234567890
--------------------------------------------------------
Telegram is not relevant and is skipped by ForwardSchrittDGram
3.6 Examples
Limits
The cases 1 and 2 are currently covered by the functionality described here. In case 3 and
4, the multiplied GOP's can not be distinguished since in the recipe procedure only one
GOP exists.
Via the step number these GOP's can not be distinguished since the step number is not
part of the step telegram.
Even via the mechanism of the Filter-DFMs and the Filter-ID this GOP's can be
distinguished!
Saving the start time of a specific GOP which appears only once in all sequences of a plc
Saving the end time of a specific GOP, that appears in several sequences (of the same
plc!) (filter DFM is DFM 3.255)
F PCU_NR Yes 3
F UNIT_NR Yes 30
F GOP_NR Yes 199
F GR_NR Yes 1000
F FILTER_ID Yes 10.000 Because GOP appears several times in
all sequences.
F FILTER_DFM Yes 1.023 The GOP is taken, which uses this
FILTER_DFM, all other GOP's with the
same GOP-number must not use this
FILTER_DFM
Æ 3.255 =
3*256 + 255 = 1.023
Q PARAMTYPE Yes 3 end time of the GOP
Q PARAM_IDX No 0 Because PARAMTYPE is neither 0 nor 1
(Actual or setpoint value)
Z DATA_TYPE Yes 3 time
Z COLNAME Yes "Finish at" Always necessary
Z TEXT FILE No "" not used,
because finish at is not reasonable as an
index in a text file
Saving the actual value of the fourth DFMs (DFM number = 2.44) of a GOP which appears
only once in the sequences of the plc
stepping protocol
handler GENFRPR.DBF /
filter table DEF
(SRPROT5.DLL)
filter table
description
of a
filter criteria,
datagrams type 5 table of the
source,
"free protocols"
destination
FEPR_<TableType
call check, whether
handler for datagrams Nr>.DEF
datagram is relevant
yes/no
create a get
'free protocol' record text by index
WINDCS/TEXT.0/
xxx.TXT
WINDCS/FRPROT/
FRJA_97/REZ_001/
FE_00_09.DBF
4 Step logging
4.1 Overview
The setpoint and actual values of the process (units), quantities, temperatures and so on
and information about the executed unit operations are stored in files chronologically. The
storing of the data is done after a step change has finished.
The data are stored into dBASE files. The order and batch number are unique keys to the
stored batch data.
The batch data can be printed at any time or deleted. A complete batch print-out can be
activated also about the PCU. M101.2 (SRDR) must be set for this purpose via the flag
M102.3 (GSTO) in the last unit operation of a batch. Step logging program
4.2.1 Functionality
The Step logging program is used to view and print Stepp log files.
Client area
Select File -> Open, then press F2 or click the OPEN FILE button to open the Select step
log file dialog box.
Options available:
- Year
- Recipe type
- Order number
- Batch number
- Unit
Start by selecting the year, the order number and the recipe type. Double-click the required
batch number to open the unit selection under Unit / PCU (area).
Confirm your selection with OK.
Printing step log files
Select File -> Print, then press F4 or click the PRINT FILE toolbar button to open a dialog
box for setting up the following functions:
Print:
- Log file of the selected unit
- All unit log files
Deleting step log files
Select File -> Delete, or double-click the DELETE FILE toolbar button to delete logs
from the hard disk drive. Select the log files to be deleted in the dialog box.
Order in which you select log files you want to delete:
- Year
- Recipe type
- Order number
- Bathc number
Access to the Delete log files menu can be password protected.
Input of comments
Select Options -> Comment, or press F10 to open the comment file for the current batch
number.
5.1 Overview
The system is logging operator activities on process as well as changes in parameterization
and the recipes. The changes are structured like messages and stored in dBASE files.
This function covers.
¾ local logging of changes on a client and/or on a server
¾ Recording of a unit history
¾ Joining several local files into one ‘global’ file
¾ Apply batch relation to changes
Unit history
The history is recorded from the unit data image. The following changes are logged:
¾ Unit starts (leaving step 0 and going to a step unequal to 0; start and allocation)
¾ Unit terminates (goes from step not equal to 0 into the step 0; end and de-allocation)
¾ Unit changes its operation mode (automatic or manual)
¾ the fault indicator of the unit changes its status
¾ the running condition of the unit changes its status
Client PC client PC
recipe server
PCU-Server
recipe control
batch control
S7 channel
batch start
unit image
combining logs
(globlog.dll)
unit history
...windcs\logging\unithist\... offline data block image global log files
...windcs\logging\globlog\...
The changes are stored on every client temporarily. On every AREA server a service is
running, which combines the clients changes referred to this AREA and applies the batch
relation (if possible). The offline data blocks are used to get the batch information.
stem
to
log on
w
en rite
the sy
try
da writ
ta e
se
t
All applications of BRAUMAT/SISTAR Classic V5.3 store changes done on a client via a
function (userlog.dll) into files of the system folder. The user currently logged in and the local
time of the client IOS is added to the log file.
Enable user logging on a client
File: windcs\sys\logging.ini
[Global]
EnableUserLogging=1
changes
e
ref unit
nc
ere
PMS
interface
On the server a service is running which combines the changes for that AREA done on the
clients. On the server also the unit history dll runs. For all changes related to objects with a
unit reference (ICMs, regulators...) the batch information is added. For that, the unit
assignments are read from the offline data blocks. If objects are assigned to units in a
dynamic way, it is not possible yet, to get the correct batch reference.
Note!
File: windcs\sys\Logging.ini
[Global]
EnableUnitHistory=1
Location of the files
The files are stored in the folder '…\windcs\logging\unithist\...'. Subdirectories are created
per year (..\UH_YY). Within a ‘year’ directory a file is created per day (UHYYMMDD.dbf).
Example: ‘..\windcs\logging\unithist\UH_02\UH021221.dbf’
File: ‘...\windcs\sys\logging.ini’
[GlobLog]
CycleTime=10
Deactivation of the globlog.dll
The server function can be disabled via a key, which is read also at runtime - a restart of the
pcu-server is not necessary.
File: ‘…windcs\sys\logging.ini’
[Global]
EnableGlobalLogging=0
Note:
The change log service is running only when the ‘Recipe-Server’ mode is activated on the
Server-IOS. Consequently only the active server on a redundant server pair runs that
service.
Data storage
The user log and unit history files are combined to a global file called ‘globlog.dbf’ – which is
stored into the folder ‘…\windcs\logging\globlog\GL_YY\...’ with the file name
GLYYMMDD.dbf.
Redundancy
On a redundant system the data is copied to the standby machines by the active server. The
necessary path specificationsfor are read from the area.ini.
Changes to data records of the block-classes (old- and new values each) via the
parametrization application ‘param.exe’ are recorded. However, this concerns the ‘Online
mode’ of parameterization only.
Note on text parameterization
In the faceplates of the runtime process images ‘LzSys.exe’ all parameter or value changes
of the linked valiable tags or block classes are logged with old- and new values each.
Particularly the following controls are concerned:
¾ Analog.ocx/Analog2.ocx
¾ Controller.ocx
¾ Digital.ocx
¾ ICM.ocx
¾ UnitCtrl.ocx
¾ SmartUnit.ocx
Recipes
5.6.1 Selection
The day of the changes is selected via 'open day archive'.
¾ button ‘Reload’
Via this button the currently selected day archive is reloaded and the field ‘last
actualization’ is set.
¾ Filter
A filter can be applied to one column at a time, where ‘Only whole words’ or ‘Match
case’ may be selected.
¾ Selection ‘Set filter'
The filter becomes effective.
¾ Selection 'Show all'
The filter is disabled and all changes of the day are now listed.
5.6.3 Printing
The selected columns can be printed on the standard printer.
About the menu item 'printer setup' a different printer can be selected.
Modification Priority ID
RP production enables status is Maximum 32767
set or reset
RP type modified 70
TRP deleted 60
New TRP added 50
TRP deleted 40
New RUP added 30
Recipe updateed 20
6 What to do on errors?
6.1 General