Users and Developers Manual B-COMM WIN32 V4.4

1 Users and Developers Manual B-COMM WIN32 Users and Developers Manual B-COMM WIN32 Bedas is a registered trade-mark of Kaba Benzing GmbH Legic is a registered trade-mark of the Kaba group KABA is a registered trade-mark of Kaba Schliesssysteme AG 2000 Kaba Benzing GmbH, Schwenningen All rights reserved. The work and ist parts are copyright. Any use in cases other than the ones legally permitted without Benzing s approval is forbidden and punishable. This is especially valid for duplications, translations, microfilm recordings and storage and processing on electronic systems.

2 _____ _____ 04/2005 Manual B-COMM WIN32 including user data communication 5 Table of Contents Table of 1. Introduction ..10 Concept ..11 System Installation ..14 2. Using the Program ..15 3. Program Operation ..29 File ..29 Print system messages ..30 Display system Delete system Debug file(s)..32 Exit ..32 Transmit master record file ..34 Autom. master record download ..40 Master record Request bookings ..49 Control buffer Set date/time ..53 Transmit display Transmit transparent data ..57 Summer/Wintertime setup ..59 Seconds/User language in data Configuration ..64 Client management ..65 Terminal logon ..66 Update terminal program Set operating Add new terminal type ..76 Initialize communication Start options ..84 Directories ..86 Printer File FTP Transfer configuration ..92 Change Backup.

3 94 Restore ..96 _____ _____ 6 Manual B-COMM WIN32 including user data communication 04/2005 Services ..100 Deutsch/English GB/English US ..102 Set PC date/time ..103 System setup ..104 AT Modem ..105 Create modem parameter file ..107 Device Software download ..112 Parameter setting ..114 Parameter Parameter download ..118 BETA setup by BETA setup by ARP and Telnet ..122 Order ..125 Display orders ..126 Delete all orders ..129 Start Stop communication ..132 Info ..133 About B-COMM ..134 System Version informations ..135 Terminal status ..136 Licence registration ..136 Help ..138 Tooltip help ..138 4. The application SHOWDBG ..141 5. The application Configuration ..149 Data records from TERMSTAT to BCOMMIO ..150 Data records from BCOMMIO to TERMSTAT ..151 Communication between BCOMMIO and TERMSTAT.

4 153 Data records of TERMSTAT ..153 Data records of 6. The B-COMM WIN32 file system ..154 7. Data Transfer Kernels BCOMMIO and BCOMMFTP ..155 Terminal configuration file TERMDEF.<Stream>..161 Configuration file ..164 Order file ORDER.<Stream> ..170 Order ANALYSE ..175 Order MESSAGE ..175 _____ _____ 04/2005 Manual B-COMM WIN32 including user data communication 7 Order MODEMPAR ..176 Order Order READCFG ..177 Order READTDF ..177 Order Order REDAOFF ..178 Order Order Order STATUS ..180 Order Order SWMEM ..181 Order TIMEDAT ..182 Order UPDPRGNO ..183 Order WRDATRA ..183 Order WRPARA ..184 Order WRPEAUTO ..184 Order WRPEHAAU ..185 System Message File SYSMESS.<Stream>..186 Parameter File Booking file ..201 8. Translation into other 9. Call Interface ..204 Shared Memory ..204 DLL SetCIHandle ..205 SetImmDataHandle.

5 205 ReadCISharedMem ..207 WriteCISharedMem ..209 GetBCOMMIOS tatus ..209 ImmediateSTOPLINE ..210 SendImmediateData ..210 Program flow in a CI program ..211 The Active-X Control Properties ..214 AutoAcknowledge ..214 AutoDisconnect ..214 CIError ..215 ConnectInterval ..215 ConnectRetries ..215 DebugLevel ..216 LEDS hape ..216 OnlineBooking ..216 _____ _____ 8 Manual B-COMM WIN32 including user data communication 04/2005 SendInterval ..217 Stream ..218 UpdateInterval ..218 WindowSize ..218 DisconnectFromBCOMMIO ..219 ReadBCOMMIOS tatus ..219 SendDataToBCOMMIO ..220 ShutdownBCOMMIO ..220 Events ..221 evBCOMMIODown ..221 evBCOMMIORead ..221 evBCOMMIOS tatus ..221 evDataRecordReceived ..222 evBCOMMIOO rderEnd ..222 evBCOMMIOO rderRestart ..223 evImmediateDataAck.

6 224 evImmediateDataNack ..224 Messages ..226 SM_WRITE ..227 SM_READ ..227 BCOMMIO_DOWN ..228 BCOMMIO_UP ..228 BCOMMIO_STATUS ..229 IMM_DATA_ACK ..229 IMM_DATA_NACK ..230 ORDER_END ..231 ORDER_REP_START ..231 DDE ..232 Commands from the CI Program to BCOMMIO ..233 Additional Records from BCOMMIO to the CI Program ..236 Flow of Communication ..237 Configuration of the Call Interface ..240 10. Table of 11. Index ..246 _____ _____ 04/2005 Manual B-COMM WIN32 including user data communication 9 _____ _____ 10 Manual B-COMM WIN32 including user dara communication 04/2005 1. Introduction The B-COMM WIN32 program package serves to transfer data between Kaba Benzing terminals and a host. The program transfers the records acquired by the terminals in files or sends it by use of a defined interface, the so called Call Interface (see chapter 9 Call Interface) to an application.

7 These files or data records can be linked to any application, time recording or the wages package etc. Data such as user information, the time and the date or master personnel data can also be transferred from the host to a terminal. Furthermore, the parameter settings of terminals can be managed centrally on the host and transferred to the terminals. With the B-COMM WIN32 version, Kaba Benzing terminals can be operated in the ONLINE, OFFLINE and AUTONOMOUS modes. In doing so, data is exchanged between the terminals and the host in files or by the Call Interface. Communication orders are also sent in corresponding files. The software package essentially contains three function modules. Installation is supported by an installation routine. The I/O module (input/output) BCOMMIO (respectively BCOMMFTP for FTP data transfer) is responsible for actual communication with Kaba Benzing terminals.

8 The BCWIN maintenance program serves to control and operate the I/O module. BCWIN is not a replacement for an application written by a software partner, but is only used to configure the terminal system. Using the maintenance program, all functions of the package can be controlled and coordinated manually. The tasks of the control program can be assumed by any application program. Various commands, which can be stored in the order files by the application, are available for this purpose. The following can be carried out using the program package described here: - configuring the terminal system - handling communication with the terminal system - maintenance of the terminal system _____ _____ 04/2005 Manual B-COMM WIN32 including user data communication 11 Concept The program package contains 13 modules: Installation program SETUP Maintenance program BCWIN Communication program BCOMMIO for LAN and serial streams (see chapter 7 Data Transfer Kernels BCOMMIO) Communication program BCIOSRV for LAN and serial streams to work as a service (see chapter Services) under Windows NT, Windows 2 and Windows XP Function library (see chapter DLL function) for use of the Call Interface Demo programs BCCITEST, BCCIWIN and BCCIDEMO for use of the Call Interface via Shared Memory (see chapter Shared Memory)

9 Demo program BCCI_DDE for use of the Call Interface via DDE Starter program BCIOSTRT to start the streams from a remote PC Converter program DDE2 SMEM for conversion between DDE and Shared Memory Program SHOWDBG for an easy display and analysis of the debug files, which are created by the I/O module BCOMMIO (see chapter 4 The application SHOWDBG) Program BCUTIL for manipulating the terminal configuration and order files Commandline program WRTORDER, with which orders can be inserted into an order file _____ _____ 12 Manual B-COMM WIN32 including user dara communication 04/2005 Additionally you can order the following chargeable options: Communication program BCOMMFTP for FTP transfer of master record files, parameter files and transparent date to terminals of type Bedanet 938 (B-Net 938 ) Program TERMSTAT to graphically display the state of the communication streams and the connected terminals (see chapter 5 The application TERMSTAT) Parameter editors for terminals of the series 929 , 93xx inclusive Bedanet 938 (B-Net 938 ), 952 , 954 , 956 and 98xx Programming module AVISO to program 929 terminals Programming module BEDAPRO to program 956 terminals _____ _____ 04/2005 Manual B-COMM WIN32 including user data communication 13 When the communication program BCOMMIO is mentioned in this Manual , then everything is always valid also for the service version BCIOSRV.

10 Under the OS versions Windows NT , Windows 2000 and Windows XP the communication stream BCOMMIO could also be uses as a service. The BCOMMIO communication program handles all communication with the terminals and stores all received data in files. The terminals can be addressed via a serial interface, a modem, Ethernet, or Token Ring. Therefor so called streams have to be created and configured (see chapter Initialize communication stream). A maximum of 3 streams can be created (stream numbers to 29). One stream with the number 3 is always existent and therefor has not to be created by the user. This stream is used for transmitting master records (see chapter Transmit master record file and Autom. master record download), transparent data (see chapter Transmit transparent data) and parameter settings (see chapter Parameter setting) to one or more Bedanet 938 (B-Net 938 ) terminals.