Professional Documents
Culture Documents
ReleaseNotes
4.0.1 b4
Page 1 of 18
SapMes Interface
Release-Notes
for Version
4.0.1 b4
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
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
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
Database Version
Remarks
Oracle 10.2.0
Oracle 11.2.0
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
Version
Remarks
Oracle
JRE
IBM WebSphere MQ
6.0.2
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 5 of 18
Version
Description
License / Copyright
JACORB
2.2.3
LGPL 2.0
Castor
0.9.9
http://www.castor.org/license.html
Commons
logging
1.0.4
Logging API
Apache
(http://excalibur.apache.org/license.html)
Junit
3.4
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
Sun
https://glassfish.dev.java.net./public/BinariesLicen
se.html
Apache
http://www.apache.org/licenses/LICENSE-2.0
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.
Label
Flag (new/
changed/delet
ed)
./bin
V_4_0_1_b4
./bin/smi_file
V_4_0_1_b4
./bin/smi.sh
V_4_0_1_b4
./bin/smi.start
V_4_0_1_b4
./bin/smi.stop
V_4_0_1_b4
./bin/matmas
V_4_0_1_b4
./bin/sapmes_classpath
V_4_0_1_b4
./bin/master.inline
V_4_0_1_b4
./config
V_4_0_1_b4
./config/config.xml
V_4_0_1_b4
/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
/log/in
V_4_0_1_b4
changed
Remarks
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 7 of 18
/log/out/data
V_4_0_1_b4
log/out/response
V_4_0_1_b4
./sql
V_4_0_1_b4
./xsd
V_4_0_1_b4
/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
/maindata/makt.txt
V_4_0_1_b4
/maindata/mara_c.txt
V_4_0_1_b4
/maindata/tspat.txt
V_4_0_1_b4
/maindata/t023t.txt
V_4_0_1_b4
/
V_4_0_1_b4
maindata/structure_of_fil
es.txt
file
for
for
SAP
SapMes
Label
~/lib/sapmesV_4_0_1_b4.jar V_4_0_1_b4
Flag (new/
changed/deleted)
Remarks
New
Label
Flag (new/
Remarks
changed/deleted)
~/sql/transfer_buffer.sql
V_4_0_1_b4
~/sql/create_table.sql
V_4_0_1_b4
~/sql/v_wip_partslist_def.sql V_4_0_1_b4
~/sql/sapmes_add_constraint V_4_0_1_b4
s_20060905.sql
~/sql/sapmes_wip_V_4_2_5. V_4_0_1_b4
sql
~/sql/sapmes_V_3_11_1_RC V_4_0_1_b4
_b1.sql
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/sapmes_V_3_12_1_RC V_4_0_1_b4
_b1.sql
~/sql/sapmes_V_3_12_1_RC V_4_0_1_b4
_b4.sql
~/sql/sapmes_V_4_0_0_Prev V_4_0_1_b4
iew2_b1.sql
~/sql/sapmes_V_4_0_1_RC_ V_4_0_1_b4
b1.sql
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
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 9 of 18
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
Component
Summary
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 10 of 18
Component
Summary
with
, according to Functional Specification for SapMes Interface version 1.3 from 10.10.2011.
attribute
ReleaseNotes
08-May-2013
SapMes Interface
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
Component
Summary
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
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.
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
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.
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
Component
Summary
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.
Component
Summary
29055
SapMes Interface
ReleaseNotes
08-May-2013
SapMes Interface
5 Known Problems
Identifier
Summary
25930
23129
If SAP backflashing NOK in SAP, you don't have any error messages in MQ
23124
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:
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.
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.
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.
4.0.1 b4
Page 16 of 18
08-May-2013
ReleaseNotes
SapMes Interface
4.0.1 b4
Page 17 of 18
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.
If you want SAPMES to use Table Interface instead of MQ connection following steps have to be
performed:
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:
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.
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
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
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:
Start server.
4.0.1 b4
Page 18 of 18