08-May-2013
ReleaseNotes
4.0.1 b4
Page 1 of 18
SapMes Interface
Release-Notes
for Version
4.0.1 b4
SapMes Interface Release-Notes 4.0.1 b4.odt
ReleaseNotes
08-May-2013
SapMes Interface
4.0.1 b4
Page 2 of 18
Table of Contents
1 System Requirements....................................................................................................................................................... 4
1.1 Operating Systems and Database.................................................................................................................................... 4
1.1.1 Server Platforms............................................................................................................................................................ 4
1.2 camLine Components....................................................................................................................................................... 4
1.3 Other Components........................................................................................................................................................... 4
1.4 Third-Party-Components, Tools and Libraries................................................................................................................... 5
2 Required Files.................................................................................................................................................................... 6
2.1 Application Server............................................................................................................................................................. 6
2.1.1 Binaries / Components.................................................................................................................................................. 6
2.1.2 Scripts and Configuration Files...................................................................................................................................... 7
2.1.3 Scripts and Configuration Files...................................................................................................................................... 7
2.2 Documents........................................................................................................................................................................ 8
3 New Features and Changes ............................................................................................................................................. 9
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
3.9
3.10
3.11
3.12
New Features and Changes in Release 4.0.1 b4............................................................................................................. 9
New Features and Changes in Release 4.0.1 b3............................................................................................................. 9
New Features and Changes in Release 4.0.1 b2............................................................................................................. 9
New Features and Changes in Release 4.0.1 b1............................................................................................................. 9
New Features and Changes in Release 4.0.1 RC b2....................................................................................................... 9
New Features and Changes in Release 4.0.1 RC b1....................................................................................................... 9
New Features and Changes in Release 4.0.0 RC b4..................................................................................................... 10
New Features and Changes in Release 4.0.0 RC b3..................................................................................................... 10
New Features and Changes in Release 4.0.0 RC b2..................................................................................................... 10
New Features and Changes in Release 4.0.0 RC b1..................................................................................................... 10
New Features and Changes in Release 4.0.0 Preview2 b1............................................................................................ 10
New Features and Changes in Release 4.0.0 Preview1 b1............................................................................................ 10
4 Fixed Problems................................................................................................................................................................ 12
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
4.10
4.11
4.12
Problems Fixed in Release 4.0.1 b4............................................................................................................................... 12
Problems Fixed in Release 4.0.1 b3............................................................................................................................... 12
Problems Fixed in Release 4.0.1 b2............................................................................................................................... 12
Problems Fixed in Release 4.0.1 b1............................................................................................................................... 12
Problems Fixed in Release 4.0.1 RC b2......................................................................................................................... 12
Problems Fixed in Release 4.0.1 RC b1......................................................................................................................... 13
Problems Fixed in Release 4.0.0 RC b4......................................................................................................................... 13
Problems Fixed in Release 4.0.0 RC b3......................................................................................................................... 13
Problems Fixed in Release 4.0.0 RC b2......................................................................................................................... 14
Problems Fixed in Release 4.0.0 RC b1......................................................................................................................... 14
Problems Fixed in Release 4.0.0 Preview2 b1................................................................................................................ 14
Problems Fixed in Release 4.0.0 Preview1 b1................................................................................................................ 14
5 Known Problems.............................................................................................................................................................. 15
ReleaseNotes
08-May-2013
SapMes Interface
4.0.1 b4
Page 3 of 18
6 Upgrade............................................................................................................................................................................ 16
6.1 Upgrading from Release 4.0.1 b3.................................................................................................................................. 16
6.1.1 Server upgrade............................................................................................................................................................ 16
6.2 Upgrading from Release 4.0.1 b2.................................................................................................................................. 16
6.2.1 Server upgrade............................................................................................................................................................ 16
6.3 Upgrading from Release 4.0.1 b1.................................................................................................................................. 16
6.3.1 Server upgrade............................................................................................................................................................ 16
6.4 Upgrading from Release 4.0.1 RC b2............................................................................................................................ 16
6.4.1 Server upgrade............................................................................................................................................................ 16
6.5 Upgrading from Release 3.12.1 RC b13........................................................................................................................ 17
6.5.1 Server upgrade............................................................................................................................................................ 17
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 4 of 18
1 System Requirements
1.1 Operating Systems and Database
1.1.1 Server Platforms
For the standard release procedure of SapMes Interface we usually provide server binaries for a single
OS platform / database combination. The following table lists all server platforms, database versions
and client systems that can be supported on request.
Operating System
Java Runtime Version
Database Version
Remarks
Suse Linux Enterprise Server 10
SUN JRE 1.6.0_13
or a newer 1.6.0_xx
Oracle 10.2.0
Suse Linux Enterprise Server 11
SUN JRE 1.6.0_13
or a newer 1.6.0_xx
Oracle 11.2.0
Server Operating Systems
(additional systems can be
supported on demand)
Min. 2 GB memory,
5 GB available hard disk
space for installation;
additional
space
for
database
1.2 camLine Components
Name
Version
Remarks
CAPS
2.0.10
Middleware
MPM
1.1.1b1
Monitoring system.
WIP
5.0.0 RC b2 or higher
Work In Process
MAMA
1.6.0_RC_b1 or higher
Material Management
EMAC
1.2.5
Equipment Management
1.3 Other Components
These are software packages from third party vendors required to be installed with the proper version.
Name
Version
Remarks
Oracle
as specified above Oracle database Server and OCI support
JRE
as specified above Java Runtime Environment
IBM WebSphere MQ
6.0.2
Messaging backbone for SOA connectivity
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 5 of 18
1.4 Third-Party-Components, Tools and Libraries
The following tools, libraries and components (commonly referenced as 3rd-Party libraries) from
other vendors or from open source projects are used by the system. For each 3rd-Party library the
name, the version, a short description and the type of license is given in the table below:
Name
Version
Description
License / Copyright
JACORB
2.2.3
Object Request Broker
LGPL 2.0
Castor
0.9.9
XML Java binding
http://www.castor.org/license.html
Commons
logging
1.0.4
Logging API
Apache
(http://excalibur.apache.org/license.html)
Junit
3.4
Java Unit Test Framework
http://www.opensource.org/licenses/cpl.php
LOG4J
1.2.8
Logging Service
Apache
http://www.apache.org/licenses/LICENSE-2.0
LOGKIT
1.4
Logging Service
Apache
http://www.apache.org/licenses/LICENSE-2.0
XERCES
2.4
XML Parser
Apache
http://www.apache.org/licenses/LICENSE-2.0
Java Mail API
Sun
https://glassfish.dev.java.net./public/BinariesLicen
se.html
Java-based build tool.
Apache
http://www.apache.org/licenses/LICENSE-2.0
Mail
ANT
2.0
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 6 of 18
2 Required Files
These are the files contained in the SapMes Interface package. All other files are contained in the
referenced sections camLine Components and Third-Party-Components, Tools and Libraries . They
shall be installed under the installation directory. Under a Windows OS the installation directory
typically could be C:\Program Files\camLine. Under a Unix based OS the installation directory
typically could be $HOME/camLine.
2.1 Application Server
$CAMLINE_HOME=/app/camline
2.1.1 Binaries / Components
Under the installation directory, the sapmes directory is contained, which will contain these files:
Path/File
Label
Flag (new/
changed/delet
ed)
./bin
V_4_0_1_b4
Server binary and server start-/stop
scripts.
./bin/smi_file
V_4_0_1_b4
Startup script for SapMes Interface
under Unix, in file mode.
./bin/smi.sh
V_4_0_1_b4
Startup script for SapMes Interface
under Unix.
./bin/smi.start
V_4_0_1_b4
Startup script for SapMes Interface
under Unix as CAPS service
./bin/smi.stop
V_4_0_1_b4
Stop script for SapMes Interface
under Unix, started as CAPS service.
./bin/matmas
V_4_0_1_b4
SapMes maindata initialization script.
./bin/sapmes_classpath
V_4_0_1_b4
./bin/master.inline
V_4_0_1_b4
Master inline file for the SAPMES
environment
./config
V_4_0_1_b4
Server configuration files.
./config/config.xml
V_4_0_1_b4
Server configuration file.
/config/jacorb.properties
V_4_0_1_b4
/config/sapmes.cfg
V_4_0_1_b4
./lib
V_4_0_1_b4
/log
V_4_0_1_b4
Directory for logging details.
/log/in
V_4_0_1_b4
Directory where all the files received
from SAP via MQ are saved.
changed
Remarks
Classpath script, used in all the others
startup scripts.
Configuration file for log4j logging
system
changed
Directory for used jar files.
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 7 of 18
/log/out/data
V_4_0_1_b4
Directory in which are saved files send by
SapMes to SAP via MQ.
log/out/response
V_4_0_1_b4
Directory in which are saved files send by
SapMes to SAP via MQ.
./sql
V_4_0_1_b4
Directory with SQL scripts that are used
by the installer to create buffer table in
wip tablespace.
./xsd
V_4_0_1_b4
Directory for XSD schema files.
/xsd/sampmes.xsd
V_4_0_1_b4
XML
Schema
file
communication files.
/xsd/config.xsd
V_4_0_1_b4
XML Schema
configuration.
/maindata
V_4_0_1_b4
Directory for main data files.
/maindata/makt.txt
V_4_0_1_b4
Material main data file, provided by SAP.
/maindata/mara_c.txt
V_4_0_1_b4
Material main data file, provided by SAP.
/maindata/tspat.txt
V_4_0_1_b4
Material main data file, provided by SAP.
/maindata/t023t.txt
V_4_0_1_b4
Material main data file, provided by SAP.
/
V_4_0_1_b4
maindata/structure_of_fil
es.txt
File describing the structure of the
material main data files.
file
for
for
SAP
SapMes
2.1.2 Scripts and Configuration Files
Path/File
Label
~/lib/sapmesV_4_0_1_b4.jar V_4_0_1_b4
Flag (new/
changed/deleted)
Remarks
New
SapMes Interface jar.
2.1.3 Scripts and Configuration Files
Path/File
Label
Flag (new/
Remarks
changed/deleted)
~/sql/transfer_buffer.sql
V_4_0_1_b4
SQL File that will create database
environment for SapMes Interface on
WIP tablespace.
~/sql/create_table.sql
V_4_0_1_b4
SQL Script to create tables for table
interface functionality
~/sql/v_wip_partslist_def.sql V_4_0_1_b4
SQL File that will create an view on
WIP tablespace.
~/sql/sapmes_add_constraint V_4_0_1_b4
s_20060905.sql
SQL File for SapMes upgrade.
~/sql/sapmes_wip_V_4_2_5. V_4_0_1_b4
sql
SQL File for SapMes upgrade.
~/sql/sapmes_V_3_11_1_RC V_4_0_1_b4
_b1.sql
SQL File for SapMes upgrade.
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 8 of 18
~/sql/sapmes_V_3_12_1_Pre V_4_0_1_b4
view1_b1.sql
SQL File for SapMes upgrade.
~/sql/sapmes_V_3_12_1_RC V_4_0_1_b4
_b1.sql
SQL File for SapMes upgrade.
~/sql/sapmes_V_3_12_1_RC V_4_0_1_b4
_b4.sql
SQL File for SapMes upgrade.
~/sql/sapmes_V_4_0_0_Prev V_4_0_1_b4
iew2_b1.sql
SQL File for SapMes upgrade.
~/sql/sapmes_V_4_0_1_RC_ V_4_0_1_b4
b1.sql
SQL File for SapMes upgrade.
2.2 Documents
Base Path = HOME_CAMLINE/install/doc/
Path/File
Label
./sapmes/doc/SAPMES_Admin
_Guide_V_4_0.pdf
Rev 1.2
10/2011
Flag (new/
changed/deleted)
Remarks
SAPMES Administrators Guide
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 9 of 18
3 New Features and Changes
3.1 New Features and Changes in Release 4.0.1 b4
No new features were added.
3.2 New Features and Changes in Release 4.0.1 b3
No new features were added.
3.3 New Features and Changes in Release 4.0.1 b2
No new features were added.
3.4 New Features and Changes in Release 4.0.1 b1
No new features were added.
3.5 New Features and Changes in Release 4.0.1 RC b2
Identifier
Component
Summary
SAPMES-99 SapMes Interface Insert rows with status information for received IDOCs with TYPE = '-1'
Every inbound response message has now in table interface type -1
3.6 New Features and Changes in Release 4.0.1 RC b1
Identifier
Component
Summary
SAPMES-92 SapMes Interface change the PRDAT (Manufacturing date) to optional
SAPMES-95 SapMes Interface New handling of unidentified units in sapmes_notify trigger
Added a new Oracle Sequence . Use the number from this Sequence as
unit_id (string) in the back flush buffer table (unit_id_type may remain a '-').
The Sequence is used only if the trigger detects subsets with Unit_Id and
Unit_Id_Type == '-'.
SAPMES-97 SapMes Interface add new transaction types from wip 5
SAPMES-90 SapMes Interface Avoid connection to write queues if the read one is not accessible
If error code returned is 'object_in_use', SapMes stops.
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 10 of 18
3.7 New Features and Changes in Release 4.0.0 RC b4
No new features were added.
3.8 New Features and Changes in Release 4.0.0 RC b3
No new features were added.
3.9 New Features and Changes in Release 4.0.0 RC b2
No new features were added.
3.10 New Features and Changes in Release 4.0.0 RC b1
Identifier
Component
Summary
SAPMES-84 SapMes Interface Support for 4digits long control keys
All the keys starting with "ME" are considered old key, and for this ones only
the first 3 characters are considered during request processing.
SAPMES-85 SapMes Interface Suppress error partslistdef position overflow flag
Added new element PartslistdefPositionOverflow
SuppressError, under element SAPMESConfig.
Possible values for this attribute are "Y" and "N".
with
According to Functional Specification SapMes 3.13.0 from 25.01.2012
3.11 New Features and Changes in Release 4.0.0 Preview2 b1
The main features added in this version are:
Booking scrap for RAW and SEMI material
Store information regarding production line in MES
Time zone in the XML files
Usage of interface table
Define multiple Plants/Destinations in config.xml
, according to Functional Specification for SapMes Interface version 1.3 from 10.10.2011.
3.12 New Features and Changes in Release 4.0.0 Preview1 b1
The main features added in this version are:
Additional field KTSCH for element E1FVOL
attribute
ReleaseNotes
08-May-2013
SapMes Interface
Enhanced Routing extension
Storage of PDC_NUMBER for backflush trace back
Separate backflush-messages for yield and scrap
4.0.1 b4
Page 11 of 18
, according to Functional Specification for SapMes Interface version 1.1 from 10.08.2011.
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 12 of 18
4 Fixed Problems
4.1 Problems Fixed in Release 4.0.1 b4
Identifier
Component
Summary
SAPMES-114 SapMes Interface Update in "WSMQ"."T_SAPMES_MESSAGES"."STATXT" field exceeds
the column length
Limited to 200 chars.
SAPMES-118 SapMes Interface NPE in sapmes 5 for MQ mode
Update table entry with error only when sapmes is using table interface (not
in mq mode)
4.2 Problems Fixed in Release 4.0.1 b3
Identifier
Component
Summary
SAPMES-108 SapMes Interface Backflush update jobs statement should be improved.
Changed update statement by adding a new condition in the where clause:
update sapmes_progress_buffer set reported = 'Y' where
and reported = 'N'
4.3 Problems Fixed in Release 4.0.1 b2
Identifier
Component
Summary
SAPMES-105 SapMes Interface Matlabel (PDF417) booking action code 4 problem deleting container
Set part_id for action code 4 (delete container) as following:
ZMESMSEG.MATNR + '@' + ZMESMSEG.LIFNR + '@' +
ZMESLQUA.EXIDV
4.4 Problems Fixed in Release 4.0.1 b1
No bug fixes.
4.5 Problems Fixed in Release 4.0.1 RC b2
Identifier
Component
Summary
SAPMES-98
SapMes Interface table interface fails with 'maximum open cursors exceeded'
There were still some unclosed cursors.
SAPMES-100 SapMes Interface log4j warn when sapmes run in file mode
added -Dlog4j.configuration=../config/sapmes.cfg parameter to smi_file
script
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 13 of 18
SAPMES-101 SapMes Interface table interface - no email is sent in case of validation error
entry ID is used as xml file name sent as attachment in notification email for
validation issues
SAPMES-102 SapMes Interface no reconnect to MQ after MQ Manager restart
The reconnect condition was wrong, not it tries to reconnect is message was
not sent.
4.6 Problems Fixed in Release 4.0.1 RC b1
Identifier
Component
Summary
SAPMES-89 SapMes Interface Use sapmes.pid file to avoid starting two instances
sapmes.pid file and its functionality is now back in use.
It's usability prevents from starting two instances from two different nodes.
SAPMES-91 SapMes Interface PDF 417 Booking - not working
LENUM attribute was defined as optional, but in the same time having a
constraint defined to a size of minimum one char, and maximum 20 chars.
The constraint on size is now removed.
SAPMES-96 SapMes Interface in table interface mode only one request is processed per poll
select all unprocessed row in one cycle
4.7 Problems Fixed in Release 4.0.0 RC b4
Identifier
Component
Summary
SAPMES-88 SapMes Interface equipment check failure when blocks are included in process plan
For blocks of free steps a virtual process step is used with empty string as
equipment name. Now empty names for equipments are not sent to EMAC
server anymore.
4.8 Problems Fixed in Release 4.0.0 RC b3
Identifier
Component
Summary
SAPMES-87 SapMes Interface sapmes takes only 1 piece from queue of every 5 minute.
The sleep interval should have been active only for table interface
functionality wrong condition was used.
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 14 of 18
4.9 Problems Fixed in Release 4.0.0 RC b2
Identifier
Component
Summary
SAPMES-86 SapMes Interface Missing rework connection in process plan
Rework connection was added to wrong index in next step map.
SapMes Interface Correct primary key name for t_mes2mes_messages table
4.10 Problems Fixed in Release 4.0.0 RC b1
Identifier
Component
Summary
SAPMES-83 SapMes Interface application does not stop completely when stop script is called
Changed start/stop scripts and add in code additional shutdown method - to
make sure all started threads are finished nicely.
SapMes Interface Some fixes for the database connection functionality.
4.11 Problems Fixed in Release 4.0.0 Preview2 b1
No bug fixes.
4.12 Problems Fixed in Release 4.0.0 Preview1 b1
Identifier
Component
Summary
29055
SapMes Interface
MES SAP backflushing has 3 less qty than booked in SAP
An configuration parameter was added for the backflush to configure the
backflush delay in seconds timesliceDelay, with a default value of 10
seconds.
In previous build we had this delay set to a fixed value of 10 seconds.
ReleaseNotes
08-May-2013
SapMes Interface
5 Known Problems
Identifier
Summary
25930
Problem with SAPMES V_3_9_4 and Backflushing-Step
23129
If SAP backflashing NOK in SAP, you don't have any error messages in MQ
23124
Wrong backflashing because of transitions <progress;repeat> and <loss>
26110
Backflush problem 3
4.0.1 b4
Page 15 of 18
ReleaseNotes
08-May-2013
SapMes Interface
6 Upgrade
6.1 Upgrading from Release 4.0.1 b3
6.1.1 Server upgrade
The following steps have to be performed for upgrading the server:
Stop running server
Add new sapmesV_4_0_1_b4.jar to server lib folder, and remove old jar file.
Edit the classpath in the sapmes_classpath script to use the new jar file
Start server.
6.2 Upgrading from Release 4.0.1 b2
6.2.1 Server upgrade
The following steps have to be performed for upgrading the server:
Stop running server
Add new sapmesV_4_0_1_b3.jar to server lib folder, and remove old jar file.
Edit the classpath in the sapmes_classpath script to use the new jar file
Start server.
6.3 Upgrading from Release 4.0.1 b1
6.3.1 Server upgrade
The following steps have to be performed for upgrading the server:
Stop running server
Add new sapmesV_4_0_1_b2.jar to server lib folder, and remove old jar file.
Edit the classpath in the sapmes_classpath script to use the new jar file
Start server.
6.4 Upgrading from Release 4.0.1 RC b2
6.4.1 Server upgrade
The following steps have to be performed for upgrading the server:
4.0.1 b4
Page 16 of 18
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 17 of 18
Stop running server
Add new sapmesV_4_0_1_b1.jar to server lib folder, and remove old jar file.
Edit the classpath in the sapmes_classpath script to use the new jar file
Start server.
6.5 Upgrading from Release 3.12.1 RC b13
Basically the SapMes Interface 4.0.1 b4 is backward compatible to 3.12.1 RC b13.
6.5.1 Server upgrade
The following steps have to be performed for upgrading the server:
Stop running server
If you want SAPMES to use Table Interface instead of MQ connection following steps have to be
performed:
create sapmes tablespace and run script create_tables
change connection details in config.xml file by replacing element MQConnection with and
TableConnection element:
<TableConnection
name="sapmes"
url="jdbc:oracle:thin:@localhost"
poll_interval="300" where=""/>
driver="oracle.jdbc.driver.OracleDriver"
user="user"
password="password"
Adjust in config.xml file the new Control Keys and corresponding roles
Add in config.xml file the configuration details for the backflush threads:
yields backflush: <BackflushWorker timeslice="15" timesliceDelay="10" />
scrap backflush: <BackflushScrapWorker timeslice="15" timesliceDelay="10" />
material backflush: <MaterialWorker timeslice="15" timesliceDelay="10" />
Add in config.xml file in SAPMESConfig element as fallows, just after element Administrator:
<PartslistdefPositionOverflow SuppresError="Y"/>
Add new sapmesV_4_0_1_b1.jar to server lib folder, and remove old jar file.
Add new utility jar files,
mama_server_V_1_7_0_RC_b1.jar
emac_server_V_1_2_6_RC_b1.jar
wip_server_V_5_0_0_RC_b1.jar
And remove the old ones
jacorb_emac_V_1_2_4b8.jar
jacorb_mama_V_1_6_0.idl.jar
jacorb_wip_V_4_5_2.idl.jar
mama_server_beans_V_1_6_0.jar
ReleaseNotes
08-May-2013
SapMes Interface
wip_server_beans_V_4_5_2.jar
Edit the classpath in the sapmes_classpath script to use the new jar files
Run upgrade SQL script on wip tablespace :
sapmes_V_4_0_0_Preview2_b1.sql
sapmes_V_4_0_1_RC_b1.sql
Replace the old start/stop script with the new ones as follows:
remove files : smi_start, smi.start , smi.stop and smi_file
add the new files: smi.sh, smi.start, smi.stop and smi_file
Start server.
4.0.1 b4
Page 18 of 18
