JMIF

JMIF
Manual
2003-2015, Kardex Software GmbH

March 26, 2015
Contents
Contents
1 Introduction 10
1.1 Idea and Core Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2 Standard Deployment Scenarios . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3 Project Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4 JMIF’s components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.1 Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.2 Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.3 Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.4 Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.5 Request and Response . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.6 Telegram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.7 Formatter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2 Getting Started 17
2.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.2 Installing JMIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.3 Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.4 Setting up JMIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.5 Obtaining a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.6 Starting JMIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.7 Stopping JMIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.8 Getting Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.9 Uninstall JMIF - tidy thoroughly . . . . . . . . . . . . . . . . . . . . . . . 24
3 JMIF Standard 25
3.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.1.1 Default Plug-Ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.1.2 Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.1.3 Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.1.4 Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.1.5 Work-flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.1.6 Error and Event Codes . . . . . . . . . . . . . . . . . . . . . . . . 31
3.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2.1 Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2
Contents
3.2.2 Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.2.3 Telegrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.2.4 Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.2.5 Display Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
4 JMIF as T3 Converter 37
4.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
4.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5 Advanced Information 39
5.1 Creating a Scheduled Task . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.2 Running JMIF as Service or Daemon . . . . . . . . . . . . . . . . . . . . . 39
5.2.1 Win32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.2.2 Linux x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
5.2.3 Other Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.3 Backing up Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.4 Migrating an Existing Installation . . . . . . . . . . . . . . . . . . . . . . 41
5.5 Quick Migration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.6 Major Upgrade on a Production System . . . . . . . . . . . . . . . . . . . 42
5.7 Incompatibly Changed Settings . . . . . . . . . . . . . . . . . . . . . . . . 43
5.8 Controlling JMIF Externally . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.9 Shutdown Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.10 Using Chainsaw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.11 Application Management and Monitoring . . . . . . . . . . . . . . . . . . 44
5.12 Changing System Properties . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.13 Using Includes for Property File based Configuration . . . . . . . . . . . . 47
5.14 Configure Loader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6 FAQ 49
6.1 Project Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.1 JMIF Standard vs Special . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.2 What’s the difference between JMIF and FastOrder? . . . . . . . . 49
6.1.3 Query Extended Storage Location Information . . . . . . . . . . . 49
6.1.4 FTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.5 File vs. TCP Channel . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.6 What is JMIF’s telegram format . . . . . . . . . . . . . . . . . . . 50
3
Contents
6.2 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.2.1 Do I need administrative rights? . . . . . . . . . . . . . . . . . . . 51
6.2.2 Crypted values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.2.3 TCP connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.2.4 Switch Port Security . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.3.1 What Windows Versions are supported? . . . . . . . . . . . . . . . 51
6.3.2 What is the recommended method on Windows? . . . . . . . . . . 52
6.3.3 Can I install several JMIF instances on the same system? . . . . . 52
6.3.4 Can I install several JMIF instances using different JRE version
on the same system? . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.3.5 I’m concerned about Java’s performance . . . . . . . . . . . . . . . 52
6.3.6 I’m concerned about Java’s security . . . . . . . . . . . . . . . . . 52
6.3.7 How many storage devices could one JMIF handle? . . . . . . . . . 52
6.3.8 Does JMIF supports HoriOpt? . . . . . . . . . . . . . . . . . . . . 52
6.3.9 Do I have to shutdown JMIF each day or week? . . . . . . . . . . 52
6.3.10 Installing JMIF as a Service on Windows Vista . . . . . . . . . . . 53
6.3.11 Installing JMIF as a Service fails . . . . . . . . . . . . . . . . . . . 53
6.3.12 Starting JMIF as a Service fails . . . . . . . . . . . . . . . . . . . . 53
6.3.13 How to solve The specified service has been marked for deletion Issue 53
6.3.14 WinNT 6.2 and 6.3 Tips and Tricks . . . . . . . . . . . . . . . . . 53
6.4 Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.4.1 My key or value XYZ is not used or incorrect read . . . . . . . . . 53
6.4.2 Property Key Sequence or Grouping . . . . . . . . . . . . . . . . . 54
6.4.3 My Windows path names does not work . . . . . . . . . . . . . . . 54
6.4.4 My configured link does not work . . . . . . . . . . . . . . . . . . . 54
6.4.5 The file filter does not match . . . . . . . . . . . . . . . . . . . . . 54
6.4.6 Working with the response header ID template and file names . . . 54
6.4.7 Response messages undeliverable on TCP connections . . . . . . . 54
6.4.8 Number format problems on quantity . . . . . . . . . . . . . . . . 54
6.4.9 User device input handling . . . . . . . . . . . . . . . . . . . . . . 54
6.4.10 Response’s return code values should have other values . . . . . . 55
6.4.11 DirectStore’s Timeout Hell . . . . . . . . . . . . . . . . . . . . . . 55
6.4.12 RLP device will not work but initializes . . . . . . . . . . . . . . . 55
6.4.13 RLP device sporadically encounters an obstacle . . . . . . . . . . . 56
6.4.14 RLP deviation on Y-axis . . . . . . . . . . . . . . . . . . . . . . . 56
4
Contents
6.4.15 MM2xx Manual Memory Activated . . . . . . . . . . . . . . . . . . 56

6.4.16 MM2xx Tray Restore Freeze Machine or Panel . . . . . . . . . . . 56
6.4.17 MM255 Tray Restore Does Not Work . . . . . . . . . . . . . . . . 57
6.4.18 MM2xx Manual Memory Usage and Display . . . . . . . . . . . . . 57
6.4.19 Timeouts on C2000 and MM2xx . . . . . . . . . . . . . . . . . . . 57
6.4.20 C2000 NAK received . . . . . . . . . . . . . . . . . . . . . . . . . . 57
6.4.21 T3 Timing Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
6.4.22 Unknown control and NAK received . . . . . . . . . . . . . . . . . 58
6.4.23 C2000 Position Lamps Turned . . . . . . . . . . . . . . . . . . . . 58
6.4.24 C3000 Timeout Troubleshooting . . . . . . . . . . . . . . . . . . . 58
6.4.25 Disable host mode check . . . . . . . . . . . . . . . . . . . . . . . . 58
6.4.26 HTTP Proxy Informations . . . . . . . . . . . . . . . . . . . . . . 58
6.4.27 Verify C3000 Control Connectivity . . . . . . . . . . . . . . . . . . 59
6.4.28 C3000 acts strange and showing mysterious texts . . . . . . . . . . 59
6.4.29 C3000 Measurement Units . . . . . . . . . . . . . . . . . . . . . . . 59
6.4.30 Intertex Controls seems to be slow . . . . . . . . . . . . . . . . . . 59
6.4.31 JDBC Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
6.4.32 Supported Encodings . . . . . . . . . . . . . . . . . . . . . . . . . 60
6.4.33 Undefined destination error although settings are ok . . . . . . . . 60
6.4.34 JMIF is unable to create a work file on upload . . . . . . . . . . . 60
6.5 Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.5.1 License missing error occurs . . . . . . . . . . . . . . . . . . . . . . 61
6.5.2 Why the hell JMIF runs idle without a license . . . . . . . . . . . 61
6.5.3 JMIF stops working after system shutdown . . . . . . . . . . . . . 61
6.5.4 Could JMIF clutter the file-system with rubbish? . . . . . . . . . . 61
6.5.5 JMIF hangs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.5.6 Starting JMIF fails . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.5.7 Process ID of JMIF’s JVM . . . . . . . . . . . . . . . . . . . . . . 62
6.5.8 Log File Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.5.9 Reset Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.5.10 Log Files Missing or Outdated . . . . . . . . . . . . . . . . . . . . 63
6.5.11 JMIF is idle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.12 Out Of Memory Exception . . . . . . . . . . . . . . . . . . . . . . 63
6.5.13 Updating JMIF during Runtime . . . . . . . . . . . . . . . . . . . 63
6.5.14 Hide Console Window . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.15 Hide JMIF’s Loader Output . . . . . . . . . . . . . . . . . . . . . . 64
5
Contents
6.5.16 JMIF Service won’t stop . . . . . . . . . . . . . . . . . . . . . . . . 64

6.5.17 JMIF won’t stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.5.18 JVM Crashed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.6 T3C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.6.1 T3C Mask State not updated . . . . . . . . . . . . . . . . . . . . . 64
7 HOWTO 65
7.1 Using Media Conveter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.1 Common FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.2 VSCOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
7.1.3 MOXA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
7.1.4 Recommended Port Mode . . . . . . . . . . . . . . . . . . . . . . . 70
7.1.5 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2 Connecting RLP Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2.1 Basic Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2.2 Configuration and Calibrating . . . . . . . . . . . . . . . . . . . . 72
7.3 Connecting TIC Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.3.1 Naming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.3.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.3.3 FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.4 C3000 Position Indicator Vario . . . . . . . . . . . . . . . . . . . . . . . . 74
7.5 Dual Tray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
7.5.1 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
7.5.2 How is it working? . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
7.6 Modifying Support File Creation Behaviour . . . . . . . . . . . . . . . . . 77
7.7 Firewalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.8 Building a JMIF Appliance . . . . . . . . . . . . . . . . . . . . . . . . . . 77
References 79
Legal Notice 80
History 81
6
List of Figures
List of Figures
1 Simple scenario showing some supported devices . . . . . . . . . . . . . . 11
2 hostLINK scenario for SAP connection . . . . . . . . . . . . . . . . . . . . 12
3 JMIF as gateway between host and PowerPick . . . . . . . . . . . . . . . 13
4 JMIF Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5 JAR Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
6 SFX Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
7 About Dialog: License found . . . . . . . . . . . . . . . . . . . . . . . . . 22
8 About Dialog: License missing . . . . . . . . . . . . . . . . . . . . . . . . 22
9 Schedule Tasks List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
10 JMIF Service Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11 Chainsaw GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
12 MBeans Browser (VisualVM) . . . . . . . . . . . . . . . . . . . . . . . . . 45
13 MBean Property Manager (VisualVM) . . . . . . . . . . . . . . . . . . . . 46
14 C3000 Manager (VisualVM) . . . . . . . . . . . . . . . . . . . . . . . . . . 46
15 MBean RLP Manager (HTMLAdaptor) . . . . . . . . . . . . . . . . . . . 47
16 DirectStore Timeouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
17 TIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
18 Dual Tray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
19 Dual Tray Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
20 Dual Tray Sample (cont.) . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
7
List of Tables
List of Tables
1 Interfaces and Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2 Channel List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3 Device List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4 Work-flow Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
5 Order Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6 Mixed Mode Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7 Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8 Incompatibly Changed Settings . . . . . . . . . . . . . . . . . . . . . . . . 43
9 JMIF-FastOrder Comparison . . . . . . . . . . . . . . . . . . . . . . . . . 49
10 Storage Location Information . . . . . . . . . . . . . . . . . . . . . . . . . 50
11 File vs. TCP Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
12 Port Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
13 Generic Serial Device Server Settings Matrix . . . . . . . . . . . . . . . . 71
14 Firewall Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
15 Document History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
8
Listings
Listings
1 Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2 JMIF’s command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3 Sample nestat output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4 NetCom - 413 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
5 MOXA NPort-211 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
9
1 Introduction
1 Introduction
1.1 Idea and Core Features
The application Java Machine Interface (called: JMIF ) is a common gateway. This
gateway enables communication between two or more systems. Systems are storage units,
conveyor technique, indicator lights, warehouse management systems (called: WMS )
or enterprise resource planing software. While doing this JMIF offers the following
possibilities:
• platform independence through Java
• based on established and experienced open source libraries
• runs locally without any system modifications
• Console-/ Service application (no GUI)
• plug-in enabled on all levels
• highly threaded
• running dozens of machines on one channel w/o any performance impacts
• extensive setting possibilities (partly at runtime) while using arbitrary multi host-
store links
• format independent, centrally manageable settings
• extensive options for (centralized) monitoring
Note: The JMIF does not replace a warehouse management system. It works as a
gateway between WMS and devices!
1.2 Standard Deployment Scenarios

The following deployment diagrams show various scenarios for running JMIF.
10
1 Introduction
Figure 1: Simple scenario showing some supported devices
Figure 1 shows the most commonly used setup, where JMIF controls one or more
devices triggered by a host system.
11
1 Introduction
Figure 2: hostLINK scenario for SAP connection
Figure 2 demonstrates a sophisticated SAP connection using our hostLINK module.
12
1 Introduction
Figure 3: JMIF as gateway between host and PowerPick
The last sample figure 3 displays a deployment where JMIF operates as a gateway
between a messaging middle-ware and our WMS named PowerPick.
Some other scenarios:
• JMIF as T3Conveter
• JMIF T3-TIC-Trap (controlling TIC display using given T3 telegrams)
• Driving with a bar code scan without connected host system
1.3 Project Planning

In order to obtain a successful JMIF project the following items should be clarified first:
• stakeholder list
• customer’s basic requirements
13
1 Introduction
• deployment (host, devices, target platform)
• define request and response
• define work-flow
• define display format(s)
• specify host protocol
• specify telegram structure
Beside the standard there are already several defined interface (see table 1). Please
contact KARDEX for detailed informations especially if not standard dispatcher or
special pick-by-light equipment is used.
Vendor System Standard

aberle Aberle-LVS no
aberle WACOS yes
Allix PROFFIX yes
CIM PROLAG no
Consafe Astro WMS yes
Coscom/ Proxia ToolDIRECTOR yes
IGZ SAP EWM/TRM yes
inconso SAP EWM yes
KASTO KASTOlvs yes
KNAPP KNAPP LVS no
Klug-IS iWACS no
LS+/ Klinkhammer DC21 no
LogControl LogControl yes
Moving Moving WMS yes
profil systems profiLag yes
proLogistik pL-Store yes
S&P SuPCIS-L no
Sme.UP iSeries Sme.UP no
SHL (SPS) no
Viastore SAP EWM/TRM yes
Zoller TMS yes
Table 1: Interfaces and Dispatchers
Connecting KARDEX Software like P owerP ickGlobal, F astP ic5, P owerP ick5000 or
M egaLogistik900 to ERP systems using message-oriented middleware (MOM ) or raw
TCP and file channel is possible, too. JMIF special packages are:
14
1 Introduction
• RAWJMS: MOM connection (MQ Series or JMS)
• HL7GW: Health Level 7 data exchange
• HLFILE: SAP connection via MOM using hostLINK
• XMLHT: XML processing
1.4 JMIF’s components

Figure 4 shows JMIF’s basic structure used for configuration using components defined
in the following sub sections.
Figure 4: JMIF Structure
1.4.1 Link
A link connects at least two systems. This is the start parameter to build up a communi-
cating system. An arbitrary amount of links is definable. All configured links operate
independently. A link has two gateways - one is called Host and the other Machine.
Host and machine are just names to distinguish between both gateways and have only
historical relationship to the real machines or host systems.
Furthermore a link manages the dispatchers and allows inter dispatcher communication.
1.4.2 Gateway
A gateway manages a list of channels and links the channels to one or more dispatchers.
15
1 Introduction
1.4.3 Channel
A channel transports messages. Transport is based on send, receive and request. Channels
may operate synchronously or asynchronously.
1.4.4 Dispatcher
A dispatcher manages and processes requests. Each request is stored as a thread (parallel
processing) within a queue. The name of the queue defines the serialization criteria also
called address or destination.
Note: JMIF special extensions are mainly contained in plug-ins. For that reason a
dispatcher naming convention is given with the name of the host system.
1.4.5 Request and Response
Generally spoken a request is an order from the host gateway side of the link to JMIF.
After the request is processed a response to the host side is created. Request or response
represents in most scenarios an order position in the sense of a WMS.
1.4.6 Telegram
A telegram defines the request and response data structure as well as the data structures
used on the machine side. Additionally the telegram manages the mapping to location
coordinates such as address, tray, level, position or depth. A mapping decouples optionally
host side coordinates from machine values (e.g. to control lamps).
1.4.7 Formatter
A formatter controls the layout of a display (normally within a panel on a physical

machine).
16
2 Getting Started
2 Getting Started
2.1 System Requirements
The basic setup required a Java Runtime Environment (called: JRE ) version 1.6 or
higher (see java.sun.com/j2se). Depending on the channel type there are also native
drivers or components required (see section 2.2). A list of supported system configuration
of Sun’s JRE can be obtained from the above URL.
Hardware requirements strongly depend on the selected operating system. We recom-
mend using a system not older than three years in order to have JMIF run optimally.
Virtualization is supported as long as the device’s port is reachable from the virtual
machine.
Sufficient file system permission (full access for the user or service running JMIF) on
JMIF’s application folder and on external transfer folders are required.
2.2 Installing JMIF

The required files are provided on CD, ftp, http or by e-Mail. Three installation types
are currently supported. We highly recommend using a private JRE installation which is
expected by the prepared scripts found in the JRE sub-folder within JMIF’s application
folder called jre/.
Methode 1 (TGZ without JRE): The installation is done by decompressing the file
jmif-vX.Y.Z.tar.gz into an arbitrary folder. This is done using a tool which supports
GNU tar and GNU zip. Such a program should be available on any platform.
Methode 2 (JAR without JRE, system JRE required, opt. jar file association): The
installation is done by executing the file jmif-vX.Y.Z.jar (double click the jar file or
execute java -jar jmif-vX.Y.Z.jar ) This is a Java-based, visual installer running on
Java-enabled platforms. Within the installation wizard you can choose language and
application directory. Additional features:
• JRE version check
• multiple installations possible
• uninstaller is generated
• optional creation of an installation script for automatic deployment
Methode 3 (SFX including JRE, Windows only): The installation is done by executing
the given self extracting executable (called: SFX ) and setting the target’s root folder.
17
2 Getting Started
Figure 5: JAR Installer
Figure 6: SFX Installer
18
2 Getting Started
It’s possible to install and operate a JMIF version on one system several times using
different folders. This applies also for different JREs and JMIF versions.
An installation script allows installation of platform specific drivers and places the
required and delivered files into the JRE which runs the JMIF.
Note: If a system JRE is used, which is automatically updated, the install script
must be started after each update. In this case merging of install and startjmif script is
recommended.
2.3 Files and Folders

Important sub-folders to know are:
• jre/: contains the private JRE
• legal/: contains legal stuff
• lib/: contains all deployed and required libraries
• transfer/: commonly used file channel’s data exchange folder
• doc/: contains the PDF manuals
• native/: installation source of native and platform depended components
The following list describes the files which could be found after the installtion in JMIF’s
application folder:
• jmif.jar: the application itself
• jmif.properties: configuration file
• stderr.log: error messages which occures before JMIF’s logger is loaded
• jmif.log*: JMIF’s log file(s)
• *.bat: useful Windows batch files
• *.sh: useful Unix shell scripts
19
2 Getting Started
2.4 Setting up JMIF

Configuration of JMIF is done by editing JMIF’s property file. Only one plug-in
supporting this kind of configuration storage is currently availabe. Plug-ins for databases
or XML files can be provided on demand.
In most cases the property file is located in and used from JMIF’s application folder.
The configuration file can be edited using any available text editor.
The file may contain key-value pairs, empty lines or comments. Sections such as
Windows’ ini files are represented by text blocks containing keys with the same prefix
(not necessary but recommended for readability).
A JMIF key starts with jmif. A hierarchical structure is achieved using dotted key
notation.
A value can contain any kind of text except for
• backslash: creates a logical line break (must not be followed by any character in
same line) otherwise it has to be doubled
• comma: separates values in a list, if value is considered as list of sub values
• dollar sign: if the right-hand value matches a key the value is resolved from that
key (recursively)
• left- and right-hand blanks or tabs: removed during reading
System properties and environment variables are merged into the configuration. For
example a JMIF key could refer to an environment variable’s value by using the dollar-
syntax.
The property file is watched by the application itself. If the file is changed, JMIF
disconnects, re-reads the configuration and connects. Therefore configuration changes
can be done at runtime - including logger settings since v1.4.190 - which is useful for
remote access or if JMIF running as service/daemon.
Furthermore JMIF’s configuration could be changed online using any available channel
if it is configured as a configuration channel (see TechMan for more informations). Please
note that these changes are discarded on shutdown of JMIF.
2.5 Obtaining a License

In order to operate JMIF at least one license key is required. For clustering purposes it is
also possible to use more than one key. The key(s) are available directly from KARDEX
Software GmbH using the displayed registration information.
20
2 Getting Started
JMIF v1 . 5 . 0 ( c ) 2003 −2010 KARDEX S o f t w a r e GmbH.

This p r o d u c t u s e s s o f t w a r e d e v e l o p e d by
The Apache S o f t w a r e Foundation h t t p : / /www. apache . o r g /
The Werken Company h t t p : / / j a x e n . werken . com/
Tanuki S o f t w a r e h t t p : / / wrapper . t a n u k i s o f t w a r e . o r g /
Licensee : KARDEX S o f t w a r e GmbH

Order : 123456789
Version : 1.5
HostId : ae5e4a98e36c6d7ac4e7c4de9d67af2e
MachChannels : 4
OS name : Windows V i s t a
CodeId : 2 deefda1
Listing 1: Licensing
Note: The license code depends on all these values and furthermore on the fully
qualified domain name (called: FQDN ) of the system running JMIF. If the FQDN is
not available JMIF tries the host name and finally the MAC address which depends on
the undefined enumeration of all available network interface controllers (called: NIC ).
In the case of a support call the license information may be requested and checked by
KARDEX Software GmbH!
Note: JMIF keeps running even if a license is missing! Therefore a valid license can be
inserted during runtime without restarting the application.
Note: A demo mode is available but must be forced. This mode is not automatically
activated if a license is missing! There are restrictions like operation delay, random
shutdown/ limited runtime and required user interaction.
There are several ways to obtain a license:
• Phone: call KARDEX Software GmbH and provide at least order number and
CodeId
• Mail: copy and paste the information above from the console output, the about
dialog (see figures 7 and 8 or the log file into a plain text mail and send it out to
KARDEX Software GmbH
• Mail with support file: create a support file and sent it out to KARDEX Software
GmbH
• JMIF: start JMIF using command line option -m
21
2 Getting Started
Figure 7: About Dialog: License found
Figure 8: About Dialog: License missing
2.6 Starting JMIF

JMIF supports following start methods:
1. Console: execute java -jar jmif.jar
2. Script: execute the startjmif script in JMIF’s application folder
22
2 Getting Started
3. Autostart: add the startjmif script to the user’s autostart group
4. Scheduled Task/Init: add the startjmif script as scheduled task on system start
(Windows, see section 5.1) or include the script call to the init script (Unix)
5. Service/Daemon: run JMIF as NT service or Unix daemon (see section 5.2)
Note: Because JMIF has it’s own loader the Java’s well-known CLASSPATH environ-
ment variable does not need to be set.
The Java application JMIF recognizes the following command line parameters:
u s a g e : j a v a −j a r j m i f . j a r [ OPTIONS ]
−S,−− s u p p o r t M a i l archive required f i l e s f o r support
i s s u e s , send i t p e r m a i l and e x i t
−c,−− c o n f i g < f i l e > use given c o n f i g u r a t i o n f i l e
−e,−−encode <val ue > encode t h e g i v e n v a l u e
−h,−− h e l p print t h i s message
−i ,−− i n s t a l l i n s t a l l o p e r a t i n g system s p e c i f i c s t u f f
and e x i t
−m,−−m a i l mail l i c e n s e information to
KARDEX S o f t w a r e GmbH and e x i t
−s ,−− s u p p o r t archive required f i l e s f o r support
i s s u e s and e x i t
−t ,−− t r a y i c o n shows a t r a y i c o n
−u,−− u n i n s t a l l u n i n s t a l l o p e r a t i n g system s p e c i f i c
s t u f f and e x i t
−v,−− v e r s i o n print t h e v e r s i o n i n f o r m a t i o n and e x i t
Listing 2: JMIF’s command line
2.7 Stopping JMIF

JMIF supports the following stop methods which depending on the start method and
the command line:
1. Console: press Ctrl-C
2. TrayIcon: select Shutdown or Hard Shutdown (see section 5.9)
3. Process: terminate the corresponding java process
4. Service/Daemon: stop the JMIF’s service/daemon using platform’s provided tool
5. Controller File: send HALT command (see section 5.8)
23
2 Getting Started
2.8 Getting Support

Should problems arise please check the FAQ from section 6 first. If JMIF still does not
work call or mail your support contact providing JMIF’s configuration and log files. The
easiest way is to send the created support request archive (see section 2.6 or use the
support script) to your support contact. The support archive’s file name is made unique
by using the current time-stamp.
Note: Support calls require ordered installation and configuration support or a valid
support contract.
Note: If JMIF is started use the script named ctrl support otherwise support.
2.9 Uninstall JMIF - tidy thoroughly

Uninstall platform depended service as well as native driver fragments using provided
scripts and delete JMIF’s application folder.
24
3 JMIF Standard
3 JMIF Standard
3.1 Features
JMIF’s standard is defined by a default implementations for plug-ins, two dispatchers,
channels and a list of supported devices.
3.1.1 Default Plug-Ins
The following default plug-ins are available for the given components:
• Link: DefaultLink
• Gateway: DefaultGateway, DefaultTransformerGateway
• Formatter: DefaultDisplayFormatter
The DefaultGateway optionally supports persistence of messages and a simple transac-

tion mechanism. Furthermore broadcasts and filtered broadcasts are supported.
The DefaultTransformerGateway extends the DefaultGateway with the capability to
process all inbound and outbound messages by a transformer. Actually FilterMessage-
Transformer and XmlMessageTransformer are available as plug-ins.
3.1.2 Dispatcher
The standard package contains following dispatchers:
• DirectStoreDispatcher
• RlpDispatcher
25
3 JMIF Standard
3.1.3 Channels
Type Passive/ Active/ Streamed/ Notes

Server Client Binary
File no yes no
FTP no yes no extends File
Folder yes yes no items are whole files
Mail no yes no SMTP, POP3, IMAP4 in-
cluding SSL support
JCA yes yes yes serial and parallel
UDP yes yes no
TCP yes yes yes 1:1 connection
TCPServer yes no yes support n client connections
MQS no yes no native WebSphere MQ
JMS no yes no supports all messaging sys-
tems providing a JMS driver
ISeries no yes no actually AS/400’s MQ and
IFS are supported
XMPP no yes no formerly named Jabber
HttpClient no yes no
HttpServer yes no no embedded http server
DIWS no yes no dynamic WS invocation
JDBC yes yes no supports all DBMS providing
a JDBC driver
XML no yes no for piping purpose with other
channels
Loopback no no yes loopback
OPC no yes no SPS, currently only Win32
platforms are supported
FINS no yes yes SPS, extends TCP
Table 2: Channel List
Channels may run synchronous (request) or asynchronous (send/ receive). Mixed mode
is possible. Asynchronous receive is achieved by events, polling or scheduled jobs which
depend on the channel type. Most channels support configurable buffering on receive.
26
3 JMIF Standard
The standard does not support prioritized messages.

Streamed channel could process data using following framing modes
• NONE: take all available data as message
• CHAR: end of message control character, optionally all except of STX, supports
character stuffing
• STRING: end of message tag
• PATTERN: use pattern matching, optionally in combination with block length and
fragment size
• LEN: fixed length
• PACKET: packet framing using combinations of fixed, dynamic, header and body
(payload) length, optionally message type depended
Note: Availability of a channel type depends on the installed JMIF package. This
applies to JMIF standard packages, too.
3.1.4 Devices
Table 3 shows a list of actually supported devices.
27
3 JMIF Standard
Type ControlUnit Protocol Vendor Notes
KX C3K C3000 C3000CGI Kardex dual tray ready

KX C2000 T3, T3TCP Kardex
KX DT C2000 T3 Kardex dual tray ready
KX RS C2000 T3 Kardex auto start mem
KX AB C2000, T88, T85 T3 Kardex E1/E2
KX AKHN T88 T3 Kardex
KX T4 C2000, T88, T85 T4 Kardex
RLP RLP Royonic light pointer

EIM TIC Remstar matrix display
MM MM255/260 MM260 Megamat dual tray ready

MM500 MM350/500 MM500 Megamat drive operations
LISTA LISTA LISTA Lista PNS
INT INT-MP Net2 Intertex Lift, Carousel,

quant correction
INT INT-EC1/INT-DSC1 Net2 Intertex Carousel
INT INT-DSC1 Net2 Intertex Lift
HA MP0 MP0 Hänel
HA MP10A MP10A MP10A Hänel
HA MP12D MP12D MP12D Hänel
BTO BTO SMSP Bertello
PD PD PD Stanley PowerDrawer
Table 3: Device List
Notes
• Device support may depend on installed JMIF standard package type.
• Foreign device support is limited due to lack of documentation, information and

test equipment access. It depends on machine type, options and installed firmware
version!
3.1.5 Work-flows
The DirectStore dispatcher supports following work-flows given in table 4.
28
3 JMIF Standard
Code Name Description
0 default fire’n forget, wait until arrived, wait until

confirmed
1 shortest path optimize by sorting, order based, supports
internal dual tray
2 code based code field defines E Memory
3 default cancel cancel all requests on carrier equals 0
4 enhanced cancel like 3 but creates cancel responses and
allows confirmation by host (canceling of
active request only)
Table 4: Work-flow Modes
In case of usage of code or orderT ype field, the work-flow could be controlled by host
system, too. We call that order or booking type. Combinations with work-flow modes
are possible. Difference between pick (out) and store (in) are usually used for different,
order type dependend display formats.
29
3 JMIF Standard
Code Name Description
0 default default mode, does not influence other set-

tings
1 single in stop processing on arrival
2 single out stop processing on arrival
3 order in force confirmation by operator
4 order out force confirmation by operator
5 inventory do not display quantity and force confir-
mation by operator with a valid quantity
value
9 cancelation cancel requests (depends on work-flow
mode)
13 remove request remove request from queue (only on work-
flow mode 3 and based on hostID field)
50 acknowledge confirmation by host (F3 simulation)

53 escape escape by host (F4 simulation)
51 display display text only, device depended!

52 status query tray/opening/machine status only,
device depended!
54 input fetch user input from panel (currently
C3000 only)
60 ignore ignore request (usually used with mapped

order types as filter)
61 alive inter system alive request
62 queue state query the queue state of opening (idle:
code 0, busy: code 103, see table 7)
63 error description query textual but configured return de-
scription
Table 5: Order Types
JMIF supports also toggeling by operator between host mode (alias automatic mode)
and manual mode (alias semi automatic mode), e.g. in case of rush order. This is called
a mixed mode workflow.
30
3 JMIF Standard
Controll Description
MM260 behaviour by device design turning off automatic start (default)

C2000 operator could re-request last tray inserting F2-F6-F2
C3000 mode detected by JMIF (fully automated)
Table 6: Mixed Mode Support
It’s recommend to adjust the corresponding timeouts (busy- and pollTimeout).

Work-flow mode 1 needs an end of order trigger. In case of file or TCP server channel
the trigger could be created internally (end of file or conenction closed). Otherwise the
trigger has to be send from host system. In this case the field order as well as the info
field batch are mandatory. The latter contains a unique id. The field order contains the
trigger on end of order as constant string EOF.
3.1.6 Error and Event Codes
Table 7 shows a list of JMIF’s standard error and event codes as well as machine error
code ranges. Most commonly used code are 0, 101, 103 and 104.
31
3 JMIF Standard
Code Description
0 no error, request successfully completed

1-99 T85/T88/C2000/MM260 machine error codes (short)
C3000CGI interface error codes (short)
101 common error
102 NAK received (machine or sequence numer)
103 machine busy
104 timeout
105 maximum amount of retries reached
106 carrier in use or undefined
107 cancelled
108 invalid user input data
201 request accepted and queued

202 request processing started/ request active
203 carrier arrived, maybe overwritten by code 0
501-999 MM260 FSE error codes

1000-32767 C2000TCP/C3000CGI machine error codes
0xFFFx C3000CGI interface error codes (global, short)

> 0xFFFF C3000CGI interface error codes (long)
Table 7: Codes
3.2 Configuration
There are dozens of settings available. Check the TechManual, DirectStore Dispatcher
for detailed informations. Most of the settings could be defined globally in the sense of
the dispatcher or locally in the sense of the target address.
3.2.1 Naming Conventions
Follow naming convention is recommended:
• Common: camelcase
• Link: name of the host system or generic host
• Gateway: compound of link name, host or machine and the word gateway
32
3 JMIF Standard
• Channel: uppercase letters, compound of channel type and number
• Host telegram: if request and response telegrams or identical just the word host-
Telegram otherwise insert req or resp between the words host and telegram
• Machine telegram or command: compound of protocol, the word command and a

number
• Display formatter: compound of the word displayFormatter and order type like
(IN, OUT, INV )
3.2.2 Templates
JMIF uses simple internal templates. These templates are built up by using named
fields (case sensitive!) surrounded with @@ and any other static text. We call them
@@-template.
3.2.3 Telegrams
Telegrams on the host gateway are based on regular expressions (see [Friedl03]). The
most important settings are:
• pattern: the regular expression used to match the given request data. The expression
to parse or format a field value (depends on the fields data type).
• infoFieldNames: defines a list of additional fields. These fields can be used like the
build-in fields.
• replaceTemplate: a regular expression or a @@-template used to create the response

data
• telegramSpecTemplate: can be used to define a sub telegram spec based on request’s

data using @@-template syntax (recursively usage possible)
• index: references the group within an regular expression. A group is defined by

round brackets. The index is 1-based.
• country: the country argument is a valid ISO Country Code. These codes are
upper-case, two-letter codes as defined by ISO-3166. You can find a full list of
these codes at a number of sites, such as ISO-3166.
33
3 JMIF Standard
• language: the language argument is a valid ISO Language Code. These codes are
lower-case, two-letter codes as defined by ISO-639. You can find a full list of these
codes at a number of sites, such as ISO-639.
• defaultValue: field’s initial value which has to fit to field’s data type specification.
Mapped fields can be referenced by adding the prefix plain before the field name, while
uppercase the first letter of the name. The corresponding sub key could be created by
placing a @@-template into the pattern key of the plain fields definition.
Note: Reverse mapping is not yet supported, i.e. machine data like a carrier number
on a status request could not be reverse mapped.
Following variables are predefined. In most cases address and carrier are at least
required. Unused but specified numeric fields have to be set to 0 whereas alphanumeric
ones could contain an empty string:
• seqNo (integer): can be used to sequence number checks within used protocol,
range configurable
• addr (integer, mapped): unique opening address
• sAddr (integer, mapped): unique source address for carrier transfer
• carrier (integer, mapped): machine wide unique carrier id
• carrierNext (integer, mapped): machine wide unique carrier id of carrier which

should be prepared on lift (dual tray)
• level (integer, mapped): level on carousels
• pos (integer, mapped): position lamp (x axis, from)
• pos2 (integer, mapped): position lamp (x axis, to)
• depth (integer, mapped): depth lamp (y axis, from)
• depth2 (integer, mapped): depth lamp (y axis, to)
• hostId (string): can be used to join response and request on host side
• confirmFlag (boolean) : allows the host to ask for a response per request
• order (string): the order name or id
• orderType (integer, mapped): controls the workflow per request
34
3 JMIF Standard
• orderPos (string): the order position name or id
• part (string): the part name or id
• quant (double): the quantity, format pattern required
• desc (string): a description
• code (integer): combination of order type (request) and return value (response)
• ret (integer): return code inside response
• retDesc (string): textual description of the return code, freely configurable
• dateTime (date): timestamp
The machine gateway telegrams have machine type specific settings. Check the
TechManual for details.
3.2.4 Regular Expressions
Most common used (sub-) expression within JMIF’s configuration are
• (): marks a group, group’s indizes are 1-based
• (.∗): matches any character, quantity: 0. . . n
• ([ˆ; ]+): matches any character except of semicolon, quantity: 1. . . n
• (\\d{n}): matches any decimal character, quantity: n
• (\\d){n, m}: matches any decimal character, quantity: n. . . m
Following characters have to be escaped by \:
• dot: .
• hat: ˆ
• open curly brace: {
• open square bracket: [
• bracket: (
• pipe: |
35
3 JMIF Standard
• star: ∗
• plus: +
• questionmark: ?
• backslash: \
More informations about regular expressions (alias RegExp or just Regex ) are available
here:
• Books from O’Reilly: Mastering Regular Expressions [Friedl03], Regular Expressions

Cookbook or Regular Expression Pocket Reference
• Wikipedia
• Online testing tool Rubular
• Regular-Expressions.info
3.2.5 Display Formatting
The default display formatting plug-in depends on the host gateway telegram, i.e. on
the regular expression based telegram. Optionally the order type or code field could be
used to create separate layouts depending on booking type. Formatting is carried out as
follows, using:
• R: right padding
• r: get the rightmost characters
• C: center padding
• c: centers a string in a larger string using the space character
• L: left padding
• l: get the leftmost characters
• #: arbitrary character, where # is replaced by a space character while any other

character is shown as filler
• .: decimal delimiter
• 0: zero or decimal, leading zeros, forced decimals places
36
4 JMIF as T3 Converter
JMIF could be used as T3 converter (called T3C ). For this purpose an own package is
available containing the needed plugins. JMIF/T3C is able to convert the T3 protocol
into the C3000CGI protocol.
Warning There could be several impacts which should be discussed

with your system consultant! Such impacts are missing protocol fea-
tures, timing issues, appliance on the panel, firmware versions or lack of
communication resources.
Note T3C usage should be considered as workaround only. We strongly
recommend using a common, machine protocol independend host inter-
face like implementable with JMIF standard. There is no guaranty that
newer or next machine generations will be supported!
4.1 Features
JMIF/T3C supports
• RS232 (including virtual COM ports like com0com), UDP and TCP
• all telegrams except of

– R/S telegrams
– Bahnhof functionality of x telegram
– certain special functions of V telegram
• command and state caching
• command shelf time
• automatic start mask including E-Memory emulation
• T3 converter mask (serveral modes includng AB buffer usage)
• host ID mapping
• trigger (configurable texts in P telegram)
• configurable error code mapping
• unlimited amount of machines per JMIF instance
37
• upto six physical openings per machine
• T3Test v1.5 and MIF01 v3.7 proofen
• upto several thousand T3 requests per minute
• T3 trap (controlling RLP or TIC using given T3 data)
At this time there is no configuration wizard available. Furthermore JMIF has to be

licensed. In case of T3 converter mask usage, the T3 converter option on machine side
has to be licensed and activated, too.
4.2 Configuration
The T3C configuration requires at least the definition of the communication channel
between host and JMIF, communication timeout, desired appliance on the panel, opening
addressing and T3 telegram parameterization.
The configration structure is JMIF standard except of the RLP dispatcher plugin has
to be used (check the property file from the package as sample).
38
5 Advanced Information
Figure 9: Schedule Tasks List
5.1 Creating a Scheduled Task
Instead of using a service there is another way to achieve similar functionality on Windows
platforms (running JMIF without a logged on user) - this is called scheduled task. To
create a new task:
• open the Control Panel or Programs/Accessories/System Tools
• launch Scheduled Tasks
• double click Add Scheduled Task
• browse for startjmif.bat in Scheduled Task Wizards’s program selection
• name the task JMIF
• perform the task When my computer starts
• enter a valid local or domain account
• complete the wizard, you should have a list like in figure 9
• run the task
5.2 Running JMIF as Service or Daemon

5.2.1 Win32
The following steps are required to run JMIF as a Win32 service:
• copy all files from lib/servicewrapper/win32 to JMIF’s application folder
• modify the win32 wrapper.conf file on demand, e.g. set the service’s name, startup
type and logging features
39
Figure 10: JMIF Service Properties
• execute the installservice script (or the uninstallservice script for uninstall purpose)
• adjust the log on settings (default: Local System, see figure 10)
• start the service once using service manager or just net start JMIF as administrator
5.2.2 Linux x86
The following steps are required to run JMIF as a daemon using init:
• copy all files from lib/servicewrapper/linux-x86-32 to JMIF’s application folder
• modify the jmif and wrapper.conf files on demand, e.g. set the daemon’s name,
paths, user and logging features
• execute install jmif /etc/init.d
• execute update-rc.d jmif defaults
• start the daemon once using /etc/init.d/jmif start
To remove JMIF daemon use:
• stop the daemon one using /etc/init.d/jmif stop
40
• execute update-rc.d jmif remove
• execute rm /etc/init.d/jmif
5.2.3 Other Platforms
At the time of writing this document only Win32 and Linux x86 binaries are deployed
and supported.
Note The Win32 components works on a Windows based x64 system using the deployed
JRE, too.
Note Because of licensing issues JMIF is made YAJSW (Yet Another Java Service
Wrapper) ready. Theat means one could use YAJSW instead of the deployed framework.
5.3 Backing up Installation

Backing up an installation is simply done by
• stopping JMIF if started (see section 2.7)
• adding JMIF’s application folder recursively into an archive.
5.4 Migrating an Existing Installation

We recommend following approved plan in case of a scheduled migration to a new system:
• arrange a date with all stakeholders while considering downtime of the warehouse
and availability requirements
• order the needed support from your KARDEX sales considering additional costs
for nightwork, work at weekends and public holidays
• get and verify direct contact data of stakeholders
• check availability of stakeholders and systems a few days before the scheduled date
• ask for possible impacts
• prepare new communication data for reconfiguration, if they will be changed
• if possible install JMIF in advance to get licnese code
• consider all effected nodes in case of clustered systems
In case of a sudden system failure (ad hoc migration):
41
• failover cluster/SAN: node switch is done automatically, JMIF starts on new node
and recovers transcation if activated
• cold stand-by system: bootup system, JMIF starts if system is licensed before
• otherwise: restore from backup (see section 5.3) and obtain a new license code
considering support level and related support times
Note At most cases the license will became invalid but JMIF still starts disconnected
without a license.
Note Reconfiguration of media converters running in UDP mode will most likely be
required in case of IP address of JMIF host was changed.
5.5 Quick Migration Steps

1. stop JMIF service on old system
2. copy JMIF’s application folder recursively to new system
3. disable JMIF on old system (e.g. by disabling the service or renaming the
jmif.properties file)
4. install service on new system
5. start JMIF service
6. create a support file on new system and send it to KARDEX Software GmbH
7. insert new license code into jmif.properties and save the file
8. check JMIF’s log file for errors
9. remove JMIF from old system (delete service and then JMIF’s application folder)
5.6 Major Upgrade on a Production System

A major upgrade covers upgrading the private JRE, required libraries and JMIF itself.
As very first step make a backup of the existing system as described in section 5.3.
Shutdown JMIF and rename the existing application folder. Install the new version
using the old, original application folder name, copy the property file from the old
installation and start JMIF. If neccessary upgrade the license code. In most cases all
other settings kept compatible and new ones use compatible default values.
42
In case of problems create a support file, shutdown JMIF and rename the current
JMIF’s application folder. Rename the above saved folder to its orginal name and start
JMIF again You are back on your old productive system.
5.7 Incompatibly Changed Settings
Component Key New Since
DirectStore mmQuickStart quickStart 1.4.106

renamed
DefaultDisplayFormatter displayFormat 1.4.119

justification mandatory
DirectStore/MM driveMode 1.5.26

quickStart setting now mandatory on mode 61
TcpChannel bufferSize recvBufferSize 1.5.30

renamed
DefaultGateway eofOnRestart 1.6.14

removed due to violation of design
FileChannel singleFileMode 1.6.14

changed to read only one file but do no longer also suspend channel (desing violation)
DirectStore resumeOnDone 1.6.14

removed due to violation of design
use suspendUntilDone optionally in combination with WFM1 and/or singleFileMode
Table 8: Incompatibly Changed Settings
5.8 Controlling JMIF Externally

JMIF could be operated externally using the file controller.jmif which is located in the folder given by
user.dir. This file is deleted on start and permanently watched during runtime. If the file is created or
changed JMIF executes the given command. The following commands are currently valid:
• CONNECT: connect all links
• DISCONNECT: disconnect all links
• RESTART : disconnect and connect all links
• HALT: shutdown JMIF
• SUPPORT: create a support file
• DUMP: write thread dump to logger
43
Figure 11: Chainsaw GUI
5.9 Shutdown Options

JMIF has two shutdown options: one is the normal shutdown and the other is a hard shutdown. During
a hard shutdown JMIF is immediately exited. In this case there is no disconnect, no shutdown of internal
components and no open transactions will be finished. Within JMIF’s standard all transactions will
be committed on a normal shutdown - it is immaterial whether they were successfully executed or just
queued (purpose: system clean up). In order to continue working after a shutdown, having all unprocessed
requests back, a hard shutdown using gateway persistence is required.
To force a hard shutdown if JMIF is running as a service or by the controller file’s command HALT,
the application setting jmif.hardShutdown=true has to be used.
5.10 Using Chainsaw

Monitoring JMIF’s activity could also be done by using the chainsaw script. This starts a graphical Java
application called CHAINSAW Log4JLog Viewer running a TCP server listing for incoming log entries
from JMIF (see figure 11). To activate the logging towards Chainsaw the SocketAppender of Log4J (see
samples in the given property files) must be setup.
Changing Chainsaw’s listening port (default: 4445) could be done by setting the system property
chainsaw.port. Check the provided Chainsaw start script for a sample doing this.
As an alternative one could use Lilith version 0.9.40 or newer.
5.11 Application Management and Monitoring

JMIF supports basic appication management and monitoring including of connected devices. To activate
JMIF’s Java Management Extensions (JMX) features, set the key jmif.jmxSupport = true. To enable
simple i.e. unsecure remote access use the following VM arguments:
44
• −Dcom.sun.management.jmxremote
• −Dcom.sun.management.jmxremote.port = 9999
• −Dcom.sun.management.jmxremote.authenticate = f alse
• −Dcom.sun.management.jmxremote.ssl = f alse.
Securing the remote access is strongly recommend (see JMX documentation). Web-based access is
possible using JMIF’S extension EmbeddedHtmlAdaptorServer and the JMX tools.
Figure 12: MBeans Browser (VisualVM)
45
Figure 13: MBean Property Manager (VisualVM)
Figure 14: C3000 Manager (VisualVM)
46
Figure 15: MBean RLP Manager (HTMLAdaptor)
5.12 Changing System Properties

To overwrite or set system properties, the file system.properties located in JMIF’s application folder can
be used. This may be required to change default settings of used libraries (e.g. internal mailing or XML
handling).
5.13 Using Includes for Property File based Configuration

In case a propery key starts with the word include JMIF will consider the property value as path for an
other property file to include. Includes could be nested but recursion are checked.
5.14 Configure Loader

JMIF’s setup may not contain all components if specialized, commercial third party libraries are required.
47
Extending JMIF’s classloader is carried out using the file jmifclassloader. properties located in
JMIF’s application folder. The syntax is defined by unique name equals path such as FooBarCompo-
nent=c:/components/foobar.jar. But one could also place such additional, required but not deployed
runtime components in JMIF’s lib folder which is completely read by the loader. This is possible if the
additional component was xcopy-deployed.
48
6 FAQ
6 FAQ
6.1 Project Management
6.1.1 JMIF Standard vs Special
The common JMIF standard is represented by the DirectStore dispatcher. There are serval other packages
(plugin sets) availlable as standard in the sence of order management, too. Projects not covered by
standard are implemented by plugins based on JMIF standard’s core and kept compatible with core also
after the project was realized. In other words: special implementations are always integrated into main
branch using plugins.
6.1.2 What’s the difference between JMIF and FastOrder?
Feature JMIF FastOrder
platform independent yes no

database no yes
GUI no yes
WMS Setup no yes
order sequence by host by user
order batching no yes
order cancellation by host/ by user by user
pause and resume orders no yes
process serval orders in parallel yes no
max. device count no limits 4-8
Table 9: JMIF-FastOrder Comparison
6.1.3 Query Extended Storage Location Information

JMIF could provide internal storage location information if the connected device supports fetching such
details.
49
6 FAQ
Controller Methodes Information
C3000 request, JMX height, weight, internal location coordinates

job, JMX storage statistics and compression
job sync machine’s tray tables to any external targets
(e.g. a database)
Table 10: Storage Location Information
Note: The data may be inaccurate or may become invalid in case of manual storage action or storage
compression!
6.1.4 FTP Server

The application of a FTP server could be combined with JMIF’s FileChannel. A FTP server is provided
at most operating systems. Furthermore there are open source implementations available. Additionally
JMIF has an extension (available on inquiry) which embedds an Java-based FTP server. This solution is
platform independend, requires no installation nor system modifications and runs on a non-privileged
port.
6.1.5 File vs. TCP Channel

Both channel types are widely spread to connect host systems. Using a simple CSV-based telegram
specification and (CR)(LF ) as end of message tag they even could exchanged transparently on demand
and at runtime.
Channel pros cons
File simple performance

easy to test (notepad) virus scanner
TCP performance department firewalls
testing requires a tool like telnet
Table 11: File vs. TCP Channel
6.1.6 What is JMIF’s telegram format

There is no one and only telegram format. JMIF could read information from
• any text string which could be parsed with an regular expression
• binary data
• markup languages using decomposer plugins.
50
6 FAQ
Most commonly used is a simple character separated value message line containing an end of message tag
for both directions. Data structure and transport are completely separated, too, i.e. one could exchange
a channel while keeping the telegram’s structure.
6.2 Security
6.2.1 Do I need administrative rights?
No, as long as you do not need access to protected system resources (e.g. installing service/daemon). On
Unix you could install and run JMIF from your home directory.
6.2.2 Crypted values

To encrypt a value use the command line option −e. Clear the original key’s value, add a new key
extended by the suffix −x and insert the encrypted value. Sample:
• original key: jmif.mySecretP assword =
• key containing encrypted value: jmif.mySecretP assword − x = 123456
Any JMIF setting could be encrpyted in this way. The values will not be displayed inside the log files.
Encryption is runtime system dependend. Changing the runtime system will invalidate all encrptyed
values!
Alternativly it’s recommend to restrict access to JMIF’s application folder.
6.2.3 TCP connections

Like media converter JMIF’s TCP connections (passive and active) could be secured by configuring an
expected password question and a valid password response. Don’t forget to append neccessary control
characters!
6.2.4 Switch Port Security

Note that some device may contain internal unmanaged switches. Machine subsystems beside contoller
unit may send data like broadcasts. Therefore all internal MAC addresses have to be configured to allow
access and prevent port locks, i.e. add all to port’s ACL. Optionally you could connect each internal
ethernet device to an external switch with single secure configured MAC address per port.
6.3 Installation
6.3.1 What Windows Versions are supported?
Any version and architecture for which a JRE is available. A x86 JRE works on x64 system types. A
JMIF packages containing a x64 JRE is available on demand. In case of x64 platform ensure that all
needed external native libraries are available as 64-bit version.
51
6 FAQ
6.3.2 What is the recommended method on Windows?

Execute the delivered or downloaded SFX file and select a target folder without special characters or
blanks. Do not use your desktop!
6.3.3 Can I install several JMIF instances on the same system?

Yes (also as a service), but take care of the application’s lock setting and never ever use the same property
file.
6.3.4 Can I install several JMIF instances using different JRE version on the same
system?
Yes, there’re no impacts or version conflicts as long as you consider the system requirements.
6.3.5 I’m concerned about Java’s performance

Forget it! By running JMIF on an old fashioned system it is possible to process several requests per
millisecond on the file channel. The device response times or poll intervals are factor 10 to 100 times
slower than JMIF’s internal routines.
6.3.6 I’m concerned about Java’s security

Simply use as recommended a private JRE. This JRE will never be used on a Web-Browser installed.
Furthermore the private JRE will not be touched by security updates or other (sometimes buggy) hotfixes
applied by auto updaters.
6.3.7 How many storage devices could one JMIF handle?

Well, that depends on a lot of factors like system performance, pick rate device type and request size.
Theoretical limits are give by JMIF’s internal data structures. But these are a far cry from any practical
application. JMIF runs productively in warehouses with dozens of devices without any performance
impacts. Until now JMIF has never been responsible for a system’s bottle neck.
6.3.8 Does JMIF supports HoriOpt?

Yes, this is a behaviour by design. JMIF drives machines in parallel. Also JMIF will control openings in
parallel on one machine if possible.
6.3.9 Do I have to shutdown JMIF each day or week?

No, JMIF is designed as service application running within a 24x7 environment. Sample log entries from
a mid range system running on Linux:
<... > JMIF v1 . 4 . 2 3 1 up s i n c e 306 day ( s ) 21 hour ( s ) <... >

<... > Current / accumulated r e q u e s t count : 2/ 213284
52
6 FAQ
6.3.10 Installing JMIF as a Service on Windows Vista

Go to Start — All Programs — Accessories, then right-click on ”Command Prompt”, and select ”Run as
administrator”. No UAC related issues are known.
6.3.11 Installing JMIF as a Service fails

Run the installer batch as administrator using JMIF’s application folder as working folder (console, JMIF
application folder, command runas). If you prefer file explorer’s context menu, you have to adjust the
JRE path inside the installer batch!
6.3.12 Starting JMIF as a Service fails

First of all check the wrapper’s log file and whether the configured JVM could be found and accessed. In
case of an class not found exception check the PATH environment variable for invalid values. We saw
double quoted entries on Windows systems there which caused corrupted values on java.library.path. If
the variables value could not be fixed, remove the PATH reference from wrapper’s configuration file.
6.3.13 How to solve The specified service has been marked for deletion Issue
• A Microsoft Management Console (MMC) is opened. To ensure all instances are closed, run
taskkill/F/IM mmc.exe. Note that services console and NT event viewer are hosted by MMC,
too.
• SysInternals’ Process Explorer is opened. Closing it should lead to automatic removal of the
service.
• Task Manager is opened.
6.3.14 WinNT 6.2 and 6.3 Tips and Tricks

For remote installation and assistance follwing notes may be helpful on Windows 8, 8.1, Server2012 and
Server2012R2:
• starting a program: just search for it
• command shell: seach for cmd or use Powershell
• logoff RDP session: run logoff inside command shell
• install telnet client: run pkgmgr /iu:”TelnetClient” as admin inside command shell
6.4 Customization
6.4.1 My key or value XYZ is not used or incorrect read
Configuration keys and values are case sensitive! Check the spelling! Check for copy’n paste errors! Check
for doubled keys with different values! In case of logical line breaks check for invisible space characters
after the backslash! Check that variable are resolvable! If JMIF miss a mandatory key, it writes the
expected key name into the log file. Note that comments are not allowes inside a line. They will became
part of the valule! Further information regarding Java properties file format are available on Wikipedia.
53
6 FAQ
6.4.2 Property Key Sequence or Grouping

Property keys are unsorted. It doesn’t mattter were you place a key inside a propropery file. The
grouping is just to keep similiar things together and make the stuff more readable.
6.4.3 My Windows path names does not work

Check whether you doubled all backslashes. Use a forward-slash instead - it works! UNC path names
and usage of administrative shares is supported as well.
6.4.4 My configured link does not work

Check the logs whether the link could be established. If not the links configurations or some of it’s
subcomponents are wrong.
6.4.5 The file filter does not match

File filters base on regular expressions. Do not mistake that for file system, wild-card based expressions!
For example a file system filter *.* correspond to JMIF’s filer expression (.*). Furthermore JMIF’s filter
are case-sensitive. For example use (?i:.*\.txt) to fetch all files ending case-insensitive with .txt.
6.4.6 Working with the response header ID template and file names
The dispatcher’s template may contain all defined fields or constants. Furthermore it may contain path
separators. But to use subfolders one should consider, that the folders have to exists in the up folder
(only below version 1.4.200) and that there is no prefix defined. If the respHeaderIdTemplate setting
is undefined, the request’s channel sender(From) information will be used for the response’s channel
recipient (To).
6.4.7 Response messages undeliverable on TCP connections

Responses could not be sent if an active watch dog on a channel has closed the connection before
the request could be fnished. The watch dog timeout has to be adjusted or alive requests could be
used. Another common issue is a defined but empty respHeaderIdTemplate. The setting should be
disabled (removed or commented) except of use of TcpServerChannel with a maximum of one connection
configured.
6.4.8 Number format problems on quantity

If one run into trouble with number format and different localisations using the quantity field, consider
using an integer value or in case of informational purpose only any free text field.
6.4.9 User device input handling

Except of inventory mode invalid input is accepted. JMIF will then use the values from request for
response message. Commonly this is the requested quantity.
54
6 FAQ
Figure 16: DirectStore Timeouts
6.4.10 Response’s return code values should have other values

Use the retDesc field to map the given return values to the required ones. In case of alive telegram use
the code field to get value 0 or the ret field to receive value 61:
jmif.hostT elegram.replaceT emplate = @@ret@@

jmif.hostT elegram.index.code = 1
jmif.hostT elegram.index.ret = 1
6.4.11 DirectStore’s Timeout Hell

There are three settings (see figure 16):
• busyTimeout: defines how long JMIF waits, until machine accepts drive command but only if
machine clearly answers busy
• driveTimeout: defines how long JMIF waits, until requested tray moved to destination
• pollTimeout: defines how long JMIF waits, until operator confirmed on panel but less time used
for driving
6.4.12 RLP device will not work but initializes

Most likely one uses the quantity field in combination with rational numbers and internal notification (so
called dispatcher observer’s). In this case the (internal) telegram has to be partly defined like this:
55
6 FAQ
jmif.rlpDispatcher.internal.rlpRequest = rlpRequestT elegram
jmif.rlpRequestT elegram.pattern.quant = ######.000

jmif.rlpRequestT elegram.language.quant = DE
jmif.rlpRequestT elegram.country.quant = de
6.4.13 RLP device sporadically encounters an obstacle

Verify that
• tray dimension correctly setup (symptom: RLP initialzes)
• sliding carriage operates without any barriers (symptom: X86/Y86 error)
• command write delay of 50msec inside UDP/TCP channel is configured (symptom: X86 error)
6.4.14 RLP deviation on Y-axis

Very probably one did not adapt yOffset and reference point to tray dimensions. Disable yOffset and
pilot reference point (1098, cW idth/2, 0).
6.4.15 MM2xx Manual Memory Activated

If machine is not setup for direct start and poll mode two, active or in error state, new transport orders
will be redirected from machine to its manual memory. These orders will not be processed until the
operator pressed the start button on machine’s panel. To avoid this kind of problems, the workflow has
to be defined carefully, the manual memory could be disabled by machine configuration and the poll
mode two has to be activated.
In case the green button is still blinking and manual memory is diabled, then there’s an unconfirmend
error on machine open which has to be resolved by operator. Furthermore following drive request will
put into the manual memory but deleted immediately after operator has pressed the button and without
any feedback to JMIF!
Note: Older controls like MM255 may not support disabling of manual memory! Older controls may
not have poll mode two! In case of that and if a tray restore request was sent, JMIF is unable to detect
completion of retore and releases therfore the opening immediately. Because machine may be still active
on former restore, next transport request may be redirected by machine to manual memory.
6.4.16 MM2xx Tray Restore Freeze Machine or Panel

Most likely there’s a paternoster and not a lift in use. Disable usage of restore using subkey megalif t =
f alse.
56
6 FAQ
6.4.17 MM255 Tray Restore Does Not Work

Some older firmware versions do not support that functionality as well as switching of position lamps.
That’s no problem for JMIF’s request processing. But if that features are needed, please contact you
KARDEX sales to request firmware special programming.
6.4.18 MM2xx Manual Memory Usage and Display

In case of
• a control which does not support extendend drive command
• forbidden direct start
• requirement to use all four display lines
one could enforce this combination by
• disabling direct start on machine’s terminal
• using drive mode 61
• enabling deferred display but only if confirmation on terminal is required.
Starting with version 1.5.26 direct start (alias quick start) is no longer forced on drive mode 61.
6.4.19 Timeouts on C2000 and MM2xx

If communication channel working properly there’s most likely a mismatch between configured internal
opening address inside machine and JMIF, i.e. JMIF uses an address, which is not known by machine.
In case of
• MM2xx: check the configured address (7), baudrate (8) and especially polling mode (9)
• C2000: check (service interface) whether MAC addess is set (get ethernet address)
• C2000: check (OP or service interface) whether Gateway is set (get ip gateway)
• C2000: check (service interface) configured protocol interface (get ethernet protocol should return
0 for UDP and 1 for TCP)
6.4.20 C2000 NAK received

Check wether so called C2000’s host settings fit to JMIF’s T3 telegram settings. Default values:
• carrier: 3
• position: 2
• position2 alias bis..Postion alias level: 0
• depth: 1
• quantity: 4
• display size: 20
57
6 FAQ
6.4.21 T3 Timing Issues

Older devices (controls before C2000) as well as C2000 based Horizontals (HoCa) may have problems
with to short polling intervals. Recommendation by factory is therfore to use a value not below 200msec
(JMIF’s default is 350msec).
6.4.22 Unknown control and NAK received

Most likly you try to control a C3000 using a C2000 JMIF configuration.
6.4.23 C2000 Position Lamps Turned

Check C2000 service interface’s parameters via get turn [d|p]lamps.
6.4.24 C3000 Timeout Troubleshooting

There are two timeouts which shoud be configured to fit to each other. On the one side there are the
HTTP channel timeout and retry values (communication layer). On the other side there is the command
timeout (SPS layer). A recommended setup looks like this:
jmif.HT T P 01.timeout = 1500

jmif.HT T P 01.retries = 2
...
jmif.c3kCommand1.timeout = 3000
This mean that on the communication layer one http request may timeout before the SPS command
itself will fail. Finally use
jmif.HT T P 01.f orceRetries = true
to run retries on any I/O errors (not only http ones).
6.4.25 Disable host mode check

While this is not recommended one would like to turn off this feature (e.g. to use device’s option to
switch automatically from user to host mode mask). Inside standard this could be done using thre
checkHostM ode setting either globally or locally (i.e. per access opening). Please note, that in this case
a tray directly fetched by the user may be restored immediately on a new host request! In case of trouble
check the machine setup!
6.4.26 HTTP Proxy Informations

At this time there are no problems known using JMIF, HTTP communication and proxies because JMIF
does not use system’s HTTP communication components. To get some HTTP proxy informations
• set the debug log level
58
6 FAQ
• configure a channel of type HttpClientChannel

• specify an valid URL (otherwise the application vendor’s URL is used)
The proxy configuration is then printed to the log file while the channel is opened.
6.4.27 Verify C3000 Control Connectivity

To verify that a given IP address belongs to a C3000 control, open a TCP connection on port 81 using
a Web Browser or telnet. In case the IP addresse belongs to an OP, connection will fail otherwise you
should receive a status page or just a HTTP response.
6.4.28 C3000 acts strange and showing mysterious texts

Most likely T3 Converter option is active and machine showing T3 mask. Disable machine option carefully
having access opening cleared or call Kardex service. After disabling T3 option you may run into some
problems. In case machine reports tray already exists, you had a tray in the opening on deactivation of
T3 option. Rerequest the same tray again in semi-automatic mode and then restore it manually.
6.4.29 C3000 Measurement Units

Height of a tray in steps of 25mm. Minimum height equals to 3, i.e. 75mm. Weight of a tray’s payload
in kg, i.e. net weight.
6.4.30 Intertex Controls seems to be slow

Check JMIF’s logs for time gaps of round about 4 seconds (4s + (networkAddress ∗ 20msec)). This is
the interval within the control repeats unconfirmed messages. In case of media converter usage choose
port mode TCP Server.
6.4.31 JDBC Connections

Using JRE’s JDBC-ODBC bridge in productive environments is not recommended. We suggest using
Typ 4 drivers (native protocol driver) which are platform independent and do not need installation of
any additional client software besides the library file. The given library file could be placed in JMIF’s lib
folder (xcopy) using an arbitrary filename and is usually freely available from DBMS vendor’s homepage.
For details of the database connection’s parameters contact your DBMS administrator.
• Microsoft SQL Server (Type 4 Driver)

– Library: sqljdbc4.jar
– Driver: com.microsof t.sqlserver.jdbc.SQLServerDriver
– URL:
jdbc : sqlserver : //
[serverN ame[\instanceN ame][: portN umber]]
[; property = value[; property = value]]
– Typical properties: databaseName, instanceName, integratedSecurity
59
6 FAQ
– Typical values: portN umber = 1433

– Sample:
jdbc : sqlserver : //localhost\SQLEXP RESS : 1433;
databaseN ame = JM IF ;
– Note: Connecting with Integrated Authentication works only on Windows systems. Use
JMIF’s installation script to copy the required DLL to used JRE.
– Note: Instance name could be omitted if default instance is used (but do not just clear
attribute’s value - remove key and value!).
– Note: SQL scripts could be configured using semicolon as command separator.
• Oracle (Type 4 Driver alias Thin Driver)
– Library: ojdbc14.jar
– Driver: oracle.jdbc.OracleDriver
– URL:
jdbc : oracle :
[drivertype]@[serverN ame] : [portN umber] : [SID]
– Typical properties: n/a
– Typical values: drivertype = thin, portN umber = 1521
– Sample:
jdbc : oracle : thin@localhost : 1521 : ora10
– Note: SQL scripts could be configured using anonymous PL/SQL blocks.
6.4.32 Supported Encodings

Most channels suport the charSet property. A list of supported encoding could be found inside the Java
SE 1.5 or Java SE 6 documentation.
In case of C3000 based machines, ensure that installed Language Pack, selected language, OPgraph-
ic/OPtouch version (> 1.07.59), OPbrowser version (≥ 1.5.14.103) and JMIF’s http encoding match. For
example for Russian (Cyrillic script) select Language Pack 2, language Russian and encoding cp1251.
6.4.33 Undefined destination error although settings are ok

Check on JMIF start or connect, whether the corresponding channel could be opened. Most likely there’s
a resource conflict e.g. a configured port is used by another application on the system.
6.4.34 JMIF is unable to create a work file on upload

Some systems create a so called trigger file. If the file channel’s appending mode is switched on, the
trigger file is empty and there’s no other error messages around, then you have to switch off the trigger
file on host side.
60
6 FAQ
6.5 Operation
6.5.1 License missing error occurs
Most probably you never have a valid license or the systems FQDN was changed. Also check that you
have a valid amount of machine channels licensed and that the other license information did not change.
6.5.2 Why the hell JMIF runs idle without a license

There are several reasons:
• JMIF could be licensed and configured online by changing the property file, especially if JMIF
runs as service or daemon on a clustered or cold stand-by system. Furthermore JMIF need to be
started to get the license data. But a shutdown and restart after one has obtained the license is
not wished.
• JMIF could be licensed and configured over a channel. This is used, if the configuring system is
licensing JMIF on demand.
• There could be special JMIF plugins with separate licensing models.
• Demo Mode.
6.5.3 JMIF stops working after system shutdown

JMIF runs as service or scheduled task on Windows and the used NT-account’s password expired. Take
the local system account if no network resources are used.
6.5.4 Could JMIF clutter the file-system with rubbish?

No. The log file appender uses log rotating with a certain amount of files and a maximum file size. The
file channels history has a configurable cleanup worker which could also be used on the outbound folder.
6.5.5 JMIF hangs

Most likely it seems that JMIF hangs because of a far too big timeout value specified somewhere. Please
note the unit of measure per setting! Other wellknown possible reasons:
• Windows console: JMIF’s runs inside a console and someone has marked some text inside. This
will lock JMIF, too!
• AntiVirus software update on Windows: may lock all other processes for seconds (we saw some
updater blocking the system upto 40 seconds)
• huge system’s date/time adjustments: symptoms are lack of log entries over a certain amount of
time (minutes) and negative logged measurement results. Please check your system logs!
• usage of asynchronous communication while channel’s listner mode is not enabled in combination
with huge timeout values
• log file inaccessible or corrupted e.g. on SSDs: turn off logging into files by removing log
file appender (log4j.rootLogger=debug, stdout) and set log file level on file logging to NONE
(wrapper.logfile.loglevel=NONE )
61
6 FAQ
In case you could exclude all of these reasons and JMIF continues after a restart, please execute the
ctrl dump batch before you restart it next time and before you execute the support file creation batch.
6.5.6 Starting JMIF fails

The most common reasons are:
• missing JRE: check the paths inside the start scripts
• another instance running: check whether JMIF is already started or if one need several instances
check the appLock setting
• another application is using JMIF’s default port 52525 used for application locking: disable the
application lock or configure another, unused port
• a local firewall prevents opening a listening TCP port: adjust firewall’s configuration
• native components not installed: run the install script
• all JMIF’s application folder’s subfolder are gone or never exists (package was not recursivly
extracted or copied)
6.5.7 Process ID of JMIF’s JVM

Starting with version 1.5.25 the PID is logged within the uptime information output.
If this fails (it depends on the JVM implementation) or an older version is used, try to search for an
configured port or the application lock port using a command like netstat -abn:
Proto Local Address Foreign Address State PID
...
TCP 0.0.0.0:15008 0.0.0.0:0 LISTENING 4904
[ java . exe ]
TCP 0.0.0.0:52525 0.0.0.0:0 LISTENING 4904
[ java . exe ]
Listing 3: Sample nestat output
Alternativly you could use jps from JDK and look for a Java process called JmifLoader or JmifSer-
viceWrapper if JMIF runs as service or daemon.
Finally you could look for the system property wrapper.java.pid in JMIF’s log files in case of JMIF
running as service or daemon.
6.5.8 Log File Analysis

Log files could be analyzed and watched live by using tools like grep and tail. For Windows we suggest
e.g. the tools named baregrep and baretail which have graphical user interfaces. Do not use tools which
lock the files for write access!
6.5.9 Reset Log File

For testing or issue analyses purpose a reset of the log file on JMIF start could be helpful. Use following
settings:
62
6 FAQ
log4j.appender.rollingF ile.M axBackupIndex = 0

log4j.appender.rollingF ile.append = f alse
6.5.10 Log Files Missing or Outdated

Log files are cretead by a so called file appender. Appenders do not have to work to run the application.
Therefore JMIF may run without having log files or with outdated log file content. A file appender may
not work, if the log file’s attribute is set to read only, log file’s permissions were changed (e.g. different
user lauching JMIF), log file path is unavailable, log file’s storage system run out of space or log file is
locked by another application. Check file stderr.log or console output for error details.
6.5.11 JMIF is idle

This could have several reasons:
• license is missing: see section 2.5
• invalid configuration: check the log files for errors
• disconnected: JMIF was disconnectd by tray icon, controller file or configuation channel
• no requests: all requests were proccessed successfully or with errors (check log files and JMIF’s
responses)
6.5.12 Out Of Memory Exception

Please check the JMIF start script or the service wrappers configuration.
• start script: maximum heap size should be set to 128M byte using the option −Xmx128m.
• service: check the win32 wrapper.conf file for key
wrapper.java.maxmemory = 128.
In case of ongoing trouble increase the value to 256M byte.
6.5.13 Updating JMIF during Runtime

If JMIF runs as a service, JMIF could be updated even without having access to a console or administrative
rights. This requires following settings in the service wrapper’s configuration files as well as the HALT
command:
• wrapper.restart.delay = 20
• wrapper.on exit.def ault = REST ART
After the HALT command is sent one have 20 seconds to exchange the jar file.
6.5.14 Hide Console Window

Start JMIF using javaw instead of java. On Windows systems insert the start command in front of the
command line. For other system use an ampersand after the command line.
63
6 FAQ
6.5.15 Hide JMIF’s Loader Output

Because of that at this time no logger is avaliable, these information were written to stdout. To prevent
that use
• Windows: java . . . > N U L
• Unix: java . . . > /dev/null
6.5.16 JMIF Service won’t stop

Most likely JMIF runs on a cluster. Connect to the active node and take the corresponding resource
offline using cluster administration console. If you bring back JMIF resource online (i.e. starting the
service) do not forget to bring depended resources online, too.
6.5.17 JMIF won’t stop

Most likely JMIF runs as service or daemon which is watched by a service wrapper. These tools check
the state of running JMIF’s process and restarts it as configured if the process dies. Use the service
manager’s stop function to halt JMIF.
6.5.18 JVM Crashed

We noticed that rarely in combination with usage of native external libraries used via JNI. Create a
support file (contains the JVM crash dump file) and pass it to us. Try another JVM version and/or
vendor.
6.6 T3C
6.6.1 T3C Mask State not updated
In case the mask state is not updated and confirmation on OP is not possible, double check the different
address mappings. For performance reasons JMIF fetches all opening’s state at one time. Therefore you
may not recognize if JMIF polls an inactive, not existing opening. Check JMIF’s log files for so called
injected OP addresses, where JMIF dynamically injects device’s internal addresses into its settings at
runtime (memory only, not persisted).
64
7 HOWTO
7 HOWTO
7.1 Using Media Conveter
Usage of media converter may be recommendable in case of connecting serial devices over ethernet (long
distance, central installation at data center, lack of ports) or to capsulate devices from broadcast storms.
Basic configuration is usally done by console (serial or telnet in combination with ARP or SNMP)
or by proprietary, platform dependent software. We recommend using the serial configuration port
(Hyperterminal, TeraTerm or Minicom).
Further configuations are done by terminal (serial/ telnet) or web based (VSCOM only).
The most critical settings are the destination IP address and port, the end of message detection and
the serial port parameters.
The amount of serial ports per device should be choosed considerung the serial device topology and
aspects of redundancy.
7.1.1 Common FAQ

What is the end of message trigger for T3-based machines? There’s no single one! Please
choose one of the following options:
• exclusive timeout trigger (e.g. 100msec at 9600baud)
• add ACK (0x06), ETX (0x03) and SO (0x0E) as end of message tag additionally to the timeout
trigger of 100msec (note: most convertes treat several delimters as one expected character
sequence and not as different possible separators furthermore T3 expects exactly one datagram
per command!)
• use port mode RawTCP Server
What is the end of message trigger for M M 2xx/M M 5xx based machines? 0x0D
What is the end of message trigger for RLP devices? 0x0A and a trigger timeout of 5msec.
What are the default serial port settings for M M 260 based machines? Baud Rate:
9600, Parity: N one, Data Bits: 8, Stop Bit: 1, Flow Control: N one. Note: Due to the fact, that the
RS pin assignment is proprietary, one has to use an adpater from KARDEX!
Media converter is not ping-able In case all other connections working (local PC to media
converter and JMIF server to local PC) most likely the gateway setting on media converter was not done
or wrong.
I got no communcation - what’s wrong? Go to port statistics of your media converter and
check the sent (TX) and received (RX) byte count. Now you should check the settings between PC and
converter (TX equals zero) or between device and converter (RX equals zero).
In case of multi port converters (2, 4, 8 or 16) double check configured UDP ports for uniqueness.
65
7 HOWTO
After device reset the monitored transfer on serial port is not set to zero - what’s
wrong? Most likely there’s a cabling issue on serial port side. Unplug the serial cable, reset device
and check the traffic counters again. Plugin the cable and check the device’s status after reset anew.
I got no communcation after I changed the port mode - what’s wrong? Check the
COM port settings, sometimes they are linked to the port mode or reset on port mode change.
I got no communcation after I have migrated a JMIF installation - what’s wrong?

Check the distination address of UDP mode’s settings. Most likely your new installation is using a
different IP address.
7.1.2 VSCOM
The following listing illustrates a typical configuration to access a RLP device over UDP. Communication
parameters for serial console are 38400, 8, n, 1, n using null modem cable or adpater. After basic server
configuration is done, one could switch from console to Web-Browser using configured IP adress and port
80. There is no need to install drivers or other software!
+−−−−−−−−−−−−−−−−−−−−−−−−−−− NetCom − 413 V2 . 4 . 1 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+

| ServerConfig SerialPorts Tools Save&E x i t |
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
S e r v e r Parameter
S e r v e r Name [ NETCOM 413 ]

MAC A d d r e s s 0 0 : 0 4 : D9 : 8 0 : 0 F : F4
DHCP Disabled
IP A d d r e s s [192.168.100.30]
Netmask [255.255.255.0]
Broadcast [192.168.100.255]
Gateway [192.168.100.18]
DNS [192.168.100.18]
Domain [ g s s −o n l i n e . com ]
ConfigPort [23 ]
PrintServerPort [515 ]
KeepAlive Off
KeepAliveInterval [0 ]
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− h=HELP −+
Server configuration s e t t i n g s
+−−−−−−−−−−−−−−−−−−−−−−−−−−− NetCom − 413 V2 . 4 . 1 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+

+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
Date and Time S e t t i n g s
Date & Time [29 −04 −2010 1 2 : 0 9 : 5 9 UTC+0 ]
S i m p l e Network Time P r o t o c o l
66
7 HOWTO
State Interval
Mode IP A d d r e s s
Interval [1800 ]
Server [192.168.100.6 ]
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− h=HELP −+
Server configuration s e t t i n g s
+−−−−−−−−−−−−−−−−−−−−−−−−−−− NetCom − 413 V2 . 4 . 1 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+

+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
Serial Settings
P o r t Nr . 1
PortType ( c u r r e n t ) rs232
DefaultModel 16550
MaxBaudrate 921600
Model 16550
Baudrate 9600
Manual 9600
FlowType None
DataBit 8
Parity None
StopBit 1
RxFifoLength 2048
RxTriggerLevel [1248 ]
TxFifoLength 2048
TxTriggerLevel [800 ]
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− h=HELP −+
S e r i a l port configuration s e t t i n g s
+−−−−−−−−−−−−−−−−−−−−−−−−−−− NetCom − 413 V2 . 4 . 1 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+

+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
Transfer Settings
P o r t Nr . 1
Mode UDP Mode
UDP P o r t ( L o c a l ) [10011]
Destination [ de6−pc−r d 0 0 3 ]
UDP P o r t ( D est ) [10001]
UDP M a x P a c k e t S i z e [1458 ]
UDP Timeout [10 ]
UDP T r i g g e r [ \ x0D\x0A ]
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− h=HELP −+
S e r i a l port configuration s e t t i n g s
Listing 4: NetCom - 413 Setup
67
7 HOWTO
FAQ
Why are my settings not stored/ lost after reboot? Most probably you have set the
DIP switches alias operation mode on port 1 to factory settings!
Why connection over crossed ethernet cable for NetCom Manager usage or serial
console access may fail? Reset the device to factory defaults using DIP switches and then back
port 1 to configuration mode. Do not forget to power off/on the device after changing DIP switches!
What are the DIP switch settings for RLP devices Becauase RLP devices connected
using RS232 and operation mode data port is needed, set (S1, S2, S3, S4) = (OF F, OF F, ON, ON ).
7.1.3 MOXA
The following listing illustrates a typical configuration to access a RLP device over UDP. Communication
parameters for serial console are 19200, 8, n, 1, n.
MOXA NPort S e r v e r E x p r e s s V1 . 7
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
[ s e r v e r C o n f i g ] OP mode Serialport Monitor Ping Restart Exit
Config s e r v e r s e t t i n g s
ESC : back t o menu Enter : select
S e r v e r Model DE−211
S e r v e r Name [ NPORT 211 ]
S e r i a l Number 00545
IP C o n f i g u r a t i o n [ S t a t i c IP ]
Ethernet Status 10M bps
MAC A d d r e s s 0 0 : 9 0 : E8 : 1 0 : 7 8 : B0
IP A d d r e s s [192.168.100.32 ]
Netmask [255.255.255.0 ]
Gateway [ ]
Password [ ]
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
s e r v e r C o n f i g [ OP mode ] S e r i a l p o r t Monitor Ping Restart Exit
C o n f i g t h e o p e r a t i o n mode o f t h e s e r i a l p o r t
Port Application More s e t t i n g s

1 [UDP S e r v e r / C l i e n t ] [ S e l e c t f o r more s e t t i n g s ]
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
ESC : back t o menu Enter : s e l e c t | Host Based / D r i v e r Mode |
| P a i r C o n n e c t i o n ( Mas ter ) |
Port Application | Pair Connection ( Slave ) |
68
7 HOWTO
1 [UDP S e r v e r / C l i e n t | TCP S e r v e r |
| TCP C l i e n t |
| UDP S e r v e r / C l i e n t |
| E t h e r n e t Modem |
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
Port Application More s e t t i n g s

1 [UDP S e r v e r / C l i e n t ] [ S e l e c t f o r more s e t t i n g s ]
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
Port A p p l i c a t i o+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
1 [UDP S e r v e | Begin End Port |
| ( s e r i a l t o LAN) |
| De st . IP addr 1 [192.168.100.123][ ][4001 ] |
| De st . IP addr 2 [ ][ ][4001 ] |
| De st . IP addr 3 [ ][ ][4001 ] |
| De st . IP addr 4 [ ][ ][4001 ] |
| (LAN t o s e r i a l ) |
| S r c . IP addr 1 [192.168.100.123][ ] |
| S r c . IP addr 2 [ ][ ] |
| S r c . IP addr 3 [ ][ ] |
| S r c . IP addr 4 [ ][ ] |
| |
| Local L i s t e n Port : [4001 ] |
| D e l i m i t e r 1 ( Hex ) : [ 0A ] |
| D e l i m i t e r 2 ( Hex ) : [ ] |
| F o r c e t r a n s m i t ( ms ) : [5 ] |
+−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−+
MIF01 Channel Example :

Channel32=UDP: 1 9 2 . 1 6 8 . 1 0 0 . 3 2#4 0 0 1 , P o r t =4001
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
serverConfig OP mode [ S e r i a l p o r t ] M o n i t o r Ping Restart Exit
Config s e r i a l port s e t t i n g s
P o r t Number 1
Baud Rate ( bps ) [9600 ]

Parity [ None ]
Data B i t s [ 8 ]
Stop B i t [ 1 ]
Flow C o n t r o l [ None ]
UART FIFO [ Enable ]
Listing 5: MOXA NPort-211 Setup
69
7 HOWTO
7.1.4 Recommended Port Mode
Protocol Port Mode
T3 UDP/ RawTCP (Server)

T4 UDP
MM260 UDP
MM500 UDP
RLP UDP
Net2 RawTCP (Server)
Table 12: Port Mode
Note: In case of mode RawTCP the server’s TCP KeepAlive option should switched on using the desired
keep alive interval. Otherwise an automatic reconnection from JMIF in case of connection lost may not
be possible until server reboot.
70
7 HOWTO
7.1.5 Summary
T3 MM260 RLP Net2
Serial Settings
Interface RS-232 RS-232 RS-232 RS-232

Baud Rate 9600 9600 9600 38400
Data Bits 8 8 8 8
Stop Bits 1 1 1 1
Parity None None None Even
Flow Control None None None None
FIFO Enable Enable Enable Enable
Operating or Transfer Settings
Operation Mode UDP UDP UDP TCP Server

Delimiter/ Trigger 0x06 0x0D 0x0A (0x04)
Force Transmit/ Timeout [msec] 100 100 10 (100)
Max Connections 1
TCP Alive Time [sec] 60 or triggered
Destinatin IP IP of system hosting JMIF
Destination Port unique port configured at JMIF
Local Port listening port
Table 13: Generic Serial Device Server Settings Matrix
All other settings should be kept at device server vendor’s factory defaults.
7.2 Connecting RLP Devices

RLP devices are loosly coupled with the machine (power only). They are controlled using one serial port
per device. Therefore the usage of media converters is stronly recommended.
One could use virtual COM ports based on media converter’s drivers (serial port tunneling over
ethernet). But instead of this we recommend the usage of raw UDP. Raw TCP should work as well but
is rarely used. Do not forget to
• adjust the port mode (common factory default: driver mode)!
• activate the listener mode on UDP channels!
7.2.1 Basic Tests

Before starting any kind of operations do the following tests:
71
7 HOWTO
• switch off the machine and check wether the RLP swing into the plumb-line
• switch on the machine, check wether the RLP drives the initial positions and afterwards is
perpendicularly stoped
If one of the tests failes contact your KARDEX technician.
7.2.2 Configuration and Calibrating

Configuration is done globally or per device while missing local values are replaced by global ones. The
data for carrier length and width as well as the installation height (fixing) per opening are needed.
In case of linear deviation driving some positions calibration is required. Therefore the position
(x, y, z) = (1098, 432, 0) should be used. Measure the real distance to the left front and use this values as
offsets.
The z and z1 offsets could be used in case of machine type does not support reading level of tray’s
level inside the access opening.
To avoid manual calibration JMIF supports since version 1.5.30 automatic y-offset corrections on
standard tray types 610, 813 und 864. Omit settings xOffset and yOffset and just use cLength and
cWidth. In case you need manual calibration use half tray width as reference point and yOffset’s start
value.
If there are non-linear deviations contact your KARDEX technician. If the light spot’s diameter is to
big, consider using the laser head.
Permanent glow is supported by JMIF but there is no guaranty that the RLP not caused damage to
except of low level encoder step mode is used. In case action light does not work in default mode, enable
the initialization, i.e. set skipInit to false. To omit axis initialization only use skipInitAxis.
If there are no millimeter coordiantes available JMIF supports several methods to calculate them from
the given request’s data (linear scaling, mapping or even srcipt based calculation at runtime).
7.3 Connecting TIC Device

7.3.1 Naming
TIC stands for Transaction Information Center, sometimes also called TIC (light) matrix (display), dot
matrix board or (strip) position indicator. JMIF connects to TIC using TIC’s component EIM (Ethernet
Interface Module).
7.3.2 Configuration
The TIC device could be used stand alone or as sub system. Main configuration is done by setting up
the display formattting:
• Module: hardware part of TIC device (a TIC module), amount of modules could be configured
but is detected by JMIF as default
• Segment: part of the whole text to display, position could be changed due to lack of space, maps
to display formmatter’s lines, one upto three segments are supported
• Control Characters: used to show arrows or toggle text blinking, could be used anywhere inside
display formatter’s line spec or directly from host (stand alone mode recommended)
72
7 HOWTO
Figure 17: TIC
– %ˆ% arrow up
– %|% arrow down
– %B% toggle blinking
– %Bˆ% arrow up blinking
– %B|% arrow down blinking
• Positioning: either based on pos and depth using scaling or more accurately (max. ±5mm
tolerance) on millimeter values given by the info fields x and y
• Offset: (left) column offset in millimeter
• Bit Maps: used to replace all non US-ASCII charachters, bit map font designer for Windows
available on demand
7.3.3 FAQ
I want to ues TIC directly without given carrier Carrier zero is used to clear the display.
All other values have no meaning. But if the carrier field is undefined it’s default value is zero! Therefore
any given numeric field could be reused as carrier field, e.g. the code field.
TIC seems to be crashed TIC allows only one client connection. If the client connection was not
closed properly a new one will not be accepted. JMIF detects this situations and resolves it automatically.
73
7 HOWTO
TIC crashed TIC may crash if illegal characters or bit maps were sent. Check message filtering, the
display formatters ASCII mode setup and bit maps used.
7.4 C3000 Position Indicator Vario

C3000 Position Indicator Vario (called Vario) is used to display pick/ store information near to the tray
itself. It is available as dotlight, 2-digit 7-segment numerical display or 1-digit 7-segment alphanumeric
display.
Commonly 2-digit 7-segment numerical display is used where display in the range of pos and pos2
show the value given in depth, e.g. 00 − 00 − 02 − 02 − 00 − 00 − 00 − 00 using position (3, 4) and depth
2 or (2, 2).
There are some common reasons, that Vario do not work properly:
1. Machine Parameter Setup: Vario setup was not done, if all segments permanetly glow (showing 00
or 0 in case of 7-segment display). Contact your local KARDEX service department.
2. Invalid Addressing: the position and depth addresses are 1-based. In case of pos2 and depth2 are
used, values must be equal or greater than the from value. In case of only one value is out of
range, nothing will be displayed.
3. Firmware: new extended display command is not working properly. Use JMIF’s forcedVersion
parameter with hexadecimal value 10900.
7.5 Dual Tray

7.5.1 Basics
The dual tray option on machine side (also called multi-tray presentation) has to be licensed and activated.
Check device’s Operating Manual! It is only recommend in case of
• one opening or time based exclusive opening usage (shift operation)
• uniform location high on all trays
• carrier next data (tray, which should be prepared on the lift) already known at the time, when the
previous carrier is requested or order based workflow
• in combination with a RLP devive the upper level plus the location high is within the RLP device’s
specification.
JMIF tries to switch a position on the fetched tray on demand as well as allow confirmation while
the tray preparation is in progress. But there’s for technical reasons no guaranty that the tray will be
prepared on the lift. The response code belongs in any case to the carrier requested to the opening! The
level (upper/lower) is choosen by JMIF.
In case host system wants to toggle dual tray usage on demand, host systenm could switch off dual
tray usage using same values on fields carrier and carrierNext.
7.5.2 How is it working?

Dual tray enhance tray delivery time by preparing next tray on machine’s lift while operator is working
on the carrier moved into the opening. Figures 19 and 20 illustrate a sample workflow (cross section
view).
74
7 HOWTO
Figure 18: Dual Tray
Figure 19: Dual Tray Sample
75
7 HOWTO
Figure 20: Dual Tray Sample (cont.)
76
7 HOWTO
7.6 Modifying Support File Creation Behaviour

A support file contains all files from JMIF application folder needed to analyse an incident. Default file
name filter is set to a local subfolder called transfer as well as the file name extensions log, properties,
conf, xml, xslt and js. Additional external folders could be added using the setting jmif.support.dirs.
In case ftp access is possible one could configure jmif.support.f tpHostname, jmif.support.f tpU sername
and jmif.support.f tpP assword to automatically upload created support files. JMIF tries to created a
subfolder using the order number from license information to store the files. Because logging is temporarly
disabled during such a support request, there will be no feedback about success or failures.
7.7 Firewalling
If communication between host system and JMIF or JMIF and hardware devices is between different
depatments or even over a WAN it may be neccesary to configured existing Firewalls between involved
systems. That also applies to existing and activated local firewalls. Table 14 lists some common rules.
Communication Partner Direction Protocol Port Note
Host System/ JMIF

JMIF as TCP server IN TCP xxxxx configured port
JMIF as TCP client OUT TCP xxxxx configured port
JMIF/ Devices
C3000 PLC OUT TCP 81
C3000 OP OUT TCP 80 OPbrowser tool
C2000 PLC OUT UDP 2002
C2000 PLC OUT TCP 23 service tool
MM260 AO OUT UDP 2003
Intertex Web UI OUT TCP 80 see table 13
Intertex PLC OUT TCP 4xx0 xx = unit no.
RLP Web UI OUT TCP 80 see table 13
RLP PLC IN, OUT UDP 4xxy xx = unit no., y = AO no.
TIC EIM Web UI OUT TCP 80
TIC EIM PLC OUT TCP 4001
Table 14: Firewall Rules
7.8 Building a JMIF Appliance

A JMIF appliance based on Debian Linux (version 6 squeeze) optionally as virtual maschine could be
quickly build following these steps:
77
7 HOWTO
1. create a virtual machine based on a Linux 2.6 kernel, with 256MB RAM and a 8GB vdisk or use
appropriate hardware
2. boot from Debian’s netinst image
3. use defaults except of tasksel (disable all except of ssh server)
4. on VMwares hypervisor products run apt-get install open-vm-tools, module-assistant auto-install
open-vm -i and apt-get install open-vm-toolbox (you need to add the contrib archive to your apt
source seetings)
5. install a Lightweight X11 Desktop Environment using apt-get install lxde-core gdm
6. install some useful tools using apt-get install xpdf leafpad iceweasel filezilla
7. install default JDK using apt-get install default-jdk
8. install JMIF by uploading installer jar file and launching it
9. configure and start JMIF as needed
78
References
References
[Friedl03] Jeffrey E. F. Friedl: Mastering Regular Expressions, 2nd Edition, O’Reilly & Associates Inc.,
2003.
[Gulu04] Ceki Gülcü: The Complete Log4j Manual: The Reliable, Fast and Flexible Logging Framework
for Java, QOS.ch, 2004.
79
Legal Notice
Legal Notice
c Kardex Software GmbH, Im Bruch 2, 76744 Wörth a.R., Germany.
All rights reseverd woldwide.
This document must not be reproduced, revised, rewritten or converted into a computer language or any
other language in any form or for any purpose using electronic, mechanical, magnetic, optical or any
other means, whether in part or in full, unless express written permission has first been obtained.
Unless authorised by Kardex Software GmbH, any attempt to reproduce or distribute this manual or
to store its contents on data carriers shall be classed as an infringement of copyright and will result in
prosecution.
Product names are quoted for informational purposes only, which by no means constitutes a misuse of
trademarks.
80
History
History
Edition Date Author Comment
1.4.0 2008-10-20/29 db Amendment of JMIF’s manual from 2005

1.4.1 2008-10-31 db Float enhancements
1.4.2 2009-01-27 db Corrections
1.4.3 2009-03-04 db Compiler warnings eliminated, more correc-
tions, transformer infos added
1.4.4 2009-03-11 db Naming conventions, regular expressions
section and dispatcher table added
1.4.5 2009-04-14/17 db Minor updates, FAQs added, known stan-
dard fields added
1.4.6 2009-11-17 db Chainsaw port setting note added, mixed
mode workflow informations added
1.5.0 2010-01-12 db Updates regarding JVM, FAQs OutOfMem-
ory and Proxy infos added
1.5.1 2010-03-03 db Update of supported machine types, infor-
mations about regular expressions added,
FAQ Windows Versions added
1.5.2 2010-04-29 db Sections RLP and HowTo/Mediaconverter
added, FAQ Hide Console Window added
1.5.3 2010-05-11 db Advanced information for JMX added, FAQ
Crypted values added, minor tweaks
1.5.4 2010-05-12 db FAQ JDBC connections added
1.5.5 2010-07-12 db FAQ C3000 Timeout Troubleshooting
added
1.5.6 2010-07-14 db XMPP channel added
1.5.7 2010-07-21 db FAQs and HOWTOs extensions
1.5.8 2010-10-18 db Intertex, streamed channels, special pack-
ages, demo mode, major upgrade
1.5.9 2010-10-21 db infos about Lilith, RawTCP and extended
location data added
1.5.10 2010-10-26 db FAQ added
1.5.11 2010-10-27 db some more FAQs added
1.5.12 2010-11-12 db standard’s order types description added
1.5.13 2010-11-12 db notes on NT service support added
1.5.14 2010-11-25 db FAQs reorganized, FAQ for RLP and ratio-
nal numbers added
1.5.15 2010-12-07 db Note about usage of MSQL Integrated Au-
thentication added
1.5.16 2010-12-08 db Media conveter FAQ extended
1.5.17 2010-12-09 db Minor addition
Continued on Next Page. . .
81
History
Table 15 – Continued
1.5.18 2010-12-13 db media converter informations extended, mi-

nor updates on standard and FAQ section,
FAQ return code mapping added
1.5.19 2010-12-15 db TIC FAQ added
1.5.20 2010-12-21 db TIC configuration basics added, default val-
ues for RegExTelegram items
1.5.21 2010-12-22 db new FAQ subsection security added
1.5.22 2010-12-22 db Work-flow mode 1 notes added, minor up-
dates
1.5.23 2011-01-11 db FAQ about NAK added, FAQ JDBC up-
dated
1.5.24 2011-01-11 db FAQ Reset Log File added
1.5.25 2011-01-20 db FAQ FTP Server added
1.5.26 2011-02-17 db FAQ supported encodings added, org logo
update
1.5.27 2011-03-01 db CI update, media converter HowTo updates
1.5.28 2011-04-07 db DUMP command, FAQ File vs. TCP chan-
nel added
1.5.29 2011-04-13 db FAQs regarding undefined destination and
work file creation error added
1.5.30 2011-04-14 db FAQ dual tray added
1.5.31 2011-04-18 db typesetting enhanced, cyclic typesetting
system update, uninstall sub section added,
FAQ about telegram format added
1.5.32 2011-04-26 db FAQ Starting JMIF as a Service fails added,
JMIF paused caused by corrupted log file
added
1.5.33 2011-06-27 db order type queue state added
1.5.34 2011-07-12 db note on possible return codes of alive tele-
gram added
1.5.35 2011-09-06 db notes about supported channels and devices
inside standard added, Dual Tray HowTo
added
1.5.36 2011-10-25 db sections on includes and property key se-
quence added
1.5.37 2011-10-26 db typos, MM2xx FAQs added
1.5.38 2011-11-04 db alive telgram return code sample added
1.5.39 2011-11-11 db FAQs on NAK and DirectStore timeouts
added; typos fixed
1.5.40 2011-11-14 db Dispatcher and package lists updated
82
History
1.5.41 2011-11-28 db JMIF Service won’t stop FAQ added

1.5.42 2011-11-30 db error code table completed
1.5.43 2012-01-10 db added running JMIF as Linux daemon,
building a JMIF appliance, FAQ JMIF PID,
FAQ JMIF won’t stop; extended FAQ Start-
ing fails
1.5.44 2012-01-13 db Hide JMIF’s Loader Output FAQ added
1.5.45 2012-01-16 db MM2xx Manual Memory Usage and Dis-
play FAQ added
1.5.46 2012-01-27 db minor notes about RLP usage added
1.5.47 2012-02-28 db minor notes about running in x64 JVM
added
1.5.48 2012-03-06 db notes about migrating JMIF installation
added (licensing and media converter us-
age)
1.5.49 2012-03-20 db FAQ Log Files Missing or Outdated added
1.5.50 2012-04-12 db Notes about SQL scripts and tray table
sync cron job added
1.5.51 2012-06-01 db Section about incompatibly changed set-
tings added, T3 delimiter stuff clarified
1.5.52 2012-06-08 db C3000 Position Indicator Vario HowTo
added
1.5.53 2012-06-19 db C3000 character encoding notes added
1.5.54 2012-09-28 db MM2xx, RLP and media converter FAQs
updated, minor tweaks
1.5.55 2012-09-28 db correction: “local JRE” replaced by “pri-
vate JRE”
1.5.56 2012-10-22 db C2000/MM2xx timeout FAQ extended,
C2000 position lamps FAQ added
1.5.57 2012-10-22 db Document class switched to KOMA script
1.5.58 2012-11-13 db C3000 and T3C FAQs added
1.5.59 2012-11-20 db FAQ user device input handling added
1.5.60 2012-12-19 db Error and Event Codes table revised
1.5.61 2013-01-22 db legal folder description added, code 13
added, minor tweaks
1.5.62 2013-06-06 db DIWS channel added
1.6.0 2013-06-06 db JRE minimum requirements changed to ver-
sion 1.6
1.6.1 2013-07-05 db device list revised, RLP configuration notes
added
83
History
1.6.2 2013-07-22 db a media converter FAQ added

1.6.3 2013-07-23 db notes about reverse mapping and field data
types
1.6.4 2013-08-01 db JVM crash dump FAQ added
1.6.5 2013-08-28 db T3 timing and Intertex FAQs added, dual
tray basics reworked, typos fixed, obliga-
tory Legal Notice added
1.6.6 2013-10-07 db Modifying Support File Creation Behaviour
HowTo added
1.6.7 2013-11-11 db MM260 serial connection FAQ added
1.6.8 2013-12-17 db some more well known C2000 timeout rea-
sons added
1.6.9 2014-01-10 db Interfaces and Dispatchers table updated
1.6.10 2014-02-28 db FAQs Switch Port Security and WinNT 6.2
and 6.3 Tips and Tricks added
1.6.11 2014-04-08 db notes about Java properties file format
added
1.6.12 2014-04-11 db compatibility note added, table design re-
worked
1.6.13 2014-04-24 db Generic Serial Device Server Settings Ma-
trix added
1.6.14 2014-07-03 db Query Extended Storage Location Informa-
tion FAQ clarified
1.6.15 2014-07-09 db RLP deviation on Y-axis FAQ added
1.6.16 2014-07-17 db dispatcher table updated
1.6.17 2014-07-25 db C3000 acts strange and showing mysterious
texts FAQ added
1.6.18 2014-09-22 db order type code 63 added
1.6.19 2014-10-15 db Firewalling HowTo added
1.6.20 2014-10-30 db note about support scripts added; chap-
ter Quick Migration Steps added; Media
Converter FAQ added
1.6.21 2014-11-04 db FAQ C3000 Measurement Units added
1.6.22 2015-01-19 db FAQ RLP device sporadically encounters
an obstacle
1.6.23 2015-01-20 db Response messages undeliverable on TCP
connections refined, Incompatibly Changed
Settings entry added
1.6.24 2015-02-02 db Incompatibly Changed Settings section up-
dated
84
History
1.6.25 2015-03-20 db DirectStore timeouts figure added

1.6.26 2015-03-26 db FAQs for NT services and media converter
extended
Table 15: Document History
85
We’re always happy to receive constructive criticism.
typeset by LATEX

JMIF - Manual Da Aplicação

Uploaded by

Copyright:

Available Formats

JMIF - Manual Da Aplicação

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

JMIF - Manual Da Aplicação

Uploaded by

Copyright:

Available Formats

2003-2015, Kardex Software GmbH

6.4.15 MM2xx Manual Memory Activated . . . . . . . . . . . . . . . . . . 56

6.5.16 JMIF Service won’t stop . . . . . . . . . . . . . . . . . . . . . . . . 64

• platform independence through Java

• based on established and experienced open source libraries

• runs locally without any system modifications

• Console-/ Service application (no GUI)

• plug-in enabled on all levels

• running dozens of machines on one channel w/o any performance impacts

• format independent, centrally manageable settings

• extensive options for (centralized) monitoring

1.2 Standard Deployment Scenarios

Figure 1: Simple scenario showing some supported devices

Figure 2: hostLINK scenario for SAP connection

Figure 2 demonstrates a sophisticated SAP connection using our hostLINK module.

Figure 3: JMIF as gateway between host and PowerPick

• JMIF T3-TIC-Trap (controlling TIC display using given T3 telegrams)

• Driving with a bar code scan without connected host system

1.3 Project Planning

• customer’s basic requirements

• deployment (host, devices, target platform)

• define request and response

• define display format(s)

• specify host protocol

• specify telegram structure

Vendor System Standard

Table 1: Interfaces and Dispatchers

• RAWJMS: MOM connection (MQ Series or JMS)

• HL7GW: Health Level 7 data exchange

• HLFILE: SAP connection via MOM using hostLINK

• XMLHT: XML processing

1.4 JMIF’s components

Figure 4: JMIF Structure

1.4.5 Request and Response

A formatter controls the layout of a display (normally within a panel on a physical

2.2 Installing JMIF

• JRE version check

• multiple installations possible

• optional creation of an installation script for automatic deployment

Figure 5: JAR Installer

Figure 6: SFX Installer

2.3 Files and Folders

• jre/: contains the private JRE

• legal/: contains legal stuff

• lib/: contains all deployed and required libraries

• transfer/: commonly used file channel’s data exchange folder

• doc/: contains the PDF manuals

• native/: installation source of native and platform depended components

• jmif.jar: the application itself

• jmif.properties: configuration file

• stderr.log: error messages which occures before JMIF’s logger is loaded

• jmif.log*: JMIF’s log file(s)

• *.bat: useful Windows batch files

• *.sh: useful Unix shell scripts

2.4 Setting up JMIF

• comma: separates values in a list, if value is considered as list of sub values

• left- and right-hand blanks or tabs: removed during reading

2.5 Obtaining a License