Manual_connect.brain_en.pdf k1o27

_connect.BRAIN Operating instructions as of program version 3.05 38.026.297.001 en

Alle Rechte vorbehalten All rights reserved Tous droits réservés Reservados todos los derechos Tutti i diritti riservati © 11/2011 Bizerba GmbH & Co. KG, 72336 Balingen P.O. Box 10 01 64 72301 Balingen, Telephone (+49 7433) 12-0, Fax (+49 7433) 12-2696 Email: [email protected] Internet: http://www.bizerba.com

Translation of original operating instructions

38.026.297.001 en

Operating instructions _connect.BRAIN

Contents

Contents 1

2

3

4

5

Page About these instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.1

Safe-keeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

1.2

Target group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

1.3 1.3.1 1.3.2 1.3.3

Symbols used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How notes and information are depicted . . . . . . . . . . . . . . . . . . . . . . . . . . How safety warnings are displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing of menu call-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 7 8 8

About the software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

2.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

2.2

Right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

2.3

Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

2.4

Virus protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

3.1

License packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

3.2

Developer mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

3.3

Software protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12

BizInfo - application information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

4.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

4.2

Application tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

4.3

Modul tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

4.4

System tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15

4.5

Directories tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

4.6

License tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17

4.7

3rd party tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17

Device connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

5.1 5.1.1 5.1.2 5.1.3 5.1.4

18 18 18 19 20

Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connection establishment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connection clear-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38.026.297.001 en

1

Contents

5.2 6

7

8

2

Operating instructions _connect.BRAIN

ADDI-DATA I/O board MSX-E1516 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

Use on terminal servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21

6.1 6.1.1 6.1.2 6.1.3 6.1.4

Citrix terminal server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing _connect.Brain on a Citrix terminal server . . . . . . . . . . . . . . . . Configuring s for _connectServer . . . . . . . . . . . . . . . . . . . . Settings in the registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using a serial port in a Citrix session . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21 21 21 22 22

6.2 6.2.1 6.2.2 6.2.3

Windows Terminal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing _connect.Brain on a Windows terminal server . . . . . . . . . . . . Temporary network breakdown when using a serial interface . . . . . . . Using VirtualES when _connectServer has been installed as service .................................................................

22 22 23 23

_connectServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

7.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

7.2 7.2.1 7.2.2 7.2.3 7.2.4

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring _connectServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operating modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Asg s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring operation in the network . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24 24 25 26 27

_connectConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

8.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

8.2

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

8.3

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30

8.4

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31

8.5

Functions in the work area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34

8.6 8.6.1 8.6.2 8.6.3

_connectServer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Common" tab.................................................................................... "Connections" tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Devices" tab.... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34 35 38 46

8.7 8.7.1 8.7.2 8.7.3 8.7.4

_connect2File Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Naming log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Common" tab.... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Files" tab....... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Devices" tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

50 50 51 52 54

8.8 8.8.1

BHI Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding and deleting master/slave devices and department . . . . . . . . .

57 59

38.026.297.001 en

Operating instructions _connect.BRAIN

9

10

11

Contents

8.9 8.9.1 8.9.2

Wizard for creating devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating new devices using a wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copying devices using the wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

60 60 61

8.10

Creating links to devices of other _connect.BRAIN clients . . . . . . . . . .

61

_connectDiagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

62

9.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

62

9.2

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

62

9.3

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

63

9.4

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

63

_connect2File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

65

10.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

65

10.2

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

65

10.3

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

66

10.4

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

67

10.5

Functions in the connection windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

68

10.6 10.6.1 10.6.2 10.6.3 10.6.4

File transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data transfer from host to _connect2File . . . . . . . . . . . . . . . . . . . . . . . . . . Data transfer from _connect2File to host . . . . . . . . . . . . . . . . . . . . . . . . . . Controlling data output by events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

68 69 70 70 71

10.7

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

73

_connect2DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

75

11.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

75

11.2

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

75

11.3

Database setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

75

11.4

Database structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

77

11.5

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

77

11.6

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

78

11.7 Defining filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.7.1 Creating filter using the wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.7.2 Creating filters manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

79 80 81

11.8

Renaming filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

81

11.9

Editing filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

82

38.026.297.001 en

3

Contents

12

13

4

Operating instructions _connect.BRAIN

11.10

Defining handling of complex device commands . . . . . . . . . . . . . . . . . . .

83

11.11

Deleting filters and relevant database tables . . . . . . . . . . . . . . . . . . . . . .

85

11.12

Exporting data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

85

11.13

Data export via command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

86

11.14

Configuring _connect2DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

88

11.15

Deleting database contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

90

11.16

Backing up and reloading data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

90

_connect2SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

92

12.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

92

12.2

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

92

12.3 12.3.1 12.3.2 12.3.3

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . _connect2SAP configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAP configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Packing table configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

93 93 94 97

12.4

_connect2SAP Frontend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

99

12.5

_connect2SAP Registry and _connect2SAP Spooler . . . . . . . . . . . . . . 100

12.6 12.6.1 12.6.2 12.6.3 12.6.4

_connect2SAP Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

101 101 101 102 102

12.7 Functional components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.1 Overview of functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.2 Z_RFC_BCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.3 Z_RFC_BCT_MULTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.4 Z_RFC_BCT_PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.5 Z_RFC_BCT_SPOOLER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.6 Z_BCT_LABEL_GLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.7 Z_BCT_DIMENSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.8 Z_BCT_REG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.9 Z_BCT_NULLSTELLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7.10 CFB_RFC_BCT_MULTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

103 103 104 104 105 105 106 110 112 116 117

_connectScannerWI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 13.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

13.2

Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

13.3

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

38.026.297.001 en

Operating instructions _connect.BRAIN

14

15

16

17

Contents

13.4

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

13.5

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

13.6

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

13.7

Functions in the context menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

VirtualES - View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 14.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

14.2 14.2.1 14.2.2 14.2.3 14.2.4

VirtualES - . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining new configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

121 121 122 123 123

14.3 14.3.1 14.3.2 14.3.3 14.3.4 14.3.5 14.3.6

VirtualES - View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Start program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display data records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Registration of weighing results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

124 124 124 125 126 126 126

_edit.BRAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 15.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

15.2

Starting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

15.3

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

15.4

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

15.5

Functions in the context menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

LogPathConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 16.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

16.2

Program structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

16.3

Menu bar and toolbar functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

16.4

Deleting log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Background information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 17.1

Device families . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

38.026.297.001 en

5

Contents

17.2 17.2.1 17.2.2 17.2.3 17.2.4 17.2.5 17.2.6 17.2.7 18

Operating instructions _connect.BRAIN

BxNet language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Telegram structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coding of the data description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BxNet data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coding of the useful data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dimensionful data: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coding of prices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coding of weights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

134 135 135 136 136 137 137 138

Program interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 18.1 _connectServer DCOM communication interface . . . . . . . . . . . . . . . . . . 139 18.1.1 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 18.1.2 Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 18.2 _connectServer DCOM information interface . . . . . . . . . . . . . . . . . . . . . . 157 18.2.1 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 18.3 18.3.1 18.3.2 18.3.3

_connectControl DCOM communication interface . . . . . . . . . . . . . . . . . Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

165 166 167 189

18.4 BctFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 18.4.1 Conversion function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 18.4.2 Parse functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

6

38.026.297.001 en

Operating instructions _connect.BRAIN

About these instructions

1 1

About these instructions

Read the operating manual through carefully before installing and using the program, to ensure that you fully utilize the quality and possibilities of application offered. We offer training in relation to our products. Please your Bizerba consultant for details. Our products undergo continuous further development and are subject to different countryspecific regulations. Examples of pictures and graphics included in these instructions may vary from the version you receive.

1.1

Safe-keeping

The operating manual is an integral part of this software and must be kept easily accessible for all personnel. If selling or ing on the software to others, the complete operating manual must also be provided.

1.2

Target group

Basic knowledge of the MS-Windows interface is advantageous for operation of the program.

1.3

Symbols used

The following symbols can be found in the manual: Text with arrow prompts you to carry out an action. Position number in figure. 1 "Display"

Text inside a < > refers to a key or softkey. Text inside a " " refers to display text.

Prerequirements are displayed with a gray background.

1.3.1

How notes and information are depicted

Notes and information are depicted as follows: Observance of these notes is mandatory.

This information is provided for greater understanding.

38.026.297.001 en

7

About these instructions

Operating instructions _connect.BRAIN

1 1.3.2

How safety warnings are displayed

The signal word above the symbol indicates the risk level. DANGER

Source of danger with high risk with direct threatening danger for personnel! Resulting in:

WARNING

– –

Critical injuries Serious health damage

–

Measures for prevention of danger are highlighted.

Source of danger with medium risk with potentially threatening danger for personnel! The consequences can be:

CAUTION

– – –

Serious injuries Health damage Serious damage to property

–

Measures for prevention of danger are highlighted.

Source of danger with slight risk with potentially threatening danger for personnel! The consequences can be:

CAUTION

– –

Injuries Damage to property

–

Measures for prevention of danger are highlighted.

Source of danger, improper use! Damage to property can result. –

1.3.3

Measures for prevention of danger are highlighted.

Viewing of menu call-up

In order to present the menu navigation clearly and concisely, this manual makes use of the following abbreviations (example): <Start> / "All programs" / "Bizerba" / "BspLicenseManager" / "BspLicenseManager"

8

38.026.297.001 en

Operating instructions _connect.BRAIN

2

About the software

About the software

2

With _connect.BRAIN, Bizerba industrial scales, marking systems and printers can be connected with a single communication software package. Regardless of the connected device types, these communicate via the Bizerba standardized BxNet language and so control all your processes. This communication tool permits all industrial scales, marking devices and printers to be connected very quickly and efficiently to a customer-specific EDP.

2.1

Overview

The software _connect.BRAIN includes the following programs: _connectControl _connect2File

Bizerba Communication Control File-based device communication

_connectServer

Bizerba Communication Server

_connectConfig

Configuration tool

_connectDiagnostics

Diagnostic tool

_edit.Brain

Log view

_connect2DB

Data transfer to a database

_connect2SAP

Data transfer to the SAP system

_connectScannerWI

Connection and operation of a barcode scanner

VirtualES

Data transfer to a verifiable memory

Illustration 1: Communication diagram

2.2

Right

All rights regarding this documentation and the software program are held by Bizerba. The information in this document can be modified without providing any special notice. BIZERBA is not under any obligations with regard to this document.

38.026.297.001 en

9

About the software

2

Operating instructions _connect.BRAIN

Proper purchase of the software licenses and instructions enables the programs to be used in accordance with the number of licenses. Copies on CD are only permitted for data backup purposes (working copies).

2.3

Warranty

Despite all efforts made, errors cannot be completely ruled out of descriptions. We welcome your hints or comments at all times. We are not responsible for damages caused by: – – –

Non-observance of these operating instructions. Incorrect electrical installation by customer. Changes to the operating system and configuration and to our software and configuration.

This warranty does not cover defects / damage caused by unauthorized persons. Our products are constantly further developed and are subject to various country-specific regulations. Examples of pictures and graphics contained in these operating instructions may vary from the version which you received.

2.4

Virus protection

This software is manufactured and supplied without viruses based on the latest technology. However, there is always a possibility that a computer may be contaminated by computer viruses or other damaging software. For your own safety, we recommend to run anti-virus software on your computer on a regular basis and after loading software. Furthermore, we recommend to check on viruses after loading software of other manufacturers or data carriers. We recommend that you purchase an anti-virus program for virus analysis, which is constantly updated to the latest status.

10

38.026.297.001 en

Operating instructions _connect.BRAIN

3

Licensing

3.1

License packages

Licensing

3

For the operation of _connect.BRAIN, the following license packages are available:

Professional

Basilus

Basic

Licenses for

CX

GX

IX

MX

CX

GX

IX

MX

X

-

-

-

X

-

-

-

-

-

1 CX device

-

X

-

-

-

X

-

-

-

-

1 GX device

-

-

X

-

-

-

X

-

X

X

1 IX device

-

-

-

X

-

-

-

X

X

X

1 MX device

X

X

-

-

1 device in _connect2DB

X

X

-

-

1 device in _connect2File

X

X

-

-

1 device in _connect2SAP

X

-

X

-

1 device in VirtualES

Device assignment License for CX device: License for GX device: License for IX device:

License for MX device:

3.2

CWM, CWE, CWD, CWP GD, GH, GLP, GS, GV, GLM-I, GLM-E, GLM-B, GLM-P, GLM-L, GLF, GLM-E Retail BT, EL, WM, CWL Eco, ITC1, ITC2, ITC-S, ITE, IST, ITL, ITU, MCE, MCI, ST, NTScale Software: PSS Other devices: Siemens 3964R, scanner, terminal, ADDI-DATA IO card, ADDIDATA IO board BVS - Bizerba Vision System

Developer mode

The following limitations apply to the developer mode: – – – –

A maximum of 50 telegrams can be transmitted 1000 ms delay during telegram transmission When opening the connection, standby time of 5 s before interface opens Communication possible with one device only

38.026.297.001 en

11

Licensing

3.3

3

Operating instructions _connect.BRAIN

Software protection

The _connect.BRAIN software is protected by means of cryptographic functions. Software and device licenses are activated by a license key. They can be obtained from the sales or department. Each connected device and, if needed, specific functions require appropriate licenses. For the operation of _connect.Brain, the Bizerba Software Protection (BSP) has to be installed. _connect.BRAIN communicates with BSP and allows access to enabled devices and functions. The license manager BspLicenseManager allows access to the license management. Call up license manager <Start> / "All programs" / "Bizerba" / "BspLicenseManager" / "BspLicenseManager"

12

38.026.297.001 en

Operating instructions _connect.BRAIN

BizInfo - application information

4

BizInfo - application information

4.1

Overview

Information about the program and its environment can be viewed via the menu item "?" of a program and the submenu item "Info about ...". The information is found on different pages, which can be selected clicking the corresponding tabs. Independent from the selected tab, the following buttons are always available. Close the information window. Save complete information in a zipped file. Opens the Netviewer dialog. Send e-mail to a previously entered recipient. The complete information is attached to the email as a zipped file.

4.2

Application tab

The "Application" tab contains program information.

Illustration 2: "Application" tab

38.026.297.001 en

13

4

BizInfo - application information

4.3

Operating instructions _connect.BRAIN

Modul tab

The "Modul" tab lists all programs required by the application. Missing files are marked with a red icon.

4

Illustration 3: "Modul" tab Info

Description

C:\Programme\Bizerba\...

Folder-/Directory path to file

{C50E6FA0-474E-4F66-9720-7 ActiveX component license key C7637047214} BCS.BCSCommunication.1

Name of ActiveX license key

23.06.2006 11:45

Time of creation of program or component

3444798 Bytes

File size in bytes

ProdVer: ...

Product version

FileVer: ...

File version

14

38.026.297.001 en

Operating instructions _connect.BRAIN

4.4

BizInfo - application information

System tab

The "System" tab contains the following information: – Information on operating system – Information on network – Information on processor (U) Information on system memory – – Information on the hard disks

4

Illustration 4: "System" tab

38.026.297.001 en

15

BizInfo - application information

4.5

Operating instructions _connect.BRAIN

Directories tab

The "Directories" tab contains the read-only attributes of the single directories.

4

Illustration 5: "Directories" tab Read-only directory. File cannot be read or edited. Read-only file. File/directory cannot be read or edited.

16

38.026.297.001 en

Operating instructions _connect.BRAIN

4.6

BizInfo - application information

License tab

The "License" tab contains information on all modules available within this program and on available and unused licenses. Furthermore, the "BspLicenseManager" button allows to open the BSP license manager. To activate the button, select a main item.

Illustration 6: "License" tab

4.7

3rd party tab

The "3rd party" tab contains all third party applications that are installed together with the _connect.BRAIN setup.

Illustration 7: "3rd party" tab

38.026.297.001 en

17

4

Device connection

5

5

Device connection

5.1

Modem

5.1.1

Overview

Operating instructions _connect.BRAIN

For modem connection, two different pre-configured modems are required. The PC-side modem is called the transmitting modem, the device-side modem is the receiving modem.

5.1.2

Configuration

Create transmitting modems in the systems in modem pools and allocate them to the devices via modem connections. When opening a modem connection, _connectServer uses the next free transmitting modem of the assigned modem pool. Configure transmitting modems, modem pools and modem connections in _connectConfig, see page 45.

18

38.026.297.001 en

Operating instructions _connect.BRAIN

5.1.3

Device connection

Connection establishment

_connectServer configures the serial interface to which the modem is connected according to the settings in _connectConfig. It opens the serial interface and initializes the modem. The initialization process is determined by the parameters set in the modem and modem connection configurations, see page 45. Three attempts are initially made to actuate the modem. Procedure of each attempt: 1. Wait for "Serial-Com-Delay" time (modem). 2. Send AT\r\n sequence to the modem. 3. Wait for positive answer. Timeout for receiving an answer is the "Response-Timeout" time (modem connection). If the modem cannot be actuated after three attempts, the connection establishment process is terminated. If a modem connection can be established, the parameters are sent to the modem. Not set parameters are ignored. Procedure: 1. Transmit "Pre-Dial-String" (modem connection). Timeout is the "Response-Timeout" (modem connection). 2. Transmit "Pre-Dial-String2" (modem connection). Timeout is the "Response-Timeout" (modem connection). For Bizerba modem configurations, this string is normally not required. It has been created because some modem commands (e.g. reset, template loading) can only be separately sent to the modem and not together with other commands. 3. Transmit "Pre-Dial-String" (modem). Timeout is the "Response-Timeout" (modem connection). 4. Transmit "Pre-Dial-String2" (modem). Timeout is the "Response-Timeout" (modem connection). 5. Transmit "Dialstring" (modem connection). 6. Timeout is the "Dial-Timeout" (modem connection). 7. Transmit "Post-Dial-String" (modem connection). Timeout is the "Response-Timeout" (modem connection). The "Post-Dial-String" of the modem connection is not a modem command (no leading AT). It can be used to configure a serial switch after the modem, for example. 8. Transmit "Post-Dial-String" (modem). Timeout is the "Response-Timeout" (modem connection).

38.026.297.001 en

19

5

Device connection

5.1.4

Operating instructions _connect.BRAIN

Connection clear-down

Before closing the modem connection, the below mentioned commands are transmitted to the modem. Not set parameters are ignored.

5

1. 2. 3. 4.

Wait for "Silent-Delay" (modem). Transmit +++. Wait for 200 ms. Transmit HO. Timeout is the "Response-Timeout" (modem connection). 5. Wait for "Hook-Off-Delay" (modem). 6. Transmit "Post-Hook-String" (modem connection). Timeout is the "Response-Timeout" (modem connection). 7. Transmit "Post-Hook-String" (modem). Timeout is the "Response-Timeout" (modem connection). The serial interface is then closed.

5.2

ADDI-DATA I/O board MSX-E1516

_connect.BRAIN s the ADDI-DATA I/O board MSX-E1516. _connectServer/DigitalIO and the I/O board communicate via Ethernet. According to ADDI-DATA, the I/O board must not be used as safety resource. This means, that inputs or outputs in safety relevant areas must not be controlled by this I/O board. About installation and configuration When installing and configuring the I/O board, make sure that only one computer communicates with the I/O board. Access of more computers or _connect.BRAIN installations to the I/O board is not ed. It may cause problems when controlling outputs or signaling inputs. About operation Make sure that the network load between _connectServer/DigitalIO and the I/O board does not become excessive during operation. If the network load is excessive, inputs and outputs may be controlled too slowly and the I/ O board watchdog (monitoring program) will report an error. In this case input and output control is no longer reliable.

20

38.026.297.001 en

Operating instructions _connect.BRAIN

Use on terminal servers

6

Use on terminal servers

6.1

Citrix terminal server To ensure that _connect.Brain can work with the licensing, the client must be located in the same domain as the server. Otherwise _connect.Brain works in the developer mode only.

6 6.1.1

Installing _connect.Brain on a Citrix terminal server

To install _connect.Brain on a Citrix terminal server, proceed as follows: "Start" / "Settings" / "System control" / "Software" / "Install" Answer the question whether _connect.BRAIN shall be available on all clients with Yes or No. In the event of auto installation, _connect.BRAIN has to be ed on the client again.

6.1.2

Configuring s for _connectServer

Under DCOM configuration, the BCS configuration has to be set to " starting application". "Start" / "Settings" / "System control" / "istration" / "Component services" "Component services" / "Computer" / "Workstation" / "DCOM configuration" Call up context menu for "BCS". Select "Properties". Call up "Identity" tab. Activate " starting the application".

Illustration 8: BCS properties

38.026.297.001 en

21

Use on terminal servers

6.1.3

Operating instructions _connect.BRAIN

Settings in the registry

If the BCS is always active on the terminal server, the following key can be entered in the registry, so that the last Citrix application ends the BCS: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI

A new character string, called "LogoffCheckSysModules" is created, whose value is the name of the task. In this case: "BCS.exe".

6

6.1.4

Using a serial port in a Citrix session

A batch file must be executed in the Citrix session, which maps the COMx port, for example: "net use COM1: \\client\COM1"). Subsequently, "BCS" is able to access the client serial port.

6.2

Windows Terminal Server

Installation under Windows Terminal Server is ed for Microsoft Windows 2000 and 2003 servers.

6.2.1

Installing _connect.Brain on a Windows terminal server

To install the program on a Windows terminal server, proceed as follows: When installing or changing an installation, ensure that no or system service is using any part of the installation. Access can be monitored in the computer istration under "System" / "Released folder" / "Open files". If, once applications have been properly closed and services ended, there are still files being accessed, it is possible to cancel access here. Installation via the Windows software istration Open system istration via the Windows start menu. Install program using "Neue Programme hinzufügen". Installation via the command lines window Open command lines window via the Windows start menu. Execute change / install. Start installation program using setup.exe. Execute change / execute. This procedure allows to install components that are not only for the present but for all s. This information is communicated to the system.

22

38.026.297.001 en

Operating instructions _connect.BRAIN

6.2.2

Use on terminal servers

Temporary network breakdown when using a serial interface

When using a serial interface at the client computer during a Terminal session, please note that if the network temporarily breaks down, connectServer can no longer access the serial port. This problem can only be resolved when the connection from the application program to connectServer is closed and subsequently reestablished. Close the connection as follows: Call up "Close" or stop devices via _connect2File.

6

The operating systems reports that the "device" is no longer available. In this case, "Device" stands for COM port.

6.2.3

Using VirtualES when _connectServer has been installed as service

If the VirtualES server, view, or displays an authorization error, the access rights set on the VirtualES server (BizMemServer) have to be adjusted using the dcomcnfg Windows program. Open the "Component services" windows via the Windows system istration. Open "Computer" / "Workstation" / "DCOM configuration". Call up the "Properties" of BizMemServer via the context menu. Open the "Security" tabs and, via <Edit...>, adapt the settings for the "Start and activation rights" and "Access rights". name: SYSTEM Authorizations: Permit

38.026.297.001 en

23

_connectServer

7

_connectServer

7.1

Overview

Operating instructions _connect.BRAIN

_connectServer (BCS.Exe) is the system control center for communication between programs and devices. _connectServer is installed as DCOM object which can be accessed by means of the DCOM interface.

7

DCOM (Distributed Component Object Model) is a Microsoft proprietary technology for communication among software components distributed across networked computers. It is an extension of COM (Component Object Model) which permits standardized access to software components no matter which programming language is used. To access the _connectServer, you can integrate the ActiveX control element _connectControl (BCC.OCX) in own proprietary programs. The properties, methods and events that can address _connectServer are described in a separate chapter, see page 139.

7.2

Configuration

7.2.1

Configuring _connectServer

Configure _connectServer via the _connectConfig, see page 34. The settings are stored in the following ini files: BCSconn.ini: Settings in the "Connections" tab. BCSdevice.ini: Settings in the "Devices" tab. BCSserver.ini: Settings in the "Common" tab.

24

38.026.297.001 en

Operating instructions _connect.BRAIN

7.2.2

_connectServer

Operating modes

_connectServer can be operated as application or service. By default, the program is installed as application. It is possible to change the operating mode via the command line window. You need istration rights to change the operating mode via the command line window. Application:

Service:

_connectServer is activated as soon as another program establishes connection via the DCOM or COM interface. _connectServer is deactivated as soon as the program that established the last connection closes the connection. Since _connectServer is only active when used by other programs, this operating mode facilitates changing the configuration and updating. _connectServer becomes active when starting the operating system and remains active until the operating system is shut down. Since there will not be any delays due to repeated opening and closing of the program, this operating mode offers a better performance. The automatic monitoring of services ensures that the program will be automatically re-started after a program crash. The operation as service makes changing the configuration and updating more difficult because the service has to be manually closed and re-started.

Changing the operating mode via the command line window Call up the command line window via the start menu. In the _connect.BRAIN installation directory, go to the BCT\BCS Components subdirectory. Change the operating mode. The following commands are available: BCS.exe -unregserver

Delete the set operating mode. A new operating mode can be set then.

BCS.exe -regserver

Operate program as application.

BCS.exe -service

Operate program as service.

38.026.297.001 en

25

7

_connectServer

7.2.3

Operating instructions _connect.BRAIN

Asg s

Use the dcomcnfg Windows program to allocate the with which _connectServer will be started. The possible settings depend on the set operating mode of the program. Open the "Component services" windows via the Windows system istration. Open "Computer" / "Workstation" / "DCOM configuration". Call up the "Properties" of BCS via the context menu. Open the "Identity" tab and set the under which the program will be started. Possible settings with operation as application: "The interactive .": Use the of the that is currently logged on the operating system. " starting the appli- Use the of the who starts the application. This cation.": can be a different than the one currently logged on the system if e.g. the application is started with RunAs in another context. "This .": Use a preset , no matter which application requires access.

7

Possible settings with operation as service: "This .": Use preset , however individually defined. "System (only Use of operating system. Default setting for service. for services).":

26

38.026.297.001 en

Operating instructions _connect.BRAIN

7.2.4

_connectServer

Configuring operation in the network

The following configuration modifications are required to allow remote access to the _connectServer via a network. Make the settings centrally using the domain controller or individually on every computer connected in the network. –

Create a new group (hereinafter referred to as Bizerba) and a new (hereinafter referred to as _connect.BRAIN). Allocate the new to the groups , Main and Bizerba. When creating a , please observe the following: – The is not authorized to change the . – The must not expire. – The must be active. As an example, the following description uses the Bizerba group and the _connect.BRAIN . If other names are assigned, the following descriptions apply accordingly to the group and the saved with the selected name.

– –

Allocate existing and new s that shall have access to _connectServer to the Bizerba group. Adapt the DCOM configuration to the workstation and _connectServer as described below.

Adapt DCOM configuration to workstation: Open the "Component services" windows via the Windows system istration. Open "Computer".

38.026.297.001 en

27

7

_connectServer

Operating instructions _connect.BRAIN

Open the "Properties" via the context menu of the workstation and make the following settings: Settings in the "Standard properties" tab

7

"Activate DCOM (Distributed COM) on this computer"

Activate.

"Standard authentication level"

Set "Connect".

"Standard identity change level"

Set "Identify".

Settings in the "COM security" tab "Access rights"

Via <Edit limits>, add the Bizerba group with all activated rights.

"Start and activation rights"

Via <Edit limits>, add the Bizerba group with all activated rights.

Adapt DCOM configuration to _connectServer (BCS): In the "Component services" window, open "Computer" / "Workstation" / "DCOM configuration". Via the BCS context menu, call up "Properties" and make the following settings: Settings in the "General" tab "Authentication level"

Set "Standard".

Settings in the "Security" tab "Start and activation rights"

Select "Adapt" and, via <Edit>, add the Bizerba group with all activated rights.

"Access rights"

Select "Adapt" and, via <Edit>, add the Bizerba group with all activated rights.

"Configuration rights"

Select "Adapt" and, via <Edit>, add the Bizerba group with all activated rights.

Settings in the "Identity" tab Select "This ." and enter the _connect.BRAIN with the corresponding .

28

38.026.297.001 en

Operating instructions _connect.BRAIN

8

_connectConfig

8.1

Overview

_connectConfig

_connectConfig is used to configure the following applications: – _connectServer - Bizerba communication server (BCS) – _connect2File - File based communication interface – BHI - Bizerba host interface

8.2

Starting the program Call up _connectConfig via the start menu. Answer the question "Load Data from _connectServer ?" with to the current configuration from the _connectServer (BCS).

or Answer the question with <no> to create a new configuration. If necessary, confirm the message that the new configuration has been successfully imported. The start window of the program appears.

38.026.297.001 en

29

8

_connectConfig

8.3

Operating instructions _connect.BRAIN

Program structure

8

Illustration 9: interface _connectConfig 1 Navigation area 2

Tabs in the navigation area

3

Buttons for configuration selection

4

Menu bar

5

Tool bar

6

Work area

7

Overview area

The interface contains the following areas, in addition to typical Windows elements: Navigation area: Work area: Overview area:

30

Select content for editing. The navigation area varies according to the selected configuration and is split up in tabs. Configure devices and connections. Display settings of similar devices or connections in a tabular structure. Whilst editing a serial interface for example, the overview area shows a table with the settings of all created serial interfaces.

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Select one of the three possible configurations via the toolbar buttons: Configuration _connectServer - Bizerba communication server <2File> Configuration _connect2File - File based communication interface Configuration BHI - Bizerba host interface

8.4

Menu bar and toolbar functions

8

Functions for creating new item as well as rename, delete, copy, and paste functions are available via the corresponding context menu.

Functions in the "File" menu "New"

Create new configuration.

"Open"

Open existing configuration.

"Save"

Save open configuration under current name.

"Save as..."

Save open configuration under a freely selected name.

"_connect.BRAIN Import/Export" / "data from _connectServer"

Establish server connection and load current server configuration in the _connectConfig work area.

"_connect.BRAIN Import/Export" / "data to _connectServer"

Establish server connection and send the configuration that is currently being edited in _connectConfig to the server.

"Last file" or for example "1: C:\Bizerba\... \Beispiel.BCS"

Open one of the last saved configurations. To this end, the menu contains up to four items with progressive number, part of the path and the file name. If there is not any configuration available, it contains only the grayed out "Last file" menu item.

"Exit"

Close _connectConfig.

38.026.297.001 en

31

_connectConfig

Operating instructions _connect.BRAIN

Functions in the "Edit" menu "New Ins"

Add new device or new connection. The function is available when a structural level is marked in the navigation area, e.g. "Serial".

"Rename F2"

Rename device or connection.

"Delete Del"

Rename device or connection. The function is available when a device or connection is marked in the navigation area. Before deletion, a query appears.

"Copy CTRL+C"

Copy device or connection to clipboard. The function is available when a device or connection is marked in the navigation area.

"Paste CTRL+V"

Paste device or connection from clipboard into work area. The function is available as soon as a device or connection has been copied to the clipboard.

8

Functions in the "View" menu "Toolbar"

Show or hide toolbar.

"Status bar"

Show or hide status bar.

"Overview"

Show or hide overview below the work area.

"Tabpages" / "_connect2FileFiles"

Show or hide "Files" tab in the _connect2File configuration, see page 52.

32

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Functions in the "Extras" menu "Language"

Set language. The language information is saved as text files in the ..\Programme\Bizerba\BCT\BCS Configuration\language directory. The "Language" drop down list contains the names of these text files as options.

"Wizard"

Call up assistant for creating devices, see page 60.

"Import devices"

Create links to devices of other _connect.BRAIN clients, see page 61.

"Conversion tables" / "Import from file"

Import conversion tables from a file, see page 44.

"Conversion tables" / "Export into file"

Export conversion tables to a file, see page 44.

8

Functions in the "?" menu "Info about _connectConfig"

Show program information, see page 13.

Functions that are only available via the toolbar Back to the previous tab. Go to the next tab. Configure _connectServer (BCS), see page 34. Configure _connectServer (BCS), see page 50. Configure BHI , see page 57. Test connection, see page 37. Display of modifications to the configuration. Symbol is grey: Configuration not modified since last saving. Symbol is blue: Configuration modified since last saving.

38.026.297.001 en

33

_connectConfig

8.5

Operating instructions _connect.BRAIN

Functions in the work area

The following buttons are available in the work area at different program positions. Example: Configure the interface that is assigned to a modem.

8

<...>

Open "File-Selection" window.



After configuring the assigned object, return to the original work area. Example: After configuring an interface, return to the modem configuration the interface is assigned to.



Restore default settings in all fields of the current work area.



Show extended settings of an object.

8.6

_connectServer Configuration

Use the buttons to configure the _connectServer program.

34

38.026.297.001 en

Operating instructions _connect.BRAIN

8.6.1

_connectConfig

"Common" tab

Application Make individual settings for _connectServer here. Settings "PC-Address:"

PC address of PC that communicates with devices, functioning as _connectServer. Value range: 1-127

"Error log level:" / "Size"

Kind of errors to be logged (left) and maximum size of log file (right). Value range for dropdown list (left): "": All error messages are displayed. "Normal": Error message of the "Normal" level are displayed. "Debug": Error message of the "Debug" level are displayed. "Warning": Error message of the "Warning" level are displayed. Value range for input field (right): 1-10,000,000 bytes

"Delete Protocolfile" Number of days after that commlog files will be deleted. With activated registration, commlog files save the data transfer between _connectServer and the device. Value range: 1-90 days "_connect.BRAINlanguage:"

Language in that _connectServer logs and outputs error messages. The dropdown list may contain customer-specific languages in addition to standard languages.

38.026.297.001 en

35

8

_connectConfig

Operating instructions _connect.BRAIN

_connect2SAP Make the settings for the SAP system interface here. The SAP system is accessed via three levels that can be individually configured: – – –

Frontend (BCT2SAP Frontend) Registry (BCT2SAP Registry) Spooler (BCT2SAP Spooler)

Settings

8

"Device for function-module Z_RFC_BCT"

Settable for "Frontend" and "Registry". Selection of a device created on _connectServer for assignment in the SAP system. If "No device" is set, the device is unknown in the SAP system.

"SAP Destination"

Settable for "Registry" and "Spooler". Name of functional component in the SAP system (program ID in the RFC destination (SM59)).

"SAP Host"

Settable for "Registry" and "Spooler". IP address of the SAP host.

"SAP Gateway"

Settable for "Registry" and "Spooler". Gateway of the SAPsystem.

"SAP Reconnect Time"

Settable for "Server" and "Spooler". Time interval in seconds between two attempts to establish a connection to the SAP system.

"delete SAP Trace"

Settable for "Server" and "Spooler". Delete or do not delete SAP trace. Specify in the SAP system whether trace files have to be created or not.

36

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

_connectScannerWI With _connectScannerWI, a scanner can be used in the keyboard wedge so that data is transferred to the active program via keystrokes (e.g.Notepad) , see page 118. Make the settings for these scanning operations here. Settings "Scanner"

Select scanner.

"End of Line"

Select control character for marking the line end.

"EraseChar"

Select the control character that is to be deleted from the data flow.

"Replace text %2u"

Each text contained in the left column is substituted by the control character selected in the same line of the right column.

Testing connections This function is used to check connection to single devices or all connected devices. Prior to checking, the current configuration has to be send to the _connectServer. Start the connection test via the menu or using the following icons of the toolbar: Test connection.

In the navigation area of the "Common" tab, call "Connection test". or Click the corresponding icon of the toolbar. Answer the "Save changed document to _connectServer-Server ?" question with . Enter . Confirm the message stating that export was successful. In the editing area, select the device whose connection is to be tested. or Activate the "All devices" control field. The connection test result is shown in the "Common" table next to the relevant device.

38.026.297.001 en

37

8

_connectConfig

8.6.2

Operating instructions _connect.BRAIN

"Connections" tab

The "Connections" tab is used to define and configure connections, dialogs, conversion tables, modem connections, and local IP addresses for device connection.

Configuring serial connections Settings "Assignation"

Assignment to a device family. The device-specific default settings and restrictions of this device family are taken in consideration.

"Port"

Assignment of a physically existing serial interface. The name of the serial connection that was created in _connectConfig can be freely selected and does not need to match the name of the physical interface.

"Baudrate"

Speed of the interface.

"Databits"

Number of data bits. Value range: 4; 5; 6; 7; 8

"Parity"

Parity. Value range: no parity – – odd – odd – Mark, i.e. always 1 Space, i.e. always 0 –

"Stopbits"

Number of stop bits. Value range: 1; 1,5; 2

"Protocol"

Selection of a protocol for controlled data transfer. Value range: – "no handshake" (no protocol) – "Xon/Xoff" (software protocol) – "RTS/CTS" (hardware protocol) – "Xon/Xoff + RTS/CTS" (mixed protocol)

8

38

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Configuring profibus connections Settings "Assignation"

Assignment to a device family so that device-specific default settings and restrictions are taken in consideration. Use the GX device family also for CX devices, see page 134.

"Card"

Assignment of a Profibus card.

"Channel"

Assignment to a Profibus channel. Value range: 1: Price labeler 1, 2: Industrial devices

"Baudrate"

Speed of the interface.

38.026.297.001 en

8

39

_connectConfig

Operating instructions _connect.BRAIN

Configuring T/IP connection Settings "Assignation"

Assignment to a device family so that device-specific default settings and restrictions are taken in consideration.

"Type"

Transmission type. T_SERVER_CLIENT=client/server

"Device-IP"

IP address of the device used.

"Hostname"

Specification of the host name instead of the IP address. If the host name is known to the DNS (Domain Name Server), the corresponding IP address can be displayed in the "Device-IP" field by means of the button.

"Port"

Local T/IP port for communication with the device. Use port number 1024 or higher because the area 0..1023 is reserved for standard programs.

"Local IP address"

IP address that is locally to be used for communication with the device. If the entered IP address is selected whilst establishing a TCO/IP connection, communication with the device is performed via this IP address. If nothing is defined, the first found IP address is used. Indication of the local IP address is necessary for error-free communication between the device and the PC when the PC has several IP addresses. When using the "Local IP address" setting, make sure that a local IP address has been configured for all devices with Ethernet configuration. Otherwise Ethernet communication problems may occur. The configuration can be checked in the overview area, see page 30.

"use DH"

activated:

8

not activated:

Use DH (Dynamic Host Configuration Protocol) for automatic determination of the device IP address. This setting can also be used without DH. In this case the device name must be stored in the network, e.g. in DNS (Domain Name System). Otherwise the device IP address cannot be determined. No automatic determination of the IP address.

"Check of valid con- Function for service technician, cannot be set via the _connectConnection to device fig program. (ping)"

40

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Interface dialogs Standard interface dialogs can be viewed but not configured with the exception of modem-specific settings in case of retail scales. Configuration of newly created interface dialogs and of copies of the standard interface dialog can be customized. Settings for GX and IX device families "Assignation"

Assigned device family.

"Connection-type"

Connection type. Value range: – "Serial" – "Profibus" – "T/IP"

"Dialog-type"

Type of communication with the device. Value range: "no dialog": Data transfer and receipt without frame protocol. "S-dialog": Data transfer with positive (ACK) or negative (NAK) confirmation of receipt. "N-dialog": Enquiry (ENQ) prior to transmission whether data can be sent (ACK) or not (NAK). In case of permission, data transfer with confirmation of receipt (ACK or NAK).

"Blockcheck"

Block check type. Value range: "no check": "with LRC":

8

No block test. Longitudinal redundancy check (LRC).

"Enquirychar"

ASCII code for sending enquiry in N dialog.

"Pos/Neg acknowledge"

ASCII codes for positive (ACK) or negative (NAK) confirmation of receipt.

"Start characters 1/ 2"

ASCII codes for marking a block start.

"End characters 1/ 2"

ASCII codes for marking a block end.

"Delimiter"

ASCII code for a delimiter.

"IgnoreChar"

With IX devices only. ASCII code for identification of characters to be ignored.

38.026.297.001 en

41

_connectConfig

Operating instructions _connect.BRAIN

Settings for GX and IX device families "Retry"

Number of repetitions in the event of connection errors.

"Timeout in ms:"

Maximum waiting time when establishing connection. Value range: 1000…10.000 ms

LW device family settings "Assignation"

Display of the assigned device family.

"Dialog-type"

Dialog type. Value range: "SCHDLC": "SCT":

8

HDLC conform dialog. T/IP conform dialog.

"Init-command"

Command character for initialization.

"Init-name"

Identifier.

"Retry"

Number of repetitions in the event of connection errors.

"Modem-Type"

With serial connection only (dialog type "SCHDLC"). Modem type. Value range: 0…99

"Phone-No."

With serial connection only (dialog type "SCHDLC"). Telephone number for modem connection.

""

With serial connection only (dialog type "SCHDLC"). for protection of setting.

"Blockcheck"

With serial connection only (dialog type "SCHDLC"). Block check type. Value range: "no check": No block test. "LRC": Longitudinal redundancy check (LRC). "16-Bit CRC": Cyclic redundancy check (CRC).

42

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Creating and editing conversion tables Character replacements for conversion operations are defined in character conversion tables. Characters that are not listed in the conversion table are transferred unchanged. Conversion tables for the most important standard conversions are part of the program. Each character conversion table consists of two parts: <_connectServer >> De- Conversion from PC to device vice>: > _connectConversion from device to PC Server>: Creating a new character conversion table In the navigation area, press "conversion tables". In the <Edit> menu, call up the menu item. or In the context menu, call up the "New Conversion table". A new conversion table is displayed in the navigation and work area.

8

Creating character conversion table Select the device familiy for which the conversion table shall be valid in the dropdown list. Enter the required character replacements for both conversion directions. Entering character replacements Add a line to the table using . Select the character to be replaced in the dropdown list on the left below the edited table part. Select the replacement character in the dropdown list on the right below the edited table part. Deleting lines from a conversion table Select the line and press .

38.026.297.001 en

43

_connectConfig

Operating instructions _connect.BRAIN

Exporting and importing conversion tables Conversion tables can be exported and imported. The conversion tables are saved as .CNV files in the system and imported from there. These files can contain several conversion tables. This feature makes it possible to maintain different conversion settings under the same table name for international applications.

8

Exporting conversion tables "Extras" / "Conversion tables" / "Export into file" Select the conversion table to be exported and click . Select a path in the "File-Selection" window and enter a file name. Several exported conversion tables are saved in the same file. When reimporting this file, you'll obtain single conversion tables again. Importing conversion tables "Extras" / "Conversion tables" / "Import from file" Select the file to be imported in the "File-Selection" window. Import using . The conversion table appears in the _connectServer configuration on the "Connections" tab. It can be edited and assigned to devices. Update the display to be able to see the imported conversion table. To do so, change the tab and return to previous one.

44

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Creating and editing modems, modem pools and modem connections Assign a modem connection to each device connected by means of a modem. The modem connection itself refers to a modem pool. When establishing connection to a device, _connectServer uses the next free modem of the assigned modem pool. Each modem pool consists of at least one modem. Each modem is assigned to a modem pool. To be able to establish a modem connection, you have to create at least one modem pool with at least one modem first. Modem settings "Serial-Com-Delay" Delay time in ms for transmission. "Hook-Off-Delay"

Delay time in ms until acceptance of a connection.

"Silent-Delay"

Delay time in ms when closing the modem connection to set the modem to the command mode.

"Pre-Dial-String"

Prefix for dialing

"Pre-Dial-String2"

Further prefix for dialing if the first prefix is a separate command which must be followed by another command.

"Dial-Timeout"

Postfix for dialing.

"Post-Hook-String"

Command after accepting a connection.

"Interface"

Serial interface.

8

Modem connection settings "Log messages"

Allow or refuse event logging.

"Dialstring"

Command for selecting a phone number.

"Dial-Timeout"

Maximum waiting time until successful establishment of connection in ms.

"Response-Timeout"

Maximum waiting time until successful initialization of connection with remote station in ms.

"Pre-Dial-String"

Prefix for dialing

"Pre-Dial-String2"

Further prefix for dialing if the first prefix is a separate command which must be followed by another command.

"Post-Dial-String"

Postfix for dialing.

"Post-Hook-String"

Command after accepting a connection.

"Modem-Pool"

Modem pool used.

38.026.297.001 en

45

_connectConfig

Operating instructions _connect.BRAIN

Creating modem in new modem pool In the navigation area, press "Modem-Pools". In the "Edit" menu, call up the "New" menu item. or In the context menu, call up the "New Modempool". A new modem pool with a new modem is created.

8

Creating modem in existing modem pool Select the modem pool in the navigation area. In the "Edit" menu, call up the "New" menu item. or In the context menu, call up the "New Modem". A new modem is created. Creating a modem connection In the navigation area, press "Modem-connections". In the "Edit" menu, call up the "New" menu item. or In the context menu, call up the "New Modem-connection". A new modem connection is created. The newly created items in the navigation area can be renamed, deleted and copied using the corresponding menu functions, see page 31.

Creating and editing local IP addresses Settings "Local IP address"

8.6.3

IP address that is locally to be used for communication with the device. If the entered IP address is selected whilst establishing a TCO/IP connection, communication with the device is performed via this IP address. If nothing is defined, the first found IP address is used. Indication of the local IP address is necessary for error-free communication between the device and the PC when the PC has several IP addresses.

"Devices" tab

Assign existing connections during device configuration. Depending on the device type or family, the following settings can be made.

46

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

The CX (CWM, CWE, CWP) device family is based on the GX family. The CX device settings correspond to those of the GX devices and are not managed separately by the program. Thus, the CX device are found in _connectBRAIN under the GX device family. Settings "Devicetype"

Specification of the device type so that device-specific default settings and restrictions are taken in consideration.

"Connection-type"

Kind of physical connection between PC and device. Value range according to device family: GX: "Serial", "Profibus", "T/IP", "Modem" IX (except for NT scale): "Serial", "Profibus", "T/IP" IX (NT scale): "DCOM" LX (except for CE): "Serial", "T/IP" LX (CE): "RAS", "Ethernet" SX: "DCOM" FX (except for ADDI-Da- "Serial", "T/IP" ta I/O card): FX (ADDI-Data I/O card): "DCOM"

"Interface"

GX, IX, LW, FX: Select configurated connection via dropdown list. The list is available after entering the connection type. Via the button on the right next to list field, the selected connection can be configured, see page 38.

"Dialog"

GX, IX, LW, FX: Select device dialog. The device dialog is the protocol between PC and device. The dialogs shown in the dropdown list depend on connection and device type. Via the button on the right next to list field, the selected dialog can be configured, see page 38.

38.026.297.001 en

47

8

_connectConfig

Operating instructions _connect.BRAIN

Settings

8

"Token-Conversion" GX, IX: Activate or deactivate conversion via the control field. When conversion is activated, select a conversion table in the dropdown list. The displayed conversion tables depend on the device type. Via the button on the right next to list field, the selected conversion table can be configured, see page 38. The second button on the right next to the list field opens the "Advanced properties for Token-conversion" dialog. Activate automatic conversion, when sequences that start with a backslash have to be converted automatically. Automatic conversion has the following effects, amongst others: "\n": This sequence stands for a line break and is converted to the GxNet compatible form "@0A" (ASCII character 10 or 0x0A). "\\": This sequence stands for the backslash character. Automatic conversion to "\" is performed only in the case of data transfer from the PC to the device and not vice versa. "Systembusaddress"

GX, IX (außer NT Scale), LW: Select device system bus address.

"Logging/size"

For all device types. List field on the left: Logging type. LW: Deactivate logging or set a logging mode. The higher the consecutive number of the logging mode, the more information is logged. The size specification in bytes defines from which file size a new log file is created and the old file is renamed. Others: Activate or deactivate logging. Input field on the right: Maximum size of a logging file in byte. If this size is exceeded, a new log file is generated and the old file is renamed.

"Load Receivers"

IX (except for NT scale): Open "Advanced settings for Load Receivers" window. Add up to 99 load receptors with number and individual name. Edit or delete table entries.

"Software-Vol."

GX: Firmware version of the device. If the program version was incorrectly indicated, problems may occur during controlling or querying of licenses which prevent correct functioning of the program.

48

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Settings "Header-Format"

GX, FX: Select GxNet transfer format. The following formats are available for Gx and Fx devices: – "Gx/Ix-Net(A!, I!, A?, I?)": new format, standard for all devices – "Gx-Net (!,?)": old format for backwards compatibility with the GxTools program

"_connect2SAP"

For all device types: Open "Advanced Settings for _connect2SAP" window. Value range: Access: Enable multiple or only single access to the device via other programs. Spontaneous telegrams: Log or do not log spontaneous telegrams of the device. Logging: Activate or deactivate logging of SAP interface access. Repetition attempts: Define number of repetitions in the event of connection errors, before attempts are terminated with an error message. HUPast: Select gross or netto weight type for display, see page 97.

"Connection"

GX, IX, SX, FX: Set via "Hold Connection" whether the device connection is to be permanently maintained or only established if required. If connected to SAP: Activate "Hold Connection". On terminal servers with _connectServer as server: deactivate "Hold Connection".

"Virtual ES"

IX, SX: Enable access to VirtualES. Via , the VirtualES - program can be started. The _connectConfig program has previously transmitted the current settings to _connectServer.

"Registry-DB"

IX: Enable or block access to the registry database for ST devices. If required, define readout cycle in seconds. _connectServer reads the data from the database and forwards them as spontaneous data to the superordinate program.

"Status"

For all device types: Activate check-box to enable the use of the device.

38.026.297.001 en

49

8

_connectConfig

8.7

Operating instructions _connect.BRAIN

_connect2File Configuration

Use the <2File> button to configure the _connect2File program for file-based device communication. Program functions and operation are documented in a separate chapter of this manual, see page 65.

8.7.1

Naming log files

Select the log file names so that they provide information on the content type and the relevant device. Example:

8

record01.txt The first part of the file name stands for the content type, for example – record for normal data – error for errors The second part of the file name stands for the device address (01, 02, ...) or the device name.

50

38.026.297.001 en

Operating instructions _connect.BRAIN

8.7.2

_connectConfig

"Common" tab

Make the default settings for the _connect2File program here. Settings "Error log level:"

"Show errors as dialog"

Define the log depth for the log file. Value range: "": Log all error messages. "Normal": Log the error messages of the "Normal" level. "Debug": Log the error messages of the "Debug" level. "Warning": Log the error messages of the "Warning" level. activated: not activated:

The logged error messages are also interactively displayed. The error messages appear only in the log file.

"GX-SendChannel"

Transmission channel for transmitting device information when the device is stopped. If the transmission channel is missing, the device cannot send any data after being stopped and reports an error. _connect2File activates the set transmission channel when establishing the connection to the GX device, so that the GX device can transmit data records to the _connect2File PC. When closing the connection with the GX device, the transmission channel is deactivated to avoid that the GX device reports a transmission error while _connect2File is not active. The same transmission channel for sending information has to be defined in the device.

"Files"

Specify a process for transferring received data in a regular file. Data received from the device are initially saved in a temporary file. Only after releasing the data, the temporary file is converted to a regular file. The following processes are available for this: "Rename with Move The temporary file is relocated and re(Win-NT/2000)": named. "Rename with Copy/De- Process for older systems. The temporalete (Win-9x, ME)": ry file is copied and then deleted.

"Do not move emp- activated: ty files" not activated:

38.026.297.001 en

Empty reception data files are directly deleted. Empty reception data files are converted in regular files.

51

8

_connectConfig

8.7.3

Operating instructions _connect.BRAIN

"Files" tab This tab is only displayed when the "_connect2File-Files" menu item is activated in the "View" menu under "Tabpages".

8

_connect2File manages the log data of the connected devices. External access to the primary log data is disabled. For access by means of an external software, _connect2File manages output files (also called "backup" in the program). The "Files" tab is used to configure the creation and management of the output files. In the navigation area, you may create and configure separate log files that refer to a conventional _connect2File system or to the _connect2File systems on terminal server clients. Settings "Log-Path"

Path for storing log files. Enter absolute path directly or select folder via <..>.

"Filetype"

File name extension of log files.

"Backup-Path"

Path for storing output files (output directory). Enter absolute path directly or select folder via <..>.

"Filetype"

File name extension of output files.

Use the button to open a window with additional settings for copying and data backup ("Copy options" tab) and for accessing the output file ("Office-Applications" tab). Settings in the "Advanced properties for log-files" window, "Copy options" tab "Max-Entry"

Number of entries after that the log data will be moved to the output file.

"Max-Time"

Time interval after that log data will be moved to the output file.

"Copy at"

Time at that log data will be moved to the output file. If an output file with an identical name already exists in the output directory and cannot be overwritten due to configuration (see settings in the "Backup-File" area), or if _connect2File is not active at the set time, no action will take place. Not before the set time is reached again, a new attempt is made to move the log data.

"Retry"

activated: not activated:

"Retry-Delay"

Time interval between two copying attempts in ms.

"Header-Line"

activated: not activated:

52

Repeat copying cyclically after errors. Do not repeat copying after errors.

Move log data to the output file after each header change. Move log data to output file independently from header change.

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Settings in the "Advanced properties for log-files" window, "Copy options" tab "Log-File" area "Update from the System"

Select process for updating the log file. Value range: "Update after every "Update from the SysThe log data are buffered in the system. entry" tem": The collected data are converted to the log file later. In comparison to updating at each new entry, the system is less loaded and the log file is less updated. "Update after every enThe log file is updated after each write try": access (flush). Thus, it is always updated. However, this process may reduce total system speed. "Backup-File" area "no overwriting of file" "overwriting of file"

Enable or disable overwriting of existing output files. If overwriting of output files is enabled, not collected output files can be overwritten with more recent data. The previous state of the output file cannot be called up any longer.

Settings in the "Advanced properties for log-files" window, "Office-Applications" tab "Application"

Program that is used to access the output file. Value range: – "none" – "Excel" – "Word" "Access" –

"File"

File that is used to access the output file (excel, word or access file with macro). Enter file name directly or select file via <..>.

"Macro"

Name of the macro that is used to access the output file.

38.026.297.001 en

53

8

_connectConfig

8.7.4

Operating instructions _connect.BRAIN

"Devices" tab

Device specific settings are split up into two areas: Conventional area:

Terminal server area:

The conventional area contains a standard _connect2File system. The here created devices are visible for all clients and can be used on all clients. The terminal server area contains _connect2File systems for terminal server clients. The here created devices are only visible on the respective client and can only be used by this client.

Asg devices or changing assignments

8

In the navigation area, select the "_connect2File-System" main entry or a client that has been created under the "_connect2File system terminal server" main entry. Assign devices Select one or more devices in the "Available Elements" area. Assign devices with < >> >. Remove assignment Select one or more devices in the "Selected Elements" area. Remove assignment of devices with < << >. Save changes

54

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Configuring device - Input files tab Configure the communication between PC and device here. The communication is done via one of the following programs: – _connect2File (standard) – BLD (first -defined program) – WinCWS (second -defined program) Settings Settings of selected program _connect2File, BLD or WinCWS "Input"

Path and name of the file that contains the data to be sent to the device.

"Error"

Path and name of the file that records defective data records, e.g. transmission and syntax errors, or header not detected, see page 73. The defective data records are not sent to the device.

"Dummy-files"

Reserved for future application.

Generally valid settings "Read-Interval"

Time interval between two read accesses to the input file in s.

"Wait-Time"

Waiting time between two data records to be transmitted to the device in ms.

"Error-File"

activated:

"Devicestop"

activated:

Create error file only in the event of error. not activated: Always create error file. Even empty error files can be used to determine when-on the basis of the moment of their creation-processing of an input file started.

not activated:

38.026.297.001 en

In the event of a device stop, the input file that is being processed will be deleted. In the event of a device stop, the input file that is being processed will be kept.

55

8

_connectConfig

Operating instructions _connect.BRAIN

Configuring device - Ausgabedateien tab Select the data that the device will send to the PC. The setting is made column per column for the log files created on the "Files" tab, see page 52. Distinguish between output and event file settings by selecting the relevant tab. Set for the output file which device data will be transmitted to the PC. Make the settings for the device data that activates the log file relocation in the output directory, in the relevant event file. Use the following buttons for further processing: :

8

Log file configuration, see page 52 Transmit assignment of output data from one log file to another one. Assignments can only be transmitted to log files without proper assignment. During transmission, assignments are deleted from the original file.

Replacing the assignment This function is only available when at least one log file with assignments and one log file without assignments have been created. Click the button in the "Outputfiles" tab. In the "Current assignation" column of the "Replacement of files" window, select the log file from which assignments have to be transmitted. In the "File-Selection" window, select the log file in which assignments have to be transmitted. The selected file appears in the "Replacement of files" window under "New assignation". If required, remove the assigned log file from the view using . The assignments are removed from the original log file and transmitted to the selected log file.

56

38.026.297.001 en

Operating instructions _connect.BRAIN

_connectConfig

Configuring device - Anwendungsparameter tab Make here general settings for handling devices. Settings "Start-Options"

activated: not activated:

"Telegramms"

activated: not activated:

"Memocard"

activated: not activated:

"Autostop"

activated:

not activated:

8.8

After starting _connect2File, establish automatically a connection to the device. The connection to the device has to be started manually. Receive also events initiated by the device (spontaneous telegrams). Receive only data explicitly requested from the device. Read the storage medium in the device cyclically. Enter the reading interval in the input field in s. Do not read the storage medium in the device. Stop device when receiving a total telegram of the relevant total. Then the device has to be enabled by the superordinate program. Do not stop device when receiving a total telegram of the relevant total.

BHI Configuration

Via the interface, the Bizerba host interface BHI is configured. BHI is a host interface for Windows PCs for connecting the following devices: – – – – –

SC retail scales SW retail scales BS retail scales CE retail scales GX price labelers

Host definition and program sequences are created by the program BHE (Bizerba Host Editor) that is not documented here. The host data can be processed in ASCII, CSV or XML file format. BHE contains data converters and data transmission programs (BCS-light and SXCom).

38.026.297.001 en

57

8

_connectConfig

Operating instructions _connect.BRAIN

BHI is only required in connection with the WinCWS program and has to be configured only when this program is used.

Settings "System-Type/No."

The system type defines the device types that can be contained in a BHI system. Value range: SC/SW/BS, CE, GX The system number is the number of a subsystem. A subsystem is a logic unit comprising a single device or a group of retail scales or price markers, which are supplied with data or from which data are called up separately during communication. Value range: 1-999

"Master devices"

The master device is a device in a subsystem, via which communication takes place with BHI. If more master devices are created, these will be used as master devices for communication in the event of failure of the first master device. Value range: All devices of the selected system type that are created in _connect.BRAIN.

"Slave devices"

Other devices of the subsystem for which device-specific data shall be transmitted. If no device-specific data are to be transmitted, the list of slave devices remains empty. Value range: All devices of the selected system type that are created in _connect.BRAIN.

"Departments"

Department-related data (e.g. PLU data) can be filtered by department Only department-related data whose department number is specified in the department list are transmitted. If the department list is empty, all data records present in the host file are transmitted to the subsystem. Value range: 0-999

8

58

38.026.297.001 en

Operating instructions _connect.BRAIN

8.8.1

_connectConfig

Adding and deleting master/slave devices and department

The procedure is for master/slave devices and departments is largely identical and corresponds to the following description, by way of example. For editing slave devices or departments, select the respective tab. Adding master device Select the BHI system to be edited in the navigation area. Select the "Master devices" tab in the work area. Use the button or the enter key to open the "Master devices" window. Select the device that shall be defined as master device in the "Available Elements" area. Only devices that have been created in the system and correspond to the defined system type are displayed. < >> > Adding other master devices If required, transfer other devices in the "Selected Elements" area in the same way. Alternatively, these devices may be used as master device. Removing master devices from list Select the device to be deleted in the "Selected Elements" area and < << > Terminating editing

38.026.297.001 en

59

8

_connectConfig

Operating instructions _connect.BRAIN

8.9

Wizard for creating devices

8.9.1

Creating new devices using a wizard

New devices can be generated using a wizard. The wizard guides the through the device-specific settings to the _connectServer and to the _connect2File if required.

8

"Extras" / "Wizard" > Select "Create a new device" and click >. Entering the _connectServer settings On the following pages, enter the _connectServer settings, see page 46. Close each page using >. Decide whether and how the device is assigned to _connect2File. Answer the question "Do you want to add device to _connect2File environment?" and click >. The following responses are possible: "yes": The device is created in the _connectServer configuration and assigned to the standard _connect2File system of the _connect2Fileconfiguration. "yes, add for existing ter- The device is created in the _connectServer configuration minal server client": and assigned to the terminal server client of the _connect2Fileconfiguration that has been selected in the relevant dropdown list. "yes, enter name of new The device is generated in the _connectServer configuration. A new terminal server client with the name that has terminal server client": been entered in the relevant input field is created in the _connect2File configuration. The new device is assigned to the new terminal server client. "no": The new device is created in the _connectServer, but not added to the _connect2File configuration. Other _connect2File settings are omitted when proceeding through the wizard. If necessary, enter the _connectServer settings Enter the input files, output files and application parameters for the _connect2File configuration on the following pages of the wizard , see page 54. Close each page using >. Completing device Check the summed-up settings on the last page of the wizard. Use to return to the previous page and correct settings. Exit wizard with .

60

38.026.297.001 en

Operating instructions _connect.BRAIN

8.9.2

_connectConfig

Copying devices using the wizard

Devices can be copied using the wizard. "Extras" / "Wizard" > Select "Copy an existing device". Select the device to be copied in the list field. > Enter the device name. > Make settings for connection, see page 38. > If the copied device is assigned to _connect2File, enter the input files, see page 55. > If the copied device is assigned to _connect2File, enter the output files, see page 56. > Check the summed-up settings on the last page of the wizard. Use to return to the previous page and correct settings. Exit wizard with .

8.10

Creating links to devices of other _connect.BRAIN clients

The function is used to generate links to other _connect.BRAIN devices in the current configuration. This enables a _connect.BRAIN client (_connectControl, _connect2File, additional program) to easily operate with a distributed system. "Extras" / "Import devices" Enter the name of the _connect.BRAIN client from which devices have to be imported in the "Computername" input field or select it using the <..> key. <Show Devices> Select devices for import. The devices appear in the _connectServer configuration on the "Devices" tab under the "Network environment" main entry and the computer name. They can be viewed and used, but not configured.

38.026.297.001 en

61

8

_connectDiagnostics

9

_connectDiagnostics

9.1

Overview

Operating instructions _connect.BRAIN

_connectDiagnostics provides you with an overview of the configuration and the use of the _connectBRAIN program package. It accesses the _connectServer via the DCOM interface and finds out information about: – – – –

9

9.2

Program version of _connectServer and other installed components Activated licenses for _connect.BRAIN Number of s currently connected to the server with identification and name of the interface used Created devices with category, type and status

Starting the program Call up _connectDiagnostics via the start menu. If the start window is not displayed and the program appears only as symbol in the information area of the task bar: Click the "_connectDiagnostics" symbol using the right button of the mouse and select "Wiederherstellen" in the context menu.

The start window of the program appears.

62

38.026.297.001 en

Operating instructions _connect.BRAIN

9.3

_connectDiagnostics

Program structure

9

Illustration 10: interface _connectDiagnostics 1 Navigation area 2

Menu bar

3

Display area

4

Status bar

The interface contains the following areas, in addition to typical Windows elements: Navigation area: Display area:

Status bar:

9.4

Shows the devices and s logged on _connectServer. Shows information on the element that was selected in the navigation area: – Information on server (version) and licenses – Information on device – Information on and interface Shows time of the last update.

Menu bar and toolbar functions

Functions in "File" menu "Exit"

38.026.297.001 en

Terminate _connectDiagnostics.

63

_connectDiagnostics

Operating instructions _connect.BRAIN

Functions in menu "View" "Refresh"

Update view to show modifications.

Functions in menu "Language" Select here a language for the interface. Functions in "?" menu "Info"

Show program information, see page 13.

9

64

38.026.297.001 en

Operating instructions _connect.BRAIN

10

_connect2File

10.1

Overview

_connect2File

_connect2File is a -friendly data interface for transferring BxNet data and control commands in the form of ASCII files. Configure _connect2File via the _connectConfig program, see page 50.

_connect2File functions: –

–

– –

Receive spontaneous telegrams – Package-synchronous data (weight, price, date, time, ...) – Remote data (send on change) – Softkey entries from -defined mode level or authorization level – Statistics data (totals, number, ...) Acknowledge reception data according to telegram – The data content of a telegram determines the log file(s) to which the reception data are written. The automatic acknowledgement of total data can be suppressed for totals 1, 2 and 2 and carried out later by means of a release command, see page 57. Prepare log files for data transfer in event-controlled mode Call up macros in Microsoft Word and Excel

10.2

Starting the program

Call up _connect2File via the start menu. The start window of the program appears. Recognition of the terminal server mode can be deactivated by means of the following call-up parameter: BCF.exe /NoWtsDetection This is necessary, when the Windows terminal server console is accessed via remote desktop connection and _connect2File is to be run on the console. If the parameter has not been specified, _connect2File runs within a remote desktop connection on the client PC and not on the server console.

38.026.297.001 en

65

10

_connect2File

10.3

Operating instructions _connect.BRAIN

Program structure

10 Illustration 11: interface _connect2File 1 Menu bar 2

Tool bar

3

Connection window

4

Status bar

The interface contains the following areas, in addition to typical Windows elements: Connection window:

66

Communication of each device is displayed in a connection window. The connection window shows the connection status and the data transfer. The background color varies according to the status: – Yellow: establishing connection – Cyan: waiting for switch-on message – Green: connection open (online) – Gray: closing connection – Red: connection closed (offline)

38.026.297.001 en

Operating instructions _connect.BRAIN

10.4

_connect2File

Menu bar and toolbar functions

Functions in "File" menu "Start for all devices"

Initialize access to all configured devices. Open connections and and start data exchange. Any devices that have already been started are not re-initialized.

"Stop for all devices"

Terminate data transfer for all devices. Close all connections.

"test online"

Check connection to configured devices and report result for each device.

"start"

Open connection to selected device and start data exchange.

"stop"

Terminate data transfer to selected device and close connection.

"Exit"

Close all connections and terminate _connect2File.

10

Functions in menu "View" "logtape"

Show _connect2File protocol from application start.

Functions in "Window" menu "overlapping"

Display windows in cascade format.

"arrangement vertical"

Display windows next to each other.

"arrangement horizontal"

Display windows next to each other.

"arrange symbols"

Arrange minimized connection windows at the bottom of the window.

example "1 GLP"

Consecutive number and device name of displayed windows. The active window is checkmarked. Select desired window.

38.026.297.001 en

67

_connect2File

Operating instructions _connect.BRAIN

Functions in menu "Extras" "Language"

Select interface language. The modification does not become active until the next application start.

Functions in menu "?" "info about _connect2File"

10.5

Show application information, see page 13.

Functions in the connection windows Green symbol: Start device.

10

Red symbol: Stop device.

10.6

File transfer

An application that provides data for the devices, runs on the host. The host application and the _connect2File program communicate by exchanging files in ASCII format. Data is transferred via the hard disk of the _connect2File computer according to a defined protocol. The WinCWS program is an example of a host application. This program provides the GX device family with a master data ASCII file that is transferred to the GX device by _connect2File. Sample file that transfers the text "hello GX" in the text field 1 of a GX device: Line 1: A!GT01 Line 2: hello GX

More examples can be found under C:\Programme\Bizerba\BCT\Samples\BCF Files.

68

38.026.297.001 en

Operating instructions _connect.BRAIN

10.6.1

_connect2File

Data transfer from host to _connect2File

10

Illustration 12: Data transfer from host to _connect2File 1. The host generates a file in a directory the _connect2File computer has access to. To avoid access via _connect2File during generation, the file initially gets a name unknown to _connect2File. or The host generates the file in a directory the _connect2File computer has not access to. 2. After completing transfer, the file is renamed or relocated in the _connect2File input directory so that _connect2File can access it. 3. _connect2File reads and processes the file. In the event of transfer errors, _connect2File generates an error file, see page 73. After successful processing, _connect2Filedeleted the input file. 4. Only after deleting the input file, the host can provide a new input file by means of renaming or relocating. Until then the host collects the data in another directory or saves it with another file name (cf. step 1).

38.026.297.001 en

69

_connect2File

10.6.2

Operating instructions _connect.BRAIN

Data transfer from _connect2File to host

Illustration 13: Data transfer from _connect2File to host

10

1. First _connect2File collects the device data in a temporary file. 2. Triggered by an event such as changing the header, reaching a specified number of lines or receiving certain data, _connect2File moves the file to the output directory and supplies it to the host. 3. The host checks the output directory cyclically (polling). If it finds an output file, it copies or relocates the file and deletes it from the output directory. 4. New data cannot be added to files located in the output directory. Only after deleting the old file, _connect2File can move a file with new device data to the output directory.

10.6.3

Controlling data output by events

_connect2File relocates its temporary log file in the output directory as soon as a defined event occurs. This event may be related to files or received data. File-related events are the following: a defined number of entries is reached, a defined period of time has elapsed, a set time is reached or a header changed within the file. Configure these events in _connectConfig on the "Files" tab of the _connect2File configuration, see page 52. In addition to file-related events, receipt of certain input data causes relocation in the output directory. Define this input data in _connectConfig by configuring the event file, see page 56.

70

38.026.297.001 en

Operating instructions _connect.BRAIN

10.6.4

_connect2File

File structure

Data is transferred between the host and _connect2File in form of text files that contain ASCII encoded characters in 7-bit format. The transfer files consist of headers and data. Headers always contain information on the data format, its attributes and the following data. To distinguish headers from data lines, they start with the following identifiers: ! A! I! ? A? I?

Write access, old header format Gx-Net (!,?), only possible with GX and FX devices Write access to labeler, new header format Gx/Ix-Net(A!, I!, A?, I?) Write access to industrial device, new header format Gx/IxNet(A!, I!, A?, I?) Read access, old header format Gx-Net (!,?), only possible with GX and FX devices Read access to labeler, new header format Gx/Ix-Net(A!, I!, A?, I?) Read access to industrial device, new header format Gx/IxNet(A!, I!, A?, I?)

A header is followed by one or more data records ( data). If the data format changes, a new header is added. Example: Header for data format x data in data format x data in data format x Header for data format y data in data format y data in data format y data in data format y

38.026.297.001 en

71

10

_connect2File

Operating instructions _connect.BRAIN

Example of a file in the new format Gx/Ix-Net(A!, I!, A?, I?), headers highlighted

10

A!PV04|PW02|GW09|GL19|GL1A|GL16|PD00|GL2B|GL2C CR/LF 1|2|4711|0|1|KG;-3;100|20997|1545 CR/LF 1|2|4711|0|2|KG;-3;100|20997|1545 CR/LF 1|2|4711|0|3|KG;-3;100|20997|1545 CR/LF 1|2|4711|0|4|KG;-3;100|20997|1546 CR/LF 1|2|4711|0|5|KG;-3;100|20997|1546 CR/LF A!PV01|PW02|PW00|PL00|PD03|PD14|GL17|GL19|GL1A|GD02|GL2B|GL2C CR/LF 8|1|5|KG;-3;500|0|650|2|4711|0|0|20997|1546 CR/LF A!PV04|PW02|GW09|GL19|GL1A|GL16|PD00|GL2B|GL2C CR/LF 1|2|4711|0|1|KG;-3;100|20997|1546 CR/LF 1|2|4711|0|2|KG;-3;100|20997|1546 CR/LF 1|2|4711|0|3|KG;-3;100|20997|1546 CR/LF 1|2|4711|0|4|KG;-3;100|20997|1546 CR/LF 1|2|4711|0|5|KG;-3;100|20997|1546 CR/LF A!PV01|PW02|PW00|PL00|PD03|PD14|GL17|GL19|GL1A|GD02|GL2B|GL2C CR/LF 8|1|5|KG;-3;500|0|650|2|4711|0|0|20997|1546 CR/LF 8|2|10|KG;-3;1000|0|650|2|4711|0|0|20997|1546 CR/LF 8|10|10|KG;-3;1000|0|650|2|4711|0|0|20997|1547 CR/LF

Example of a file with PSV_DATA data records from a labeler in the old format GxNet (!,?), header highlighted !PV04|PW02|GL19|GL16|PD00|PD10|LX02 7|1|1|KG|-3|1064|0|106 7|1|2|KG|-3|1036|0|104 7|1|3|KG|-3|1002|0|100 7|1|4|KG|-3|1064|0|106

The header begins with the character ! for write access from the labeler. This is a string of subfunction identifiers, which specify the following data. The pipe character | divides the identifications. The header consists of one line and is concluded with . Example of a header in the new format Gx/Ix-Net(A!, I!, A?, I?) with explanation A!PV04|PW02|GL19|GL16|PD00|PD10|LX02

72

38.026.297.001 en

Operating instructions _connect.BRAIN

Write access to a labeler. !PSV_DATA Block command for transmission of configurable and cancellation-adjusted (i.e. labeled error-free) package-synchronous labeling data to a higher-level EDP. No parameters in the data line. #PSW_PCKHDL Package handle for identification of a package in the labeling system. One parameter in the data line: 7 GGL_PLUNR Currently labeled PLU no. One parameter in the data line: 1 GGL_EINZEL_NUMERATOR Numerator for the individual label. One parameter in the data line: 1 #PSD_GEW_NETTO_EINZEL Printed net weight with weight unit, value of exponent and weight value. Three parameters in the data line: KG, -3, 1064 PSD_PRS_VKPREIS Printed selling price with country code and value. Two parameters in the data line: 0, 106 LGX_CLOSE Logical command to close a block command. No parameters in the data line.

A! PV04

PW02

GL19

GL16

PD00

PD10

LX02

10.7

_connect2File

Troubleshooting

_connect2File processes an input file provided by the host record-by-record and sends the single data records to the _connectServer. _connectServer transfers the data records to the relevant device. Errors that occur during transfer are logged in an error file, see page 55.

38.026.297.001 en

73

10

_connect2File

Operating instructions _connect.BRAIN

Transmission error ("acknowledgement timeout error") Transmission errors result from a faulty communication between _connect2File or _connectServer and the device. A transmission error occurs, for example, when the device is switched off or when it is not ready to receive for other reasons. Format: [TT:MM.JJJJ] [HH:MM:SS] [acknowledgement timeout error:][Header];[Datenzeile]

Example: 05:05.2011 16:59:16 acknowledgement timeout error: !GT02;Test

Data error ("parsing error:") Data errors are syntactical or semantic errors during transmission, e.g. a missing header.

10

Format: [TT:MM.JJJJ] [HH:MM:SS] [parsing error:] [Datenzeile]

Example: 05:05.2011 17:03:28 parsing error: abcdefg

74

38.026.297.001 en

Operating instructions _connect.BRAIN

11

_connect2DB

11.1

Overview

_connect2DB

By means of _connect2DB, device data is transmitted in a MS Access database or to a MS SQL Server. Freely definable filters allow to limit the data volume according to requirements. Device data can be exported from the database and made available for other programs.

11.2

Starting the program

Call up _connect2DB via the start menu. The start window of the program appears. When configured accordingly, the connections to the devices created on the _connectServer are established automatically.

11.3

Database setup

When using _connect2DB for the first time, the database setup wizard starts automatically. The wizard can also be started directly via C:\Programme\Bizerba\BCT \BCT2DB\DBConfig.exe.

38.026.297.001 en

75

11

_connect2DB

Operating instructions _connect.BRAIN

When setting up the database, choose between the following database types: Database type

Benefits

Microsoft Ac- – cess – –

Easy operation Easy istration Easy creation of evaluations

Disadvantages –

– – –

11

Microsoft SQL Server (recommended)

– – – – –

– Quick data access even with high volume of data – Simplest version (Express) available free of charge Access to a database from different programs possible Load distribution by installing database and programs on different computers Database more stable than with MS Access

Only suitable for small data quantities (slow from 20,000 data records, performance no longer acceptable from 50,000 data records) High storage requirements on local computer Data security not as high as with MS SQL Server Access to the data stock by more than one system problematic Higher istrative cost More complex adaptation as with MS Access; but it is possible to access data stock via MS Access.

It is recommended to use MS SQL Server from version 7.0. This version is easily scaleable. This will guarantee data security and access speed even with large data volumes. Before setting up a MS SQL Server database, the MS SQL Server has to be installed and set up. Select the database type in the first step of the wizard. > Setting up MS Access database Confirm the available storage space display. If storage space is sufficient, a MS Access database is saved as BCT2DB.dat in the C: \ProgramData\Bizerba\BCT\db directory. Setting up MS SQL Server database Select server. Enter name and for establishing the connection to the MS SQL Server. The BCT2DB database is set up on the MS SQL Server.

76

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

Completing database setup (for both database types)

11.4

Database structure

The database structure is identical for MS Access and MS SQL Server: – –

Each filter corresponds to a database table with the same name. Each filter element correspond to a column of the database table. Column name is the underlying device command. The column type is "varchar(250)" or "Text". Whether empty table columns are created or not depends on the filter configuration, see page 80. Each table contains also the following columns: – "INSERT_TIMEDATE" of type "datetime" or "Date/time". This column contains the moment of time when the relevant line has been written in the database. – "DEVICE" of type "varchar(250)" or "Text". This column contains the device name as configured in _connectConfig where the data package or device commands originates from. Each line contains a data packet from a device.

–

–

11.5

Program structure

Illustration 14: interface _connect2DB 1 Menu bar 2

Tool bar

3

Display area

4

Error area

5

Status bar

38.026.297.001 en

77

11

_connect2DB

Operating instructions _connect.BRAIN

The interface contains the following areas, in addition to typical Windows elements: Display area: Error area: Status bar:

11.6

Shows status information of devices and filters. Can be switched on or off. Lists rejected data records. Shows whether MS Access or MS SQL Server is used.

Menu bar and toolbar functions

Functions in "File" menu "Export..."

Export data, see page 85.

"Exit"

Terminate all data transfer, close connections and terminate _connect2DB.

Functions in "Data filter" menu

11

"Add..."

Set new filters, see page 80.

"istrate"

Change existing filter, see page 82.

Functions in "Extras" menu "Options..."

Make _connect2DB settings, see page 88.

"Clear contents of database..."

Delete database contents of defined period, see page 90.

"Language"

Change interface language.

Functions in menu "?" "Info..."

Show application information, see page 13.

Functions that are only available in the toolbar "Start devices" Start data transfer for all devices and filters. "Stop devices" Stop data transfer for all devices and filters.

78

38.026.297.001 en

Operating instructions _connect.BRAIN

11.7

_connect2DB

Defining filters

Filters are used to collect selected data from the data flow of a connected device. A wizard is available for creating filters.

11

38.026.297.001 en

79

_connect2DB

11.7.1

Operating instructions _connect.BRAIN

Creating filter using the wizard

The device used for determining data records has to be connected and ready for use. The device must be enabled for manual release of data records. With GX and CX devices provided with storage medium, it is also possible to read data records from the storage medium. "Data filter" / "Add..." Select a device for determining the data records to be filtered in the "Name" dropdown list. Only with GX/CX devices: In the dropdown list "Channel Control", select the "keine Kanalsteuerung" setting or a channel for data transfer. The settings must correspond to the relevant settings of the device. In the dropdown list "IxNet Converting (@41 --> A)", select whether and how data has to be converted. The following settings are possible: – "No BxNet conversion" – "Ansi conversion (@41 -->A)" "UTF8 conversion (@E2@82@AC --> €)" –

11

> Enter a comprehensive name for the new filter. The filter name is also used for the relevant database table. Permitted characters: upper case, lower case, numbers and spaces. Spaces are not permitted at the beginning or at the end of the name. No differentiation is made between upper/lower case in filter names.

> For registration, activate data transfer of the device, e.g. transmission of total information. or Only with GX/CX devices with storage medium: Click <Memocard>, when data records of a storage medium shall be read instead of spontaneous telegrams. If several telegrams are received or several data records of a storage medium are read, these are displayed in a selection window. Select telegram or data record and confirm it with . The commands set under "Options..." (default data, see page 88) and the commands that have been received during registration are available for saving in the database table. Deactivate check-box for data that is not to be saved in the database table.

80

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

If only data records that contain the selected data in the specified order are to be written in the database table, activate the "Only evaluate data in the telegram, which correspond to the indicated sequence." check-box. Select the device whose data is to be filtered accordingly. Only with GX/CX devices: Select whether the channel control has to be used and specify the channel, if necessary. Only with GX/CX devices: By activating or deactivating the corresponding checkboxes, specify whether spontaneous telegrams from the device shall be received or the storage medium shall be read. The "spontaneous telegrams" check-box is automatically activated for devices of other device families. Create filter with . The filter information is written in the C:\ProgramData\Bizerba\BCT\config\BCT2DB\devices.dat file. It is not saved - specifically, but it is valid for all s.

11.7.2

11

Creating filters manually

"Data filter" / "istrate" In the "Data File istration" window, the following buttons are available: Define new filter. <Save> Save all data filters. A new filter is displayed in the navigation area. Rename filter, see page 81 Assign device and make device-specific settings, see page 82. Create list of commands to be evaluated, see page 82. <Save> /

11.8

Renaming filters

New filters can be renamed as long as no data has been imported by means of the filter. After importing data, the function is grayed out. Use a comprehensive name. The filter name is also used for the relevant database table. Permitted characters: upper case, lower case, numbers and spaces. Spaces are not permitted at the beginning or at the end of the name.

38.026.297.001 en

81

_connect2DB

Operating instructions _connect.BRAIN

No differentiation is made between upper/lower case in filter names.

"Data filter" / "istrate" Right-click the filter to be renamed. In the context menu, select "Rename". Enter a new name and confirm using the enter key.

11.9

Editing filters

The filter management is used to edit existing filters and view the related database tables. The display is divided into the following tabs:

11

"Commands / Data": "Devices": "Data Browser":

List of device commands which the filter evaluates. List of devices whose data the filter evaluates. Display of already read table data.

The following buttons are available: Define new filter. <Save> Save all data filters. "Data filter" / "istrate" Select filter to be edited in the navigation area. The related data is shown in the display area. Assign devices and make device-dependent settings Select the "Devices" tab. Activate check-boxes of devices whose data the filter shall evaluate. Select device and make relevant settings. Settings

82

"Channel Control"

Only for GX/CX devices. Deactivate channnel control or select channel that is used for data transfer.

"use MemoCard"

Only for GX/CX devices. activated: Read out memory card regularly. not activated: Do not read out memory card.

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

Settings "spontaneous telegrams"

activated: Receive data initiated by the device (spontaneous telegrams). not activated: Receive only requested data.

"IxNet Converting (@41 --> A)"

Deactivate conversion or select conversion type.

Editing list of commands to be evaluated by means of filter Select the "Commands / Data" tab. On the tab, the following tabs are available for editing: Move line upwards. Move line downwards. Add new line at the end.

11

Delete selected line.

Editing lines Click the field to be edited on the "Commands / Data" tab and select the desired field name or command in the dropdown list. Saving data filter management <Save>

11.10

Defining handling of complex device commands

In the default setting, only simple device commands can be selected as filter criteria in _connect2DB. Device commands with a complex structure comprising a number of values and texts must first be made known to the program. Define the handling of device commands with complex data structure or variable number of parameters in the Collection_Command.dat configuration file. Each line contains a replacement command related to a complex device command. Example: –

GV02|GW05|GT03|LX02;%HGW05%_%DGW05%;%DGT03%

38.026.297.001 en

83

_connect2DB

Operating instructions _connect.BRAIN

The lines contain the following elements that are separated by a semicolon: – Header of the device command with a variable number of parameters for identification of the command in the data flow (GV02|GW05|GT03|LX02) – Definition of a new header for designation of the column in the database table (%HGW05%_%DGW05%) – Definition of the value that is written in the database (%DGT03%) Commands with a complex structure have the letter V (GV02) at the second position as operand code. Character strings that are enclosed in percentage signs are interpreted. Other characters are transferred unchanged. The first character after the percentage sign defines the information type: – %H... stands for a header. – %D... stands for a value.

11

When receiving device commands, the program searches for headers that are defined in the configuration file. When a suitable command is found, the received data will be replaced according to the relevant command for storage in the database table. Example 1: Resolution of a device command with a variable number of parameters into a replacement command with one parameter Instead of saving the received device commands, this replacement command saves the new header and the new value that have been defined in the Collection_Command.dat. Line in the Collection_Command.dat configuration file: GV02|GW05|GT03|LX02;%HGW05%_%DGW05%;%DGT03%

Received data packet: GV02|GW05|GT03|LX02 ; 2|Hallo

Storage in the database table: GW05_2 ; Hallo

The name of the first parameter (GW05) and the value of the first parameter (2) are connected by an underscore to form the name of the replacement command. This is also the name of the filter element or of the column in the database table (GW05_2). The value of the second parameter (Hallo) is saved as value of the replacement commands or contents of the database column.

84

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

Example 2: Resolution of a device command with a variable number of parameters into more replacement command with several parameters This replacement command lists the single commands with their respective parameters. Line in the Collection_Command.dat configuration file: GV01|GW03|GD01|GD02|GD07|LX02 ; %HGW03%|%HGD01%|%HGD02%|%HGD07% ; %DGW03%| %DGW01%|%DGW02%|%DGW07%

Received data packet: GV01|GW03|GD01|GD02|GD07|LX02 ; 1|1.0|2.1|3.4

Storage in the database table: GW03|GD01|GD02|GD07 ; 1|1.0|2.1|3.4

The database columns GW03, GD02, GD02 and GD07 receive the values 1, 1.0, 2.1 and 3.4. The replacement command of this example resolves the device command with a variable number of parameters without generating new pseudo commands. The following simple formula obtains the same result: GV01|GW03|GD01|GD02|GD07|LX02;*;*

The asterisks cause only the sequences GV01 and LX02 to be deleted from the data packet. The remaining data is transferred unchanged.

11.11

Deleting filters and relevant database tables

Deleting filters "Data filter" / "istrate" Right-click the filter to be deleted. In the context menu, select "Clear...". The filter is deleted without query. If data related to the filter has already been read, the corresponding database table appears in the navigation area under "Tables w/o Filters" and can be viewed in the display area. Deleting the relevant database table Right-click database table in the navigation area under "Tables w/o Filters". In the context menu, select "Clear...". The table is deleted without query.

11.12

Exporting data

The data imported in _connect2DB can be exported in the following formats: "Comma Separated Values (*.CSV)" "Microsoft Excel (.XLS)" "Microsoft Access (.MDB)"

38.026.297.001 en

Export in a text file with a semicolon (;) as separator. Export in Microsoft Excel file format. Export in Microsoft Access file format.

85

11

_connect2DB

Operating instructions _connect.BRAIN

During export, data is copied and not deleted from _connect2DB.

<Export data> or Via the "File" menu, select "Export...". The program _connect2DB.Export starts. The program _connect2DB.Export can also be called up separately via the start menu. Select the export format in the "Type" dropdown list. > Select at least one data filter or one database table as data source. > Enter the period from which data has to be exported. Depending on the selected data source, the devices from which the data to be exported originates are displayed.

11

If only data of certain devices is to be exported, deactivate the check-boxes of the other devices. > Enter path and name of the export file or search for them using the <...> button. Activate "Change numeric IX values" when decimal figures and values with unit have to be converted according to the _connect2DB configuration, see page 88. If no data is available, an error message is displayed. Otherwise export starts.

11.13

Data export via command line

Exporting of database tables can also be started via the command line. The following parameters are available: Parameters

Description

-export

Program start without interface (silent mode).

-table

Name of the table to be exported.

86

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

Parameters

Description

-period

Period from which data has to be exported. Value range: – thisday: All data with current date. – yesterday: All data of previous day. – thisweek: All data of current week (from Monday incl.). – lastweek: All data of previous week (Monday to Sunday). – thismonth: All data of current month. – lastmonth: All data of previous month. – thisyear: All data of current year. – lastyear: All data of previous year. Example: -period yesterday All data of the previous day will be exported.

-from -to

Period from which data has to be exported. Usable as an alternative to the -period parameter. Enter date and time in the format set under Windows. German format, for example: -from 21.05.2010 14:30 -to 21.05.2010 14:50

-format

Output format of data. Value range: CSV, XLS, MDB

-file

Path and name of output file. Example: -file c:\temp\export.csv

Example of an export call-up from the command line DBExport.exe -export -table Registrierung -from 02.03.2005 01:23 -to 03.09.2011 05:17 -format CSV -file c:\temp\export.csv

The export.cvs export file is saved in the C:\Temp directory without starting the DBExport interface. It contains all the data that has been imported in the mentioned period using the "Registration" filter.

38.026.297.001 en

87

11

_connect2DB

11.14

Operating instructions _connect.BRAIN

Configuring _connect2DB

Use the "Extras" menu item "Options" to configure the _connect2DB program. The configuration is saved in the C:\ProgramData/Bizerba/BCT/config/BCT2DB.ini file. Tab settings "Devices" "When starting program devices"

activated: When starting the program, establish automatic connection to the devices and start data transfer. not activated: No automatic start of data transfer.

"Read Memory Card every ..."

Period of time in s after that the memory card is automatically read out.

Tab settings "window" "Start mode of _connect2DB"

Display of program window after program start. "Minimized": The program starts in a minimized window and can be displayed using the task bar. "Normal": The program starts in a window that can be moved and scaled on the screen. "Maximized": The program starts in a window maximized to the screen size.

"Display rejected data sets."

activated: The last three data records, that have not been saved in the database table due to the filter criteria, are listed in the lower part of the display area (error display). The list contains the rejected data records with the following data: – Date and time of transmission Device from which data originates – – Filters used – Data record

11

Tab settings "Backup" This tab is only active when MS Access is used. When MS SQL Server is used, data backup and inventory maintenance are carried out using the corresponding Microsoft tools.

Trigger manual data backup in target directory, see page 90.

"Target directory"

Directory where data is backed up.

"Backup database every day"

activated: Daily automatic data backup at set time. not activated: No automatic data backup.

"Time"

Start of daily automatic data backup.

88

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

Tab settings "Restore" This tab is only active when MS Access is used. When MS SQL Server is used, backed up data is recovered using the corresponding Microsoft tools.

Recovering backed up data, see page 90.

"Clear backups/log activated: Backup and log files are automatically deleted after files older than n days" the entered number of days elapsed. not activated: Backup and log files are not automatically deleted. "Days:"

Number of days after that backup and log files are automatically deleted.

Tab settings "Export" "Export of weight values without unit"

activated: Export values without unit. not activated: Export values with unit.

"No header exported"

activated: Start export file with a header that describes the following data records. not activated: Start export file without header.

"Separator for weight values with unit"

Define separator for decimal figures. Options: – "Default (used in system)" – "Comma" – "PPoint"

"English or other language"

activated: Use English date and time format. not activated: Use German date and time format.

11

Tab settings "Default data" The tab is used for defining default data that is always available as possible filter criteria when creating or editing filters. Move the selected data from the "Available:" field in the "Fields/commands:" field and back using the buttons. "Fields/commands:"

Commands that are always available as possible filter criteria when defining filters (default data).

"Available:"

Available commands that can be used as default data.

38.026.297.001 en

89

_connect2DB

11.15

Operating instructions _connect.BRAIN

Deleting database contents

During data export, data is not deleted. The following options are available to delete database contents: – –

Delete database by means of integrated mechanisms (especially when MS SQL Server is used). Delete database contents using the _connect2DB.Delete program. The program is available via the _connect2DB menu. "Extras" / "Clear contents of database..." Enter . > Enter the creation time of the database contents to be deleted. > Select database tables whose data is to be deleted. Check and confirm security query.

11

11.16

Backing up and reloading data

The _connect2DB program s data backup when a MS Access database is used. Enter the settings for data backup and restore in the _connect2DB configuration, see page 88. Only data stored in the MS Access database is backed up. Filters are not saved. With the MS SQL Server, use the corresponding Microsoft data backup tools. "Extras" / "Options" Saving data manually Open the "Backup" tab. A backup file is saved in the configured target directory. Saving data automatically Open the "Backup" tab. Activate "Backup database every day" and enter the time for daily backup, see page 88. The data is automatically backed up at the set time every day. Loading data backups Open the "Restore" tab. Select backup file.

90

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2DB

> When loading data backups, the current data gets lost. Save the current data before loading data backups. After checking the security query, click . Enter and confirm. The selected data backup will be loaded.

11

38.026.297.001 en

91

_connect2SAP

Operating instructions _connect.BRAIN

12

_connect2SAP

12.1

Overview

_connect2SAP connects the Bizerba device world to the SAP environment. The program consists of the following components: – – – –

_connect2SAP Frontend, see page 99 _connect2SAP Registry, see page 100 _connect2SAP Spooler, see page 100 _connect2SAP Viewer, see page 101

12.2

Installation

If the _connect2SAP components have not been installed together with _connect.BRAIN, execute the _connect.BRAIN setup again to install this component. Select "Change", set the "_connect2SAP" option and follow the instructions on the screen. Before installing _connect2SAP, make sure SAP GUI is installed. If SAP GUI has not been installed yet, install it prior to the _connect2SAP component.

12

The components _connect2SAP Registry and _connect2SAP Spooler can be installed as service or program. Installation as service has the advantage that the communication will be activated automatically whenever the PC is started. Otherwise the components have to be manually started via the start menu. Please take into that the services have a service name and a display name which both differ from the exe file name. To start or terminate services via the input request using net start/stop, the service name or display name may be used. Service names: – Connect2SapRegistry – Connect2SapSpooler Display names: – Bizerba _connect.BRAIN SapRegistry – Bizerba _connect.BRAIN SapSpooler Exe files: – BCT2SAPRegistry.exe – BCT2SAPSpooler.exe Changing operating mode later (service/program) Call up the command line window via the start menu.

92

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

Go to the installation directory (usually: C:\Programme\Bizerba) and there to the .. \BCT\BCT2SAP subdirectory. Setting as service BCT2SAPRegistry.exe -service

or BCT2SAPSpooler.exe -service

Setting as program BCT2SAPRegistry.exe -regserver

or BCT2SAPSpooler.exe -regserver

Setting to "Automatic" for "Start type" service Open the "Services" windows via the system istration. Open the "Properties" of the service via the context menu. Set "Start type" to "Automatic". Terminating service and deleting entries from the registry <Start> / "istration" / "Services" Terminate the service via the context menu. Go to the command line window.

12

BCT2SAPRegistry.exe -unregserver

or BCT2SAPSpooler.exe -unregserver

Close command line window.

12.3

Configuration

12.3.1

_connect2SAP configuration

Configure _connect2SAP using the _connectConfig program , see page 36.

38.026.297.001 en

93

_connect2SAP

12.3.2

Operating instructions _connect.BRAIN

SAP configuration

To control the _connect2SAP server from the SAP system, the connection data on the R/3 side has to be maintained. The technical properties of the RFC connection are summed up under a logical name that is indicated in a program that was edited in the SAP programming language ABAP. Thus, when developing the ABAP client, the large amount of connection data must not be manually entered any longer. The connection data is exclusively maintained using the SAP transaction SM59. First create a RFC destination as described below. There are two possibilities for activation: <Start-up>:

:

When using the <Start-up> activation mode, communication between SAP and _Connect.BRAIN is established via _connect2SAP Frontend. Create a ed server using . The communication is carried out via the program components _connect2SAP Registry and _connect2SAP Spooler. In the "Program ID" field, specify the name used by _connect2SAP Registry or _connect2SAP Spooler when logging on SAP gateway. This is the "SAP Destination" ed in _connectConfig, see page 36.

In the SAP system, open the "SAP Easy Access" windows. Select "SAP menu" / "Tools" / "istration" / "Management" / "Network" / "SM59 RFC destinations". Select "T/IP connections" in the "Display and maintenance of RFC destinations" window and click . Create a RFC destination with the following properties:

12

Input field

Value

Description

RFC destination

in the examples: DEST_Z_RFC_BCT_F RONTEND or DEST_Z_RFC_REG

Name of RFC destination. SAP applications use this name to access the RFC destination , see page 97. The name is freely selectable.

Connection type

T

T/IP connection

Deactivate the "Trace" checkbox for standard operation to avoid that the system will be excessively loaded due to the large amount of incoming trace data. Activate it only when you need trace files for troubleshooting. Delete trace files generated by the SAP system via the "delete SAP Trace" checkbox in _connectConfig. Activation using start-up <Start-up>

94

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

In the "Program" field, specify the _connect2SAP Frontend program with the complete path.

Illustration 15: RFC destination DEST_Z_RFC_BCT_FRONTEND, activation using start-up

12

Activation using registration As "Program ID", enter the "SAP Destination" that has been ed in _connectConfig, see page 36.

Illustration 16: RFC destination DEST_Z_RFC_BCT_REG, activation using registration

38.026.297.001 en

95

_connect2SAP

Operating instructions _connect.BRAIN

Start _connect2SAP Registry or _connect2SAP Spooler and test the connection using the SM59 transaction. When the connection is established, a log with the duration of the transmission time for the individual data packets will be generated.

12

96

38.026.297.001 en

Operating instructions _connect.BRAIN

12.3.3

_connect2SAP

Packing table configuration

The configuration described below is required for using the Packing table function (transaction Hupast) in SAP and connecting it to _connect.BRAIN. This function is used to the weight of incoming deliveries.

12

Illustration 17: SAP packing table (Hupast transaction) The packing table data is maintained in the Hupast_C transaction. Complete the scale as described below. I _connectConfig, the "Hold Connection" checkbox has to be activated for the specified scale, see page 46.

38.026.297.001 en

97

_connect2SAP

Operating instructions _connect.BRAIN

In SAP, open the packing table profile (Hupast_C transaction)

12

Illustration 18: SAP packing table profile (Hupast_C transaction)

98

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

Make the following settings in the "scale" area. Pay attention to upper and lower case when entering the scale name and the RFC destination.

Input field

value

Connect scale

activating

RFC destination

In this example: Name of RFC destination created DEST_Z_RFC_BCT_F in SM59 which has to be accessed. RONTEND Select RFC destination with <Start-up> setting via , see page 94.

Scale name

In this example: ST

12.4

Description

Name of the scale as created in _connectConfig.

12

_connect2SAP Frontend

_connect2SAP Frontend s communication between SAP and _connect.BRAIN via Frontend. The advantage of this program is that all settings are identical for each PC in SAP even if different devices are connected to each PC. To work with the program, use start-up via the Frontend workstation for activation in the RFC destination (SM59 transaction), see page 94. If SAP accesses the RFC destination, _connect2SAP Frontend starts automatically and handles communication with _connect.BRAIN. After transmitting the data, the program sends the result to SAP and ends.

Illustration 19: Communication via Frontend Possible functional components – –

Z_RFC_BCT_MULTI, see page 104. Z_RFC_BCT, see page 104.

38.026.297.001 en

99

_connect2SAP

12.5

Operating instructions _connect.BRAIN

_connect2SAP Registry and _connect2SAP Spooler

The programs _connect2SAP Registry and _connect2SAP Spooler communication between _connect.BRAIN and SAP via a RFC destination. They can be installed as service or as program. During start, these components log on the SAP system using the "SAP Destination" specified in _connectConfig, see page 36. In SAP, "SAP Destination" is ed as program ID in the RFC destination. As soon as SAP uses the RFC destination, SAP tries to establish a connection, transfer data to the program and return the results to the SAP system by using the program ID. The advantage of this procedure is that only one PC is used for communication with the devices. All SAP programs can establish a connection to this PC.

12

Illustration 20: Communication using _connect2SAP Registry and _connect2SAP Spooler _connect2SAP Registry Via _connect2SAP Registry, the SAP system can communicate with the devices, e.g. to determine weight values of a scale. Possible functional components – –

Z_RFC_BCT_MULTI, see page 104 Z_RFC_BCT, see page 104

_connect2SAP Spooler _connect2SAP Spooler s communication between SAP and _connect.BRAIN when printing. SAP uses this component to send print jobs to the server. The spooler manages the print jobs and handles errors. Print jobs can be deleted using the corresponding _connect2SAP Viewer monitoring program.

100

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

Example of a print job szHeader = I|PV01|PW00|PW02|GW09|GT01|LX02 szData = 0|1|2|Testlabel|ST PV01:

Print command Label type Handle Labeling mode Text field 1 Text field 2 End of a V command

PW00: PW02: GW09: GT01: GT02: LX02:

Possible functional components – –

Z_RFC_BCT_PRINT, see page 105 Z_RFC_BCT_SPOOLER, see page 105

12.6

_connect2SAP Viewer

12.6.1

Overview

12

The program lists the print jobs sent by the SAP system. Print jobs can be cancelled and deleted here. The program is a client application and does not function without server.

12.6.2

Starting the program

Call up _connect2SAP Viewer via the start menu. The start window of the program appears.

38.026.297.001 en

101

_connect2SAP

12.6.3

Operating instructions _connect.BRAIN

Structure of the program

Illustration 21: interface _connect2SAP Viewer In addition to typical Windows elements, the interface contains a table with the print jobs in progress.

12.6.4

12

Menu bar and toolbar functions

"File" menu "Create testjob..."

Create print job manually and display it in _connect2SAP Viewer. Enter the following print job data in the "Create testjob" window. – Device – Number of labels to be printed Print job header – – Data line

"Refresh"

Update print job list. The function is also available as button with the same name.

"Minimize"

Minimize program. The program appears as symbol in the right part of the task bar and can be restored or terminated via the context menu. The function is also available as button with the same name.

"Exit"

Close program.

"Language" menu Select here a language for the interface. Additional functions

Cancel and delete currently selected print job. Show application information, see page 13.

102

38.026.297.001 en

Operating instructions _connect.BRAIN

12.7

Functional components

12.7.1

Overview of functions

_connect2SAP

12

Illustration 22: Overview of SAP functions

38.026.297.001 en

103

_connect2SAP

12.7.2

Operating instructions _connect.BRAIN

Z_RFC_BCT

FUNCTION Z_RFC_BCT. *"-------------------------------------------------------------*"*"Local interface: *" IMPORTING *" VALUE(P_IN_BCT_HEADER) TYPE CHAR1024 *" VALUE(P_IN_BCT_DATA) TYPE CHAR1024 *" VALUE(P_IN_BCT_LEN_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_IN_BCT_STATUS) LIKE BAPIRET2-MESSAGE *" EXPORTING *" VALUE(P_RET_SYSTEM)LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_CODE) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_TEXT) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_HEADER) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_LEN_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_STATUS) LIKE BAPIRET2-MESSAGE *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"-------------------------------------------------------------ENDFUNCTION.

12

12.7.3

Z_RFC_BCT_MULTI

FUNCTION Z_RFC_BCT_MULTI. *"-------------------------------------------------------------*"*"Local interface: *" IMPORTING *" VALUE(P_IN_BCT_HEADER) TYPECHAR1024 *" VALUE(P_IN_BCT_DATA) TYPECHAR1024 *" VALUE(P_IN_BCT_LEN_DATA) LIKEBAPIRET2-MESSAGE *" VALUE(P_IN_BCT_STATUS) LIKEBAPIRET2-MESSAGE *" VALUE(P_IN_BCT_DEVICE) LIKEBAPIRET2-MESSAGE *" VALUE(P_IN_BCT_COUNT) LIKEBAPIRET2-MESSAGE *" EXPORTING *" VALUE(P_RET_SYSTEM) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_CODE) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_TEXT) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_BCT_HEADER) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_BCT_DATA) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_BCT_LEN_DATA) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_BCT_STATUS) LIKEBAPIRET2-MESSAGE *" VALUE(P_RET_BCT_DEVICE) LIKEBAPIRET2-MESSAGE *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"-------------------------------------------------------------------ENDFUNCTION.

104

38.026.297.001 en

Operating instructions _connect.BRAIN

12.7.4

_connect2SAP

Z_RFC_BCT_PRINT

FUNCTION Z_RFC_BCT_PRINT. *"-------------------------------------------------------------*"*"Local interface: *" IMPORTING *" VALUE(P_IN_BCT_HEADER) TYPE CHAR1024 *" VALUE(P_IN_BCT_DATA) TYPE CHAR1024 *" VALUE(P_IN_BCT_LEN_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_IN_BCT_STATUS) LIKE BAPIRET2-MESSAGE *" VALUE(P_IN_BCT_DEVICE) LIKE BAPIRET2-MESSAGE *" VALUE(P_IN_BCT_COUNT) LIKE BAPIRET2-MESSAGE *" EXPORTING *" VALUE(P_RET_SYSTEM) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_CODE) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_TEXT) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_HEADER) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_LEN_DATA) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_STATUS) LIKE BAPIRET2-MESSAGE *" VALUE(P_RET_BCT_DEVICE) LIKE BAPIRET2-MESSAGE *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"-------------------------------------------------------------------ENDFUNCTION.

12.7.5

12

Z_RFC_BCT_SPOOLER

FUNCTION Z_RFC_BCT_SPOOLER. *"-----------------------------------------------------------------*"*"Local interface: *" IMPORTING *" VALUE(P_IN_BCT_DEVICE) LIKEBAPIRET2-MESSAGE *" VALUE(P_IN_BCT_STATUS) LIKEBAPIRET2-MESSAGE *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"-----------------------------------------------------------------*status 1 = Start spooler.

*status 2 = Stop spooler. *status 3 = Delete all active orders. ENDFUNCTION.

38.026.297.001 en

105

_connect2SAP

12.7.6

Operating instructions _connect.BRAIN

Z_BCT_LABEL_GLP The layout WE_Chargenlabel.lay must be present on the GLP.

* * Label printing report on Bizerba GLP printer via RFC-FB. * report z_bct_label_glp message-id z0 line-size 255. * * Tables: * tables: mseg, makt. * * Number of labels

12

* parameters: p_anz type i default 1. * * Communication structure for FB Z_RFC_BCT: * data: p_in_bct_header like bapiret2-message, p_in_bct_data like bapiret2-message, p_in_bct_len_data like bapiret2-message, p_in_bct_status like bapiret2-message, p_in_bct_device like bapiret2-message, p_ret_system like bapiret2-message, p_ret_code like bapiret2-message, p_ret_text like bapiret2-message, p_ret_bct_header like bapiret2-message, p_ret_bct_data like bapiret2-message, p_ret_bct_len_data like bapiret2-message, p_ret_bct_status like bapiret2-message, p_ret_bct_device like bapiret2-message. * * Help fields: * data: zerf_menge(13) type c, fl type i. *-------------------------------------------------------------------* GxNet

Parameter-Name

Parameters

*-------------------------------------------------------------------* GT01 *

106

GGT_ATX1 (PLU memory 1: part designation)

Character data

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

* GT02 *

GGT_ATX2 (PLU memory 2: measuring unit)

Character data

* GT21 *

GT_CAB1 (material number)

Barcode with structure rule

* GT22 *

GGT_CAB2 (quantity)

Barcode with structure rule

* GT23 *

GT_CAB3 (batch data)

Barcode with structure rule

* GW09 *

GGW_AUSZEICH_ART (Labeling mode)

2 (fixed weight)

* LV01 *

LGV_SEQUENZ (Device configuration)

-

* LX02 *

LGX_CLOSE (logical end of command)

-

* PV01 *

PSV_PCK (package synchronous labeling data)

-

* PW00 *

PSW_ETIKETTYP (Specification of label data)

0 (Normal label)

* PW02 *

PSW_PACKHDL (package handle: cons. number)

0-100

12

* * Fill data: mseg-matnr = '000000071432080001'. mseg-charg = '1234567890'. mseg-erfmg = '1542.380'. mseg-meins = 'ST'. makt-maktx = 'Testlabel'. write mseg-erfmg to zerf_menge no-sign no-grouping. if zerf_menge+9(4) = ',000'. clear zerf_menge+9(4). endif. shift zerf_menge left deleting leading space. translate zerf_menge using ',.'. fl = strlen( zerf_menge ). do p_anz times. * * send barcodes: * p_in_bct_header = '!LV01|GT21|GT22|GT23|LX02'. concatenate '0001{300502000200000070}0002{'mseg-matnr '}|' '0001{300502000200000070}0002{'zerf_menge(fl) '}|' '0001{300502000200000070}0002{'mseg-charg '}' into p_in_bct_data. perform call_rfc_bct. * * Send text data:

38.026.297.001 en

107

_connect2SAP

Operating instructions _connect.BRAIN

* p_in_bct_header ='!PV01|PW00|PW02|GW09|GT01|GT02|LX02'. concatenate '0|1|2|' makt-maktx '|' mseg-meins into p_in_bct_data. perform call_rfc_bct. enddo. * =============================================== * Call RFC functional component Z_RFC_BCT_MULTI:

* Starts destination DEST_Z_RFC_BCT. * The PC program is linked with this destination. * =============================================== form call_rfc_bct. * * Determine field length: * p_in_bct_len_data = strlen( p_in_bct_data ). p_in_bct_status = '0'. p_in_bct_device = 'GLP1'. * * Call RFC functional component:

12

* call function 'Z_RFC_BCT_MULTI' destination'DEST_Z_RFC_BCT' exporting p_in_bct_header = p_in_bct_header p_in_bct_data = p_in_bct_data p_in_bct_len_data =p_in_bct_len_data p_in_bct_status = p_in_bct_status p_in_bct_device = p_in_bct_deviceimporting p_ret_system = p_ret_system p_ret_code = p_ret_code p_ret_text = p_ret_text p_ret_bct_header =p_ret_bct_header p_ret_bct_data = p_ret_bct_data p_ret_bct_len_data =p_ret_bct_len_data p_ret_bct_status =p_ret_bct_status p_ret_bct_device =p_ret_bct_device exceptions communication_failure = 1 system_failure = 2 others = 3. skip. write: /'p_in_bct_header ', p_in_bct_header(200), /'p_in_bct_data ',p_in_bct_data(200), /'p_in_bct_len_data ',p_in_bct_len_data(200), /'p_in_bct_status ',p_in_bct_status(200), /'p_in_bct_device ',p_in_bct_device(200). write: /'p_ret_system ', p_ret_system(200), /'p_ret_code ', p_ret_code(200), /'p_ret_text ', p_ret_text(200), /'p_ret_bct_header ',p_ret_bct_header(200), /'p_ret_bct_data ',p_ret_bct_data(200), /'p_ret_bct_len_data ',p_ret_bct_len_data(200), /'p_ret_bct_status ',p_ret_bct_status(200),

108

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

/'p_ret_bct_device ',p_ret_bct_device(200), /'sy-subrc ', sy-subrc. * * Initialize input fields for next call: * clear p_in_bct_header. clear p_in_bct_data. clear p_in_bct_len_data. clear p_in_bct_status. endform.

12

38.026.297.001 en

109

_connect2SAP

12.7.7

Operating instructions _connect.BRAIN

Z_BCT_DIMENSION

FUNCTION Z_BCT_DIMENSION. *"-------------------------------------------------------------------*"*" Local interface: *"IMPORTING *" REFERENCE(P_IN_BCT_DIM) TYPE STRING *"EXPORTING *" REFERENCE(P_OUT_SAP_DIMENSION) TYPESTRING *" REFERENCE(P_OUT_SAP_VALUE) TYPE STRING *"-------------------------------------------------------------------DATA :

12

ilen

TYPE i,

dimensiontab

TYPE TABLE OF string,

szeinheit

TYPE string,

szstellen

TYPE string,

szvalue

TYPE string,

szvorkomma

TYPE string,

sznachkomma

TYPE string,

nhelp

TYPE i.

* Split up data from ;-3;123 kg SPLIT p_in_bct_dim AT ';' INTO TABLEdimensiontab. READ TABLE dimensiontab INDEX 1 INTOszeinheit. READ TABLE dimensiontab INDEX 2 INTOszstellen. READ TABLE dimensiontab INDEX 3 INTO szvalue. * Check whether decimal places are present: IF szstellen < 0. * Check whether filling is required at front ilen = strlen( szvalue ). nhelp = abs( szstellen ) + 1. WHILE ilen < nhelp . ilen = ilen + 1. CONCATENATE '0' szvalue INTOszvalue . ENDWHILE. * Insert point: ilen = strlen( szvalue ). ilen = szstellen + ilen. szvorkomma = szvalue+0(ilen). sznachkomma = szvalue. SHIFT sznachkomma BY ilen PLACES. CONCATENATE szvorkomma '.' INTO szvalue. CONCATENATE szvalue sznachkomma INTOszvalue . ELSE. * Fill with zeros at back: WHILE szstellen > 0. szstellen = szstellen - 1. CONCATENATE szvalue '0' INTOszvalue . ENDWHILE. ENDIF. * CONCATENATE szValue szEinheit into szValue SEPARATED BY SPACE.

110

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

* write: / 'Dimension ' , szValue. p_out_sap_value = szvalue. p_out_sap_dimension = szeinheit. ENDFUNCTION.

12

38.026.297.001 en

111

_connect2SAP

12.7.8

Operating instructions _connect.BRAIN

Z_BCT_REG

The function divides a logon data record received by _connect.BRAIN in SAP fields. Example: Recording data set: I?LV01|RX04|LX02 Postenregistrierung addierend

Received data: I!GV01|GW01|GT08|GT0A|GT11|GL0E|GL0C|GT0E|GL0A|GL15|GD07|GD01|GD02|LX02-1| Scale_49|11000000|100000000+0|02122002|1618|19596352|101|101|kg;-3;75|kg;-3;75| kg;-3;0

Data to SAP: P_RET_SYSTEM P_RET_CODE P_RET_TEXT P_RET_DATE P_RET_TIME P_RET_SCALENR

12

P_RET_TAREWEIGHT P_RET_GROSSWEIGHT P_RET_CONTINUOUSNR

System number Error code Error text Date Time Scale number Tare weight Gross weight Verification number

FUNCTION Z_BCT_REG. *"*"Local interface: *"-------------------------------------------------------------------*" EXPORTING *" REFERENCE(P_RET_SYSTEM) TYPE STRING *" REFERENCE(P_RET_CODE) TYPE STRING *" REFERENCE(P_RET_TEXT) TYPE STRING *" REFERENCE(P_RET_DATE) TYPE D *" REFERENCE(P_RET_SCALENR) TYPE STRING *" REFERENCE(P_RET_TAREWEIGHT) TYPE STRING *" REFERENCE(P_RET_GROSSWEIGHT) TYPESTRING *" REFERENCE(P_RET_CONTINUUSNR) TYPESTRING *" REFERENCE(P_RET_TIME) TYPE T *" REFERENCE(P_RET_DIMENSION) TYPE STRING *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"--------------------------------------------------------------------

112

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

DATA: text

TYPE string,

datatab

TYPE TABLE OF string,

headertab

TYPE TABLE OF string,

ni

TYPE i,

szheader(220)

TYPE c,

szheader(220)

TYPE c,

szanswerheader(220)

TYPE c,

szanswerdata(220)

TYPE c,

ctyp

TYPE char1,

szdimensions

TYPE string,

szretsystem(220)

TYPE c,

szretcode(220)

TYPE c,

szrettext(220)

TYPE c,

szlendata(220)

TYPE c,

szstatus(220)

TYPE c,

szvalue

TYPE string.

szheader = 'I?LV01|RX04|LX02'. szdata = ''. szvalue = strlen( szdata ). CALL FUNCTION 'Z_RFC_BCT' DESTINATION 'DEST_Z_RFC_BCT' EXPORTING p_in_bct_header = szheader p_in_bct_data = szdata p_in_bct_status = '0' p_in_bct_len_data = szvalue IMPORTING p_ret_system = szretsystem p_ret_code = szretcode p_ret_text = szrettext p_ret_bct_header = szanswerheader p_ret_bct_len_data = szlendata p_ret_bct_status = szstatus p_ret_bct_data = szanswerdata EXCEPTIONS communication_failure = 1 system_failure = 2 OTHERS = 3. CASE syst-subrc. WHEN 0. WRITE : 'header', szanswerheader. WRITE : 'data', szanswerdata. WRITE : 'szRetSystem', szretsystem. WRITE : 'szStatus', szstatus. WRITE : 'szLenData', szlendata. WRITE : 'szRetText', szrettext. WRITE : 'szRetCode', szretcode. CONDENSE szretcode. IF szretcode = '0'. WRITE : 'ok'.

38.026.297.001 en

12

113

_connect2SAP

Operating instructions _connect.BRAIN

* Customer program * Separate header I! or I? SHIFT szheader BY 2 PLACES. * Data in table: SPLIT szanswerheader AT '|' INTO TABLEheadertab. SPLIT szanswerdata AT '|' INTO TABLEdatatab. * Evaluate data: ni = 1. LOOP AT headertab INTO text. CASE text. WHEN 'GL15'. READ TABLEdatatab INDEX ni INTO P_RET_CONTINUUSNR. WHEN 'GT08'. READ TABLEdatatab INDEX ni INTO P_RET_SCALENR. WHEN 'GL0E'. * Date must be indicated like this: year day month:

12

READ TABLEdatatab INDEX ni INTO szvalue. CONCATENATEszvalue+4(4) szvalue+0(4) INTO szvalue. P_RET_DATE= szvalue. WHEN 'GL0C'. READ TABLEdatatab INDEX ni INTO P_RET_TIME. WHEN 'GD02'. READ TABLEdatatab INDEX ni INTO szvalue. CALLFUNCTION 'Z_BCT_DIMENSION' EXPORTING p_in_bct_dim= szvalue IMPORTING p_out_sap_value= szvalue p_out_sap_dimension= szdimensions. P_RET_TAREWEIGHT= szvalue. WHEN 'GD07'. READ TABLEdatatab INDEX ni INTO szvalue. CALLFUNCTION 'Z_BCT_DIMENSION' EXPORTING p_in_bct_dim= szvalue IMPORTING p_out_sap_value= szvalue p_out_sap_dimension= szdimensions. P_RET_GROSSWEIGHT= szvalue. TRANSLATEszdimensions TO UPPER CASE. P_RET_DIMENSION= szdimensions. ENDCASE. " text * The data type determines whether data is included or not: SHIFT text BY 1 PLACES. ctyp = text. CASE ctyp. WHEN 'L' OR 'T' OR 'W'OR 'D'. ni = ni +1. ENDCASE. "ctyp ENDLOOP. "headertab ENDIF. "szretcode = 0 * Fill return: P_RET_SYSTEM = szretsystem.

114

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

P_RET_CODE = szretcode. P_RET_TEXT = szrettext. WHEN 1 OR 2. * 'communication_failure' or 'system_failure' RAISE COMMUNICATION_FAILURE. WHEN OTHERS. * Other errors: ENDCASE. ENDFUNCTION.

" syst-subrc'Z_RFC_BCT'

12

38.026.297.001 en

115

_connect2SAP

12.7.9

Operating instructions _connect.BRAIN

Z_BCT_NULLSTELLEN

FUNCTION Z_BCT_NULLSTELLEN. *"-------------------------------------------------------------------*"*"Local interface: *" EXPORTING *" REFERENCE(SYSTEM_NR) TYPE ZFC_SYSTEM_NR *" REFERENCE(SUBRC) TYPE ZFC_SUBRC *" REFERENCE(SUBRC_TXT) TYPE ZFC_SUBRC_TXT *" EXCEPTIONS *" ERROR *"-------------------------------------------------------------------DATA:

12

szheader(220)

TYPE c,

szdata(220)

TYPE c,

szanswerheader(220)

TYPE c,

szanswerdata(220)

TYPE c,

ctyp

TYPE char1,

szdimensions

TYPE string,

szretsystem(220)

TYPE c,

szretcode(220)

TYPE c,

szrettext(220)

TYPE c,

szlendata(220)

TYPE c,

szstatus(220)

TYPE c,

szvalue

TYPE string.

szheader = 'I!GX02'. szdata = ''. szvalue = strlen( szdata ). CALL FUNCTION 'Z_RFC_BCT' DESTINATION 'DEST_Z_RFC_BCT' EXPORTING p_in_bct_header = szheader p_in_bct_data = szdata p_in_bct_status = '0' p_in_bct_len_data = szvalue IMPORTING p_ret_system = szretsystem p_ret_code = szretcode p_ret_text = szrettext p_ret_bct_header = szanswerheader p_ret_bct_len_data = szlendata p_ret_bct_status = szstatus p_ret_bct_data = szanswerdata EXCEPTIONS communication_failure = 1 system_failure = 2 OTHERS = 3. CASE syst-subrc. WHEN 0. system_nr = szretsystem. subrc = szretcode. subrc_txt = szrettext.

116

38.026.297.001 en

Operating instructions _connect.BRAIN

_connect2SAP

WHEN 1 OR 2. * 'communication_failure' or 'system_failure' RAISE error. WHEN OTHERS. * other failure ENDCASE. " syst-subrc'Z_RFC_BCT' ENDFUNCTION.

12.7.10

CFB_RFC_BCT_MULTI

FUNCTION CFB_RFC_BCT_MULTI. *"-----------------------------------------------------------------*"*"Local interface: *" IMPORTING *" VALUE(P_IN_BCT_HEADER) TYPE TEXT_512 *" VALUE(P_IN_BCT_DATA) TYPE STRING *" VALUE(P_IN_BCT_LEN_DATA) TYPE TEXT_512 *" VALUE(P_IN_BCT_DEVICE) TYPE TEXT_512 *" EXPORTING *" VALUE(P_RET_SYSTEM) TYPE TEXT_512 *" VALUE(P_RET_CODE) TYPE TEXT_512 *" VALUE(P_RET_TEXT) TYPE TEXT_512 *" VALUE(P_RET_BCT_HEADER) TYPE TEXT_512 *" VALUE(P_RET_BCT_DATA) TYPE TEXT_512 *" VALUE(P_RET_BCT_LEN_DATA) TYPE TEXT_512 *" VALUE(P_RET_BCT_STATUS) TYPE TEXT_512 *" VALUE(P_RET_BCT_DEVICE) TYPE TEXT_512 *" EXCEPTIONS *" COMMUNICATION_FAILURE *" SYSTEM_FAILURE *"-----------------------------------------------------------------ENDFUNCTION.

38.026.297.001 en

12

117

_connectScannerWI

13

_connectScannerWI

13.1

Overview

Operating instructions _connect.BRAIN

_connectScannerWI is used to connect an external barcode scanner to any program that processes text and numeric information. For this, the scanner is connected to the PC where the processing program runs via a serial interface. A service running in the background records the data and sends it to the active program for processing. _connectScannerWI transfers the scanned data in form of simulated keyboard inputs. The data supplied by the scanner is therefore processed as if the barcode had been input using a keyboard. To control processing, the barcode sequence can be completed by means of additional keyboard commands (e.g. forwarding to a new input field or to the next input dialog).

13.2

Prerequisites

The following prerequisites apply when connecting a barcode scanner: –

The barcode scanner can be connected to a PC serial interface. It can transmit successfully read barcodes in form of numbers and separators to a PC. The barcode scanner is set by default. That means, it only transmits correctly read barcode data using CR+LF (carriage return and line feed) as separators. It does not transmit any incorrect or unidentified barcode data, nor does it transmit meta information via barcode type, etc. The PC has a free serial interface, to which the barcode scanner can be connected.

–

13 –

13.3

Installation

Select _connectScannerWI as component to be installed when installing _connect.BRAIN. If _connect.BRAIN has been installed without _connectScannerWI, proceed as follows: Open Windows system control. Select "Deinstall program". Select "Change" in the context menu for _connect.BRAIN. Select "Change program" in the installation program. > Activate the "_connectScannerWI" check-box. > Follow the instructions on the screen to complete installation. During installation, _connectScannerWI s in the Windows autorun path so that it is automatically started with each . Registry path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run

118

38.026.297.001 en

Operating instructions _connect.BRAIN

13.4

_connectScannerWI

Configuration

Configure _connect2File using the _connectConfig program. Create device with the following settings, see page 46. Device settings for the barcode scanner in _connectConfig "Devicetype"

"FX Other devices" / "Scanner"

"Connection-type"

"Serial"

"Interface"

Set to the interface the scanner is connected with. Configure the interface according to the scanner parameters (see manual or scanner configuration program). The following parameters are common: – "Baudrate": 9600 – "Databits": 8 – "Parity": "none" – "Stopbits": 1 – "Protocol": "no handshake"

"Dialog"

"_Standard serial IX"

"Logging/size"

Normal operation does not require reporting. Logging of all data is advisable for faultfinding.

"Header-Format"

"Gx/Ix-Net(A!, I!, A?, I?)"

"_connect2SAP"

Save default settings.

"Connection"

Do not activate the "Hold Connection" check-box.

"Status"

Activate the "Device active" check-box.

13

Adapt settings to the operation of _connectScannerWI , see page 37.

13.5

Starting the program

_connectScannerWI is automatically started with each . The started program appears as icon in the right part of the task bar. After closing the program, it can be restarted manually via the start menu.

13.6

Program structure

After starting the program, _connectScannerWI appears only as icon in the right part of the task bar. The interface consists of a context menu and a status window. Open the status window using the "Display window" function of the context menu. The program activities and the time are displayed.

38.026.297.001 en

119

_connectScannerWI

13.7

Operating instructions _connect.BRAIN

Functions in the context menu

The following functions are available via the context menu of the program symbol: "Display window"

Show status window.

"Fenster verbergen"

Hide status window.

"Scanner starten"

Start accessing barcode scanner.

"Scanner stoppen"

Stop access to barcode scanner. This is necessary for changing a _connect.BRAIN configuration.

"Close"

Close _connectScannerWI.

13

120

38.026.297.001 en

Operating instructions _connect.BRAIN

14

VirtualES - View

14.1

Overview

VirtualES - View

The VirtualES program is a verifiable memory for weighing. The data are protected by check sums and are protected against manipulation. The VirtualES software component consists of two programs: to configure the verifiable memory. View to read the verifiable memory content. In order to be able to operate devices with a verifiable memory, access to VirtualES must be activated in the device configuration. Activation is done in _connectConfig in the BCS configuration of the devices. The "Use Virtual ES" option must be activated here. The istration tool can also be called from here.

14.2

VirtualES -

The VirtualES istration tool serves to configure the verifiable memory. It can be used to define the properties that will be stored in the verifiable memory for each weighing, for each configured device.

14.2.1

Starting program

Call up VirtualES - via the Start menu. The start window of the program appears.

38.026.297.001 en

14

121

VirtualES - View

14.2.2

Operating instructions _connect.BRAIN

Structure of the program

Illustration 24: interface VirtualES - 1 Menu bar

14

2

Tool bar

3

Navigation area

4

Display area

The interface contains the following areas, in addition to typical Windows elements: Navigation area

Display area

The databases and devices configured until now are displayed here. When you select a database, the set parameters appear in the display area. The parameter settings of the database or the device selected in the navigation area are displayed here.

Information is distributed to two tabs in the display area: Dataset This displays the assignments relating to which parameters are saved within the data records and which can be additionally selected. Compulsory parameters cannot be deselected and are always a constituent of a data record. Size The number of data records is specified here.

122

38.026.297.001 en

Operating instructions _connect.BRAIN

14.2.3

VirtualES - View

Menu bar and toolbar functions

Functions in menu "File" "New"

Create new configuration.

"Save"

Save current configuration.

"Exit"

Close VirtualES - .

Functions in menu "Extras" "Language"

Allows the language to be changed in the guidance.

"Change name of DB"

Allows to rename an existing database.

Functions in menu "?" "Information about VirtualES-"

Displays the program version and installation environment.

"Signatures"

Displays the digital signatures of the configuration program and the background server application. This allows you to check whether changes have been made to VirtualES or parts of it.

14.2.4

Defining new configuration

"file" / "New" or Click the corresponding icon of the toolbar. Select a device and go to the next selection window using "Forward >". Only one device can be selected. Select further parameters that are to be transferred to the protected memory. Compulsory data (gross, net/tare, data record number, etc.) cannot be deselected.

38.026.297.001 en

123

14

VirtualES - View

14.3

Operating instructions _connect.BRAIN

VirtualES - View

The VirtualES - View display program serves for visualization of the saved data. Data records: – Data record number – Date – Time Scale number – – Tare weight – Gross weight – Consecutive number

14.3.1

Start program

Call up VirtualES - View via the Start menu. The start window of the program appears.

14.3.2

Program structure

14

Illustration 25: VirtualES view interface 1 Menu bar 2

Tool bar

3

Navigation area

4

Display area

The interface contains the following areas, in addition to typical Windows elements: Navigation area

Display area

124

The configured databases and devices are displayed here. When you select a device, the saved data appears in the display area. The parameters of the database selected in the navigation area are displayed here. The data is displayed in a tabular structure. If a filter is set, only the filtered data records appear. Otherwise all saved data appears. All or part of the data in the display area can be selected, e.g. for printing.

38.026.297.001 en

Operating instructions _connect.BRAIN

14.3.3

VirtualES - View

Menu bar and toolbar functions

Functions in menu "File" "Refresh"

Updates the current display by reading out the verifiable memory again.

"Save as"

Saves all data of the selected devices in an XML file. For this purpose a file dialog is called up, in which you can define the name and location of the file to be written.

"print"

Prints the selected area or the entire document.

"sideview"

Displays a preview of the selected area or the entire document. A printout can then be made from this preview.

"Printer settings..."

Allows the configuration of a printer for the print function.

"Close"

Close VirtualES - View.

Functions in menu "Filter" "Activate Filter..."

"Remove Filter"

Opens a dialog window, in which up to 4 filter options can be set: The filter can be configured by selecting a parameter from the verifiable memory, an operator (less than, less than/equal to, equal to, etc.), a reference value and a link to the other filter options. This allows a set filter to be deactivated again, so that all data is displayed again.

Functions in menu "Extras" "Language"

Allows the language to be changed in the guidance.

Functions in menu "?" "Information about VirtualES-View"

Displays the program version and installation environment.

"Show signatures"

Displays the digital signatures of the configuration program and the background server application. This allows you to check whether changes have been made to VirtualES or parts of it.

38.026.297.001 en

125

14

VirtualES - View

14.3.4

Operating instructions _connect.BRAIN

Display data records

The data records of the verifiable memory can be viewed, searched and printed out. Click on the selected scale. The data records are displayed.

14.3.5

Check signatures

The signatures must match the data in test certificate no. D09-02.22. VirtualES - View is opened. Show signatures "?" / "Show signatures" Read signatures and compare with test certificate. Close window "OK" The BCS server identification number is only displayed if the connection with the Bizerba Communication Server (BCS) is activated and registration has already taken place.

14.3.6

14

Registration of weighing results

VirtualES saves the weighing results of the individual verified scales in a verifiable memory. The verifiable module and the saved data are protected by check sums and cannot be changed unnoticed. Select scale with right mouse button. "VirtualES function test" A pop-up window is opened. "Registration" The weighing results of the scale are ed and saved in VirtualES. "Close" The pop-up window is closed. The saved data is displayed highlighted in the display area.

126

38.026.297.001 en

Operating instructions _connect.BRAIN

15

_edit.BRAIN

15.1

Overview

_edit.BRAIN

_edit.BRAIN is a program for viewing log files (*.log or *.commlog) created by other _connect.BRAIN applications.

15.2

Starting the program

Call up _edit.BRAIN via the start menu. The start window of the program appears.

15.3

Program structure

15

Illustration 26: interface _edit.BRAIN 1 Menu bar 2

Tool bar

3

Display and editing area

4

Bx-Net View

38.026.297.001 en

127

_edit.BRAIN

15.4

Operating instructions _connect.BRAIN

Menu bar and toolbar functions

Functions in the "File" menu

15

"New"

Create a new text file.

"Open"

Open an existing *.log, *.commlog or text file.

"Save"

Save an existing *.log, *.commlog or text file.

"Save as..."

Save an open *.log, *.commlog or text file with a freely selectable name.

"Save all"

Save all open *.log, *.commlog or text files.

"Close"

Close an open *.log, *.commlog or text file.

"Close all"

Close all open *.log, *.commlog or text files.

"Print"

Print an open *.log, *.commlog or text file.

"Send as E-Mail"

Send an open *.log, *.commlog or text file as e-mail.

"Last opened files"

Open last open file again.

"Exit"

Close _edit.BRAIN.

128

38.026.297.001 en

Operating instructions _connect.BRAIN

_edit.BRAIN

Functions in the "Edit" menu "Undo"

Undo last action.

"Redo"

Repeat last action.

"Cut"

Cut selected section.

"Copy"

Copy selected data to clipboard.

"Paste"

Paste data from clipboard.

"Delete"

Delete marked section.

"Select all"

Select all.

"Find"

Find data.

"Replace"

Replace data.

"Find next"

Continue search with same settings.

"Refresh"

Reload data.

"More"

15

Open further editing tools: "Set comment" Set comment symbol. "Delete comment " Delete comment symbol. "Set bookmark" Set read symbol. "Previous bookmark " Go to previous read symbol. "Next bookmark" Go to next read symbol. "Delete bookmark " Delete read symbol.

38.026.297.001 en

129

_edit.BRAIN

Operating instructions _connect.BRAIN

Functions in the "View" menu "Output"

Opens a display area for the data to be output at the bottom of the main window.

"Clipboard"

Opens the clipboard.

"BxNet View"

Opens the "BxNetView" display area at the bottom of the main window.

"Toolbars"

Show or hide toolbars: – View – Edit – File

Functions in the "Language" menu "Deutsch" Sets the program language to German. "English" Sets the program language to English. Functions in the "Windows" menu "Windows..." It is used to change between the open *.log, *.commlog or text files.

15

Functions in the "Extras" menu "Synchronisation..." Commlogs or logs can be synchronized between themselves or with event logs. To do so, the time stamps are compared and chronologically arranged in a temporary file. Functions in the "Tools" menu "Notepad" Opens the Windows notepad. "BCT"

Log files of other Bizerba applications can be opened or deleted.

Functions in the "Help" menu "Info about..." A window with the current program information appears.

130

38.026.297.001 en

Operating instructions _connect.BRAIN

15.5

_edit.BRAIN

Functions in the context menu

After opening the *.commlog files, the following features are available. "Detail"

It is used to display details. The single BxNet commands of a telegram are broken down and displayed in the BxNetView window. _edit.Brain picks up the information from the Gx database in the application folder under the BxNet folder. It is used to find special (full text search). The results are displayed in the output window. The selected line is displayed as hexadecimal value. Copy to notepad: Telegrams can be copied to the notepad for further processing in other programs or a better overview. The selected lines or the complete telegram with mixed or separated header/data can be copied. Selected lines will be hidden to get a better overview of the document. Hidden lines will be displayed again. It is used to set font types.

"Find" "Hexcode" "Copy to Notepad"

"Invisible Row(s)" "Visible Row(s)" "Fonts"

After opening the *.log files, the following features are available. "Detail"

"Copy to Notepad"

"Invisible Row(s)" "Visible Row(s)" "Decrypt line" "Syntax validation"

It is used to display details. The single BxNet commands of a telegram are broken down and displayed in the BxNetView window. _edit.Brain picks up the information from the Gx database in the application folder under the BxNet folder. Copy to notepad: Telegrams can be copied to the notepad for further processing in other programs or a better overview. The selected lines or the complete telegram with mixed or separated header/data can be copied. Selected lines will be hidden to get a better overview of the document. Hidden lines will be displayed again. This menu point contains raw hex data as saved in the file. Only one telegram is displayed at a time. It is used to the syntax of the entire IX command.

To avoid error messages, all commands from the first to the last command of an IX string have to be selected. "Fonts"

38.026.297.001 en

It is used to set font types.

131

15

LogPathConfig

Operating instructions _connect.BRAIN

16

LogPathConfig

16.1

Overview

LogPathConfig is used to modify the log file standard directory or to delete entries. Then all components write the related log files in the specified directory.

16.2

Program structure

Illustration 27: LogPathConfig interface In addition to typical Windows elements, the interface contains a display area with the paths to the program registry entry and to the log file storage location.

16.3

16

Menu bar and toolbar functions

"Return to default log path"

Settings are reset to predefined path.

"Set custom logpath"

A window containing the Window directory tree for selecting the storage location appears.

"Delete logfiles ..."

Log files can be deleted using a filter criteria.

"Open Folder"

The specified storage folder is opened.

16.4

Deleting log files

To delete selected log files, proceed as follows: Call up filter mask via Delete log files ....

132

38.026.297.001 en

Operating instructions _connect.BRAIN

LogPathConfig

Select date. Enter extension. The extension (zip, log, commlog, etc.) can be displayed as list, separated by semicolon. The "Use recycle bin" checkbox allows to specify whether the Windows trash shall be used when deleting files. Confirm input with . Answer the following security query with or .

Illustration 28: Deleting filter mask log files

16

38.026.297.001 en

133

Background information

Operating instructions _connect.BRAIN

17

Background information

17.1

Device families

The Bizerba syntax distinguishes between the following device families: CX: GX: IX: LW: SX: FX: MX:

Checkweigher (CWE, CWM, ...) Labeler (GLM-I, GLM-E, GLP, ...) Industrial devices (WM, CWL Eco, ST, ...) Retail scales (SC, SW, ...) Software (PSS, WinCis Count, ...) Other devices (scanner, terminal, ...) Inspection systems (BVS - Bizerba Vision System, …) The CX family is based on the GX family. The CX device settings correspond to those of the GX devices and are not managed separately in _connectBRAIN. Thus, the CX device are found in _connectBRAIN under the GX device family.

17.2

BxNet language

BxNet is the generic term used for the interface languages GxNet and IxNet that alllow data exchange with Bizerba devices. BxNet is unique within the language group and therefore version-independent. The language scope is upgraded with each new function in the devices. BxNet depends on the physical interface used and on the conversion type. A data record in BxNet consists of one or more subfunction identifiers with the relevant data. The languages belonging to BxNet have the same structure, but distinguish themselves by the subfunction identifiers related to the respective device group.

17

GxNet GxNet language is used in labelers for both communication between the internal device components and for communication with other devices in the system group. Via EDP connection, communication with each individual device is possible. IxNet IxNet language is adapted to the requirements of industrial devices. Industrial devices do not use IxNet language internally, but solely as an interface language. _connect.BRAIN converts IxNet commands in ASCII commands for industrial devices that do not know the IxNet language.

134

38.026.297.001 en

Operating instructions _connect.BRAIN

17.2.1

Background information

Telegram structure

Commands and data are transmitted to a device as ASCII text in BxNet telegram format. There are two different formats available in _connectServer and/or _connectControl: – –

Header and data separated (e.g. Send() method) Header and data together (e.g. SendOne() method)

Header (commands): Data ( data):

Header structure Language area Command type BxNet command

17.2.2

A header can be composed of one or more commands. In case of more commands, these are separated by separators ("|"). The data includes the data associated with the data description. They are also separated by separators ("|").

1 character (A or I) 1 character (! or?) 1..n BxNet command

Coding of the data description

Data description is coded for read or write access. To achieve backward compatibility with the GxTools, there is an old and a new header format for data description. Assign the header format to be used to a device in _connectConfig, see page 46. current: Gx/Ix-Net(A!, I!, A?, I?), for labelers and industrial devices The 1st character of the header stands for the device, the 2nd character for the type of access: A! A? I! I?

Write access for labelers Read access for labelers Write access for industrial devices Read access for industrial devices

17

old: Gx-Net (!,?), only for labelers (GxTools format) The 1st character of the header defines the type of access: ! ?

38.026.297.001 en

Write access Read access

135

Background information

17.2.3

Operating instructions _connect.BRAIN

BxNet data types

The BxNet language s the following command file types: Identification Description

Number of parameters

X

Command without data 0 (no data element available)

W

Word, 16 bit with sign

1

L

Long, 32 bit with sign

1

D

Dimensional value

1 (3 subparameters)

V

Variable

0 (variable sequences are always terminates with the LX02 command.)

T

Text

1

17.2.4

Coding of the useful data

The data are displayed in readable form: – –

Numeric data in decimal notation Texts as ASCII character string

Exceptions: –

–

17 –

136

The first 32 characters of the ASCII character table (hexadecimal numeration <= 1FHEX) are control characters. They are represented in hexadecimal form. For identification, they are preceded by the escape character @. Example: LF becomes @0A. The same is valid for the 127th character of the ASCII character table (hexadecimal numeration >= 7FHEX). These characters are treated as control characters. They are also represented in hexadecimal form and preceded by the escape character @. The characters "@" and "|" are treated as control characters because they can occur within a text and be used as escape characters or separators. Example: [email protected] becomes [email protected]

38.026.297.001 en

Operating instructions _connect.BRAIN

17.2.5

Background information

Dimensionful data:

Dimensionful data consists of a unit, the number of decimal places and a related integer. These three values are separated by semicolon ";". Design Parameters

Description

1

Unit

2

Number of decimal places

3

Integer

17.2.6

Coding of prices

Coding of prices varies according to the set header format. current: Gx/Ix-Net(A!, I!, A?, I?), for labelers and industrial devices A price consists of the abbreviation for the local currency, the country-specific number of decimal places and the value of the price. The value is always coded as an integer. To determine the price, the value is multiplied by a power of ten of the decimal places. Example: Price

Coding

19,90 €

EUR;-2;1990

12,99 €

USD;-2;1299

old: Gx-Net (!,?), only for labelers (GxTools format) A price consists of the country code and the price value. The value is always coded as an integer. The country code contains the currency and the country-specific number of decimal places. To determine the price, the value is multiplied by a power of ten of the decimal places. Example: Price

Coding

19,90 €

6|1990

12,99 $

64|1299

Country codes used: – –

6: EUR, 2 decimal places 64: USD, 2 decimal places

38.026.297.001 en

137

17

Background information

17.2.7

Operating instructions _connect.BRAIN

Coding of weights

A weight value consists of 3 parts: – – –

Weight unit (KG, LB, lb, OZ, %) Exponent for the decimal places (0, -1, -2, -3, -4) Weight value as integer

current: Gx/Ix-Net(A!, I!, A?, I?), for labelers and industrial devices Example: Weight

Coding

2,995 kg

KG;-3;2995

45,93 kg

KG;-2;4593

old: Gx-Net (!,?), only for labelers (GxTools format) Example: Weight

Coding

2.995 kg

KG|-3|2995

45.93 kg

KG|-2|4593

17

138

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

18

Program interfaces

18.1

_connectServer DCOM communication interface

The _connectServer DCOM communication interface provides functions for communication among _connectServer and client. The properties, methods and events are described below.

18

38.026.297.001 en

139

Program interfaces

18.1.1

Operating instructions _connect.BRAIN

Methods

Close It closes the connection to the connected device. If the Open method has not been carried out, Close reports an error. Syntax and parameter C++ HRESULT Close ()

C# int Close ()

no parameters

CreateReceiveQueue It generates a reception queue. Then one or more filters can be created for the reception queue using the SetReceiveFilterQueue method. Data can only be received after at least one filter has been created for the reception queue. Syntax and parameter C++ HRESULT CreateReceiveQueue ([out] BSTR *szQueueName)

C# int CreateReceiveQueue (out String szQueueName)

Parameters

Value

Description

szQueueName

Character string

Queue name generated by _connectServer

18

140

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

DeleteReceiveQueue It deletes a reception queue. If there is not any reception queue with the indicated name in the system, an error is triggered. Syntax and parameter C++ HRESULT DeleteReceiveQueue ([in] BSTR szQueueName)

C# int DeleteReceiveQueue (string szQueueName)

Parameters

Value

Description

szQueueName

Character string.

Name of the queue to be deleted.

Error It provides the error number, the system number and the error text. Syntax and parameter C++ HRESULT Error ([out] long *lErrNr, [out] long *lSystemNr, [out] BSTR *szErrTxt)

C# void Error (out int lErrNr, out int lSystemNr, out string szErrTxt)

Parameters

value

Description

lErrNr

Numeric data

Error number

lSystemNr

Numeric data

Number of the system that has triggered the error.

szErrTxt

Character string

Error text in the set language

18

38.026.297.001 en

141

Program interfaces

Operating instructions _connect.BRAIN

ErrorHeaderData It provides the error number, the system number, the error text and the related data. Syntax and parameter C++ HRESULT ErrorHeaderData ([out] long *lErrNr, [out] long *lSystemNr, [out] BSTR *szErrTxt, [out] BSTR *szErrHeader, [out] BSTR *szErrData)

C# void ErrorHeaderData (out int lErrNr, out int lSystemNr, out string szErrTxt, out string szErrHeader, out string szErrData)

Parameters

value

Description

lErrNr

Numeric data

Error number

lSystemNr

Numeric data

Number of the system that has triggered the error.

szErrTxt

Character string

Error text in the set language

szErrHeader

Character string

Header of the error data record. This value is only indicated when the device (e.g. GLP) transmits an error data record.

szErrData

Character string

Data portion of the error data record. This value is only indicated when the device (e.g. GLP) transmits an error data record.

GetBCSVersion It provides the version name of _connectServer (BCS).

18

Syntax and parameter C++ HRESULT GetBCSVersion ([out] BSTR *szVersion)

C# int GetBCSVersion (out string szVersion)

Parameters

Value

Description

szVersion

Character string

_connectServer version name

142

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetCategory It provides the number of the device family the open system is related to. Syntax and parameter C++ HRESULT GetCategory ([out] short *nCategory)

C# int GetCategory (out short nCategory)

Parameters

Value

Description

nCategory

1:

basic systems

Device family number

2:

labeler / printer

3:

retail scales

4:

industrial devices

5:

external devices

6:

WinCWS

7:

industry special

18

38.026.297.001 en

143

Program interfaces

Operating instructions _connect.BRAIN

Open It opens access to a device via _connectServer. Syntax and parameter C++ HRESULT Open ([in] BSTR szIdent, [in] BSTR szDeviceName, [in] short nTelegramType, [in] short nAccess, [in] short bLightLicenceEnable)

C# int Open (string szIdent, string szDeviceName, short nTelegramType, short nAccess, short bLightLicenceEnable)

Parameters

Value

szIdent

Any character string name for allocation of errors that occur.

szDeviceName

Name of an active device (character string)

nTelegramType

0:

normal

nAccess

0:

multiple access

1:

single access

0:

full version

18 bLightLicenceEnable

Description

Name of the system to be opened. This name is defined in _connectConfig. All active systems can be queried via the information interface.

Specifies whether the device shall transmit spontaneous telegrams to 1: spontaneous telethe client. Spontaneous telegrams grams can only be sent to a client. Telegram duplication is not ed. If a client is opened for spontaneous telegrams, the attempt to open more clients for spontaneous telegrams causes an error message. However, the interface can be opened normally. Device access type. In the event of single access, only one client communicates with the device, in the event of multiple access, more clients communicate with the device. Licensing mechanism

1:

light version (Bizerba software)

144

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

Receive It provides reception data (header and data) and the transmission status. It requires the handle from the Send method. If the Open method has not been carried out, Receive reports an error. Syntax and parameter C++ HRESULT Receive ([out] BSTR *szHeader, [out] BSTR *szData, [in] BSTR szHandle, [in] long lTimeout, [out] long *lStatus)

C# int Receive (out string szHeader, out string szData, string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle that is returned from the method.

Send lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

38.026.297.001 en

145

Program interfaces

Operating instructions _connect.BRAIN

ReceiveAuthorizationRequest It provides a license code which is used by the client to generate a response. The client inserts the calculated license code in the SendAuthorizationResponse method. This method is only used by the Bizerba software. If the Open method has not been carried out, ReceiveAuthorizationRequest reports an error. Syntax and parameter C++ HRESULT ReceiveAuthorizationRequest ([out] BSTR *szLizenzKey)

C# int ReceiveAuthorizationRequest (ref string szLizenzKey)

Parameters

Value

Description

szLizenzKey

Character string

License code generated by _connectServer

18

146

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ReceiveOne It provides reception data (header and data combined) and the transmission status. It requires the handle from the Send method. If the Open method has not been carried out, ReceiveOne reports an error. Syntax and parameter C++ HRESULT ReceiveOne ([out] BSTR *szHeaderData, [in] BSTR szHandle, [in] long lTimeout, [out] long *lStatus)

C# int ReceiveOne (out string szHeaderData, string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHeaderData

Character string

Combination of header and data

szHandle

Character string

Handle that is returned from the method.

Send lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The transmission order remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

38.026.297.001 en

147

Program interfaces

Operating instructions _connect.BRAIN

ReceiveOneWithoutAck It receives spontaneous telegrams without direct acknowledgement. When using this method, the customer application can delay the transmission of the acknowledgement and transmit data (e.g. lock) to the labeler prior to transmitting the acknowledgement. The acknowledgement is separately transmitted using the SendAcknowledge method. The ReceiveOneWithoutAck method can only be used for spontaneous data. The customer application has to acknowledge the data record with SendAcknowledge so that a GLP proceeds after a lock. Syntax and parameter C++ HRESULT ReceiveOneWithoutAck ([out] BSTR *szHeaderData, [in] BSTR szHandle, [in] long lTimeout, [out] long *lStatus)

C# int ReceiveOneWithoutAck (out string szHeaderData, string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHeaderData

Character string

Header data (data description)

szHandle

Character string

Handle for spontaneous data (DUSTBIN or created queue). Spontaneous data deriving from the device without related queue is automatically allocated to a DUSTBIN queue. They can be picked up using the DUSTBIN handle.

lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The transmission order remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

18

2: more data available

148

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ReceiveWithoutAck It receives spontaneous telegrams without direct acknowledgement. When using this method, the customer application can delay the transmission of the acknowledgement and transmit data (e.g. lock) to the labeler prior to transmitting the acknowledgement. The acknowledgement is separately transmitted using the SendAcknowledge method. The ReceiveWithoutAck method can only be used for spontaneous data. The customer application has to acknowledge the data record with SendAcknowledge so that a GLP proceeds after a lock. Syntax and parameter C++ HRESULT ReceiveWithoutAck ([out] BSTR *szHeader, [out] BSTR *szData, [in] BSTR szHandle, [in] long lTimeout, [out] long *lStatus)

C# int ReceiveWithoutAck (out string szHeader, out string szData, string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle for spontaneous data (DUSTBIN or created queue).

lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The transmission order remains in the transmission list.

lStatus

0:

function OK

1:

timeout

Transmission status

2: more data available

38.026.297.001 en

149

18

Program interfaces

Operating instructions _connect.BRAIN

Reset It cancels the current send request. If a send request is not cancelled, it remains active until transmission is completed. Thus, it is impossible to start a new send request. Use Reset to cancel the send request from the _connectServer transmission list. If the data record has already been sent to the device before Reset and the device continues responding after Reset, the response is identified as spontaneous data record and made available because the corresponding send request no longer exists. Syntax and parameter C++ HRESULT Reset ([in] BSTR szHandle)

C# int Reset (string szHandle)

Parameters

Value

szHandle

Character string

Description Handle that is returned from the method.

Send

18

150

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

Send It sends data to the connected evaluation unit. If the Open method has not been carried out, Send reports an error. Syntax and parameter C++ HRESULT Send ([in] BSTR szHeader, [in] BSTR szData, [out] BSTR *szHandle, [in] long lTimeout, [out] long *lStatus)

C# int Send (string szHeader, string szData, out string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle generated by _connectServer. It has to be specified in the Receive method to provide the client with the relevant data.

lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

38.026.297.001 en

151

Program interfaces

Operating instructions _connect.BRAIN

SendAcknowledge It closes the ReceiveWithoutAck method with a positive acknowledgement. Syntax and parameter C++ HRESULT SendAcknowledge ([in] BSTR szHandle)

C# int SendAcknowledge (string szHandle)

Parameters

Value

szHandle

Character string

Description Handle used in the ReceiveWimethod.

thoutAck

SendAcknowledgeNeg It closes the ReceiveWithoutAck method with a negative acknowledgement. Transmits an error message to the device. Syntax and parameter C++ HRESULT SendAcknowledgeNeg ([in] BSTR szHandle, [in] long lError, [in] BSTR szErrTxt)

C# int SendAcknowledgeNeg (string szHandle, int lError, string szErrTxt)

Parameters

Value

szHandle

Character string

Description Handle used in the ReceiveWimethod.

thoutAck lError

Numeric data

Error number to be sent to the device

szErrTxt

Character string

Error text to be sent to the device

18

152

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

SendAuthorizationResponse It compares the license code calculated by the client with the license code transmitted by _connectServer via ReceiveAuthorizationRequest. This method is only used by the Bizerba software. In case of noncompliance, an error is reported. If the Open method has not been carried out, SendAuthorizationReponse reports an error. Syntax and parameter C++ HRESULT SendAuthorizationResponse ([in] BSTR szLizenzKey)

C# int SendAuthorizationResponse (string szLizenzKey)

Parameters

Value

Description

szLizenzKey

Character string

License code calculated by the client

SendCheck It verifies whether data is available, the command has been completely processed or transmitted, and a positive or negative acknowledgement has been received. Syntax and parameter C++ HRESULT SendCheck ([in] BSTR szHandle, [in] long lTimeout, [out] long *lStatus)

C# int SendCheck (string szHandle, int lTimeout, out int lStatus)

Parameters

Value

szHandle

Character string

Description Handle that is returned from the method.

Send lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

38.026.297.001 en

153

18

Program interfaces

Operating instructions _connect.BRAIN

SendOne It sends data to the connected evaluation unit. If the Open method has not been carried out, Send reports an error. Syntax and parameter C++ HRESULT SendOne ([in] BSTR szHeader Data, [out] BSTR *szHandle, [in] long lTimeout, [out] long *lStatus)

C# int SendOne (string szHeader Data, out string szHandle, int lTimeout, out int lStatus)

Parameters

Value

Description

szHandle

Character string

Handle generated by _connectServer. It has to be specified in the Receive method to provide the client with the relevant data.

lTimeout

Numeric data

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

154

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

SetReceiveQueueFilter It sets a filter for reception data. The filter is required to receive data by means of customer-specific reception queues that have been created using the CreateReceiveQueue method. Without filters, spontaneous data is automatically assigned to the DUSTBIN reception queue. Example for a GX: Use CreateReceiveQueue to create an individual queue for package data records starting with PV05. To allocate the package data records to a method, call up the SetReceiveQueueFilter method using the queue name and the PV05 filter parameter. If data records, e.g. starting with PV05 or PV06, are to be allocated to the same queue, call up the SetReceiveQueueFilter method two times. Specify the same queue both times and use the PV05 filter parameter at one time and the PV06 filter parameter the other time. Syntax and parameter C++ HRESULT SetReceiveQueueFilter ([in] BSTR szQueueName, [in] BSTR szFilter)

C# int SetReceiveQueueFilter (string szQueueName, string szFilter)

Parameters

Value

Description

szQueueName

Character string

Queue name generated by _connectServer The CreateReceiveQueue method returns this name.

szFilter

Character string

Filter parameter, e.g. PV05 for a GX.

18

38.026.297.001 en

155

Program interfaces

18.1.2

Operating instructions _connect.BRAIN

Events

DataArrival It indicates reception of spontaneous telegrams and transmits the identification of the communication channel (handle) which can be used for receiving data via the Receive, ReceiveWithoutAck, ReceiveOneWithoutAck or ReceiveOne method. Syntax and parameter C++ long DataArrival(BSTR szQueueName)

C# int DataArrival(string szQueueName)

Parameters

Value

Description

szQueueName

Character string

Identification of communication channel (handle) This handle has to be transferred in the reception method (e.g. Receive) in order to access data.

RemoteDataArrival It answers a send request with a ?, A? or I? header. Transmits the identification of the communication channel (handle) which can be used for receiving data via the Receive or ReceiveOne method. The ReceiveWithoutAck and ReceiveOneWithoutAck methods are only to be used for receiving spontaneous data and must not be used in connection with the RemoteDataArrival event.

18

Syntax and parameter C++ long RemoteDataArrival(BSTR szQueueName)

C# int RemoteDataArrival(string szQueueName)

Parameters

Value

Description

szQueueName

Character string

Identification of communication channel (handle) This handle has to be transferred in the Receive or ReceiveOne method in order to access data.

156

38.026.297.001 en

Operating instructions _connect.BRAIN

18.2

Program interfaces

_connectServer DCOM information interface

The _connectServer DCOM information interface supplies all information on _connect.BRAIN and on the devices that have been created and activated in _connectConfig. The available methods are described in the following paragraphs.

18

38.026.297.001 en

157

Program interfaces

18.2.1

Operating instructions _connect.BRAIN

Methods

Error It reports an error message after failure of a previous action. Even if the Open method has not been carried out, Error reports an error. Syntax and parameter C++ HRESULT Error ([out] long *lErrNr, [out] long *lSystemNr, [out] BSTR *szErrTxt)

C# void Error (out int lErrNr, out int lSystemNr, out string szErrTxt)

Parameters

Value

Description

lErrNr

Number

Error number

szErrTxt

Character string

Error text in the set language

GetBCSVersion It provides the version name of _connectServer (BCS). If the Open method has not been carried out, GetBCSVersion reports an error. Syntax and parameter C++ HRESULT GetBCSVersion ([out] BSTR *szVersion)

C# int GetBCSVersion (out string szVersion)

18

Parameters

Value

Description

szVersion

Character string

_connectServer version name

158

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetDemo It verifies whether _connect.BRAIN is used with license or in the developer mode. Syntax and parameter C++ HRESULT GetDemo ([out] BOOL *bDemo)

C# int GetDemo (out int bDemo)

Parameters

Value

Description

bDemo

0: false, normal op- Normal operation or developer eration with licenses mode 1: true, developer mode

18

38.026.297.001 en

159

Program interfaces

Operating instructions _connect.BRAIN

GetDevice It returns all active systems defined in the configuration. If the Open method has not been carried out, GetDevice reports an error. Syntax and parameter C++ HRESULT GetDevice ([out] BSTR *szDeviceString, [out] long *lCount)

C# int GetDevice (out string szDeviceString, out int lCount)

Parameters

Value

szDeviceString

SECT01

name

Description = section

Example:

= two relaszDeviceString=SECT01|SYSTEM1| ted values follow PARA02|name|bizerbaScale1| name = device name PARA02|devCategory|2|PARA02| PARA02

devCategory

table 1

devType

2

= see table

devicestate

table 3

lCount

Number

= see

= see

devType|19|PARA02|devicestate| 0|

puts out: SYSTEM1 bizerbaScale1 2 19 Number of active systems

Table 1: Possible values for devCategory

18

1:

basic systems

2:

labeler / printer

3:

retail scales

4:

industrial devices

5:

external devices

7:

industry special

160

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

Table 2: Possible values for devType 0:

not defined

12:

BT

34:

WM

1:

GD

14:

ITE

35:

GLM-I

2:

GH

15:

ITS

36:

CWM

3:

GV

16:

ITL

37:

CWE

4:

GS

17:

MCI

38:

ITCS

5:

Scanner

18:

MCE

39:

CWL Eco

6:

Terminal

19:

GLP

40:

GLF

7:

ST

20:

Empty

41:

GLM-E

8:

ITU

21:

HW

42:

GLM-B

9:

ITC1

22:

PSS

43:

GLM-P

10:

ITC2

26:

NTScale

44:

GLM-L

11:

EL

30:

Addidata I/O card

45:

GLM-E Retail

Table 3: Possible values for devicestate 0:

active

1:

inactive

GetDeviceDCOM It returns the devices connected to a remote PC. Syntax and parameter C++ HRESULT GetDeviceDCOM ([out] BSTR *szDevice, [out] long *lCount, BSTR szDComPC)

C#

18

int GetDeviceDCOM (out string szDevice, out int lCount, string szDComPC)

Parameters

Value

szDeviceString

see GetDevice

lCount

see GetDevice

szDComPC

Character string

38.026.297.001 en

Description

Remote PC name

161

Program interfaces

Operating instructions _connect.BRAIN

GetLicenseCountForSpecificLicense This method is used to determine the number of available licenses of the specified license type. Syntax and parameter C++ HRESULT GetLicenseCountForSpecificLicense([in] long licenseType, [out] long *licenseCount)

C# int GetLicenseCountForSpecificLicense(int licenseType, out int licenseCount)

Parameters

Value

licenseType

License type:

Description

1: BCS_LICENSE_TYPE_DEVICE_CX 2: BCS_LICENSE_TYPE_DEVICE_GX 3: BCS_LICENSE_TYPE_DEVICE_IX 4: BCS_LICENSE_TYPE_DEVICE_BRAIN 5: BCS_LICENSE_TYPE_VS 6: BCS_LICENSE_TYPE_INTERFACE_2FILE 7: BCS_LICENSE_TYPE_INTERFACE_2DB 8: BCS_LICENSE_TYPE_INTERFACE_2SAP 9: BCS_LICENSE_TYPE_DEVICE_MX licenseCount

18

Number

Number of available licenses of the specified license type on the license server The value 9999 means that it is a bit license and not a counter license.

GetLicenseExpirationDateForProductVersion This method checks the expiry date of time-limited licenses. After expiring, the license is no longer available and the function cannot be used in _connect.BRAIN any longer. Syntax and parameter C++ HRESULT GetLicenseExpirationDateForProductVersion([out] DATE *date)

C# int GetLicenseExpirationDateForProductVersion(out system.DateTime date)

Parameters

Value

Description

date

Date

Date when license expires

162

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetLicenseExpirationDateForSpecificLicense This method checks the expiry date of time-limited licenses. After expiring, the license is no longer available and the function cannot be used in _connect.BRAIN any longer. Syntax and parameter C++ HRESULT GetLicenseExpirationDateForSpecificLicense([in] long licenseType, [out] DATE *date)

C# int GetLicenseExpirationDateForSpecificLicense(int licenseType, out system.DateTime date)

Parameters

Value

licenseType

License type:

Description

1: BCS_LICENSE_TYPE_DEVICE_CX 2: BCS_LICENSE_TYPE_DEVICE_GX 3: BCS_LICENSE_TYPE_DEVICE_IX 4: BCS_LICENSE_TYPE_DEVICE_BRAIN 5: BCS_LICENSE_TYPE_VS 6: BCS_LICENSE_TYPE_INTERFACE_2FILE 7: BCS_LICENSE_TYPE_INTERFACE_2DB 8: BCS_LICENSE_TYPE_INTERFACE_2SAP 9: BCS_LICENSE_TYPE_DEVICE_MX date

Date

Date when license expires

GetLicenseInformations This method finds out information about the licensing system currently used, e.g. version number and license server name. The information is generated as xml structure. Syntax and parameter C++ HRESULT GetLicenseInformations([out] BSTR *xmlLicensingInformations)

C# int GetLicenseInformations(out string xmlLicensingInformations)

Parameters

Value

Description

xmlLicensingInformations

Character string

XML data

38.026.297.001 en

163

18

Program interfaces

Operating instructions _connect.BRAIN

GetLicenseNameForProductVersion This method returns the license required by the installed _connect.BRAIN. The result can be used to whether the required license is available on the license server. If the license is missing, _connect.BRAIN cannot be used any longer. Syntax and parameter C++ HRESULT GetLicenseNameForProductVersion([out] BSTR *licenseProductVersion)

C# int GetLicenseNameForProductVersion(out string licenseProductVersion)

Parameters

Value

Description

licenseProductVersion

Character string

Name of the required license, e.g. IS_connect_V30. The product cannot be executed without this license.

GetLicenseSystemName The method identifies the licensing system currently used (up to now BSP only). Syntax and parameter C++ HRESULT GetLicenseSystemName([out] BSTR *licensingSystemName)

C# int GetLicenseSystemName(out string licensingSystemName)

Parameters

Value

Description

licensingSystemName

Character string

Name of the current licensing system, BSP character string at the moment

18

164

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetSerialNumber It returns the _connectServer serial number. If the Open method has not been carried out, GetSerial Number reports an error. Syntax and parameter C++ HRESULT GetSerialNumber ([out] BSTR *szSerialNumber)

C# int GetSerialNumber (out string zSerialNumber)

Parameters

Value

Description

szSerialNumber

Character string

_connectServerserial number

Open To allow access to the functions of the _connect.BRAIN DCOM interface, the interface has to be opened using the Open method. A name is specified to facilitate trouble shooting. Syntax and parameter C++ HRESULT Open ([in] BSTR szIdent)

C# int Open (string szIdent)

Parameters

Value

szIdent

Any character string name for allocation of errors that occur.

18.3

Description

18

_connectControl DCOM communication interface

The _connectControl DCOM communication interface uses the ActiveX control element BCC.OCX to exchange data among client and _connectServer. The properties, methods and events are described below.

38.026.297.001 en

165

Program interfaces

18.3.1

Operating instructions _connect.BRAIN

Properties

Version It supplies the BCC.OCX version ID code. Syntax C++ BSTR Version

C# string Version

18

166

38.026.297.001 en

Operating instructions _connect.BRAIN

18.3.2

Program interfaces

Methods

AboutBox It shows the copyright and _connectServer information. Syntax and parameter C++ void AboutBox()

C# void AboutBox()

no parameters

Close It closes the connection to the connected device. If the Open method has not been carried out, Close reports an error. Syntax and parameter C++ long Close ()

C# int Close ()

no parameters

CreateReceiveQueue It generates a reception queue. Then one or more filters can be created for the reception queue using the SetReceiveFilterQueue method. Data can only be received after at least one filter has been created for the reception queue. Syntax and parameter C++ long CreateReceiveQueue (BSTR *szQueueName)

C# int CreateReceiveQueue (ref string szQueueName)

Parameters

Value

Description

szQueueName

Character string

Queue name generated by _connectServer

38.026.297.001 en

167

18

Program interfaces

Operating instructions _connect.BRAIN

DeleteReceiveQueue It deletes a reception queue. If there is not any reception queue with the indicated name in the system, an error is triggered. Syntax and parameter C++ long DeleteReceiveQueue (BSTR szQueueName)

C# int DeleteReceiveQueue (string szQueueName)

Parameters

Value

Description

szQueueName

Character string

Name of the queue to be deleted.

Error It provides the error number, the system number and the error text. Syntax and parameter C++ void Error (long *nErrNr, long *nSystemNr, BSTR *szErrTxt)

C# void Error (ref int nErrNr, ref int nSystemNr, ref string szErrTxt)

Parameters

Value

Description

nErrNr

Number

Error number

nSystemNr

Number

Number of the system that has triggered the error.

szErrTxt

Character string

Error text in the set language

18

168

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ErrorHeaderData It provides the error number, the system number, the error text and the related data. Syntax and parameter C++ long ErrorHeaderData (long *lErrNr, long *lSystemNr, BSTR *szErrTxt, BSTR *szErrHeader, BSTR *szErrData)

C# void ErrorHeaderData (ref int lErrNr, ref int lSystemNr, ref string szErrTxt, ref string szErrHeader, ref string szErrData)

Parameters

Value

Description

IErrNr

Number

Error number

ISystemNr

Number

Number of the system that has triggered the error.

szErrTxt

Character string

Error text in the set language

szErrHeader

Character string

Header of the error data record. This value is only indicated when the device (e.g. GLP) transmits an error data record.

szErrData

Character string

Data portion of the error data record. This value is only indicated when the device (e.g. GLP) transmits an error data record.

GetBCSVersion It provides the version name of _connectServer (BCS). Syntax and parameter

18

C++ long GetBCSVersion (BSTR *szVersion)

C# int GetBCSVersion (ref string szVersion)

Parameters

Value

Description

szVersion

Character string

_connectServer version name

38.026.297.001 en

169

Program interfaces

Operating instructions _connect.BRAIN

GetCategory It provides the number of the device family the open system is related to. Syntax and parameter C++ long GetCategory (short *nCategory)

C# int GetCategory (ref short nCategory)

Parameters

Value

Description

nCategory

1:

basic systems

Device family number

2:

labeler / printer

3:

retail scales

4:

industrial devices

5:

external devices

6:

WinCWS

7:

industry special

GetDemo It verifies whether _connect.BRAIN is used with license or in the developer mode. Syntax and parameter C++ long GetDemo (short *nDemo)

C# int GetDemo (ref short nDemo)

18

Parameters

Value

Description

nDemo

0:

name for allocation of errors that occur Normal operation or developer mode

170

false, normal operation with licenses 1: true, developer mode

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetDevice It returns all active systems defined in the configuration. If the Open method has not been carried out, GetDevice reports an error. Syntax and parameter C++ long GetDevice (BSTR *szDeviceString, long *lCount)

C# int GetDevice (ref string szDeviceString, ref int lCount)

Parameters

Value

szDeviceString

SECT01

name

Description = section

Example:

= two relaszDeviceString=SECT01|SYSTEM1| ted values follow PARA02|name|bizerbaScale1| name = device name PARA02|devCategory|2|PARA02| PARA02

devCategory

table 1

devType

2

= see table

devicestate

table 3

lCount

Number

= see

= see

devType|19|PARA02|devicestate| 0|

puts out: SYSTEM1 bizerbaScale1 2 19 Number of active systems

Table 1: Possible values for devCategory 1:

basic systems

2:

labeler / printer

3:

retail scales

4:

industrial devices

5:

external devices

7:

industry special

38.026.297.001 en

18

171

Program interfaces

Operating instructions _connect.BRAIN

Table 2: Possible values for devType 0:

not defined

12:

BT

34:

WM

1:

GD

14:

ITE

35:

GLM-I

2:

GH

15:

ITS

36:

CWM

3:

GV

16:

ITL

37:

CWE

4:

GS

17:

MCI

38:

ITCS

5:

Scanner

18:

MCE

39:

CWL Eco

6:

Terminal

19:

GLP

40:

GLF

7:

ST

20:

Empty

41:

GLM-E

8:

ITU

21:

HW

42:

GLM-B

9:

ITC1

22:

PSS

43:

GLM-P

10:

ITC2

26:

NTScale

44:

GLM-L

11:

EL

30:

Addidata I/O card

45:

GLM-E Retail

Table 3: Possible values for devicestate 0:

active

1:

inactive

GetDeviceDCOM It returns the devices connected to a remote PC. Syntax and parameter C++ long GetDeviceDCOM (BSTR *szDevice, long *lCount, BSTR szDComPC)

18

C# int GetDeviceDCOM (ref string szDevice, ref int lCount, string szDComPC)

Parameters

Value

szDeviceString

see GetDevice

lCount

see GetDevice

szDComPC

Character string

172

Description

Remote PC name

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetLicenseCountForSpecificLicense This method is used to determine the number of available licenses of the specified license type. Syntax and parameter C++ long GetLicenseCountForSpecificLicense(long licenseType, long *licenseCount)

C# int GetLicenseCountForSpecificLicense(int licenseType, ref int licenseCount)

Parameters

Value

licenseType

License type:

Description

1: BCS_LICENSE_TYPE_DEVICE_CX 2: BCS_LICENSE_TYPE_DEVICE_GX 3: BCS_LICENSE_TYPE_DEVICE_IX 4: BCS_LICENSE_TYPE_DEVICE_BRAIN 5: BCS_LICENSE_TYPE_VS 6: BCS_LICENSE_TYPE_INTERFACE_2FILE 7: BCS_LICENSE_TYPE_INTERFACE_2DB 8: BCS_LICENSE_TYPE_INTERFACE_2SAP 9: BCS_LICENSE_TYPE_DEVICE_MX licenseCount

Number

Number of available licenses of the specified license type on the license server The value 9999 means that it is a bit license and not a counter license.

18

GetLicenseExpirationDateForProductVersion This method checks the expiry date of time-limited licenses. After expiring, the license is no longer available and the function cannot be used in _connect.BRAIN any longer. Syntax and parameter C++ long GetLicenseExpirationDateForProductVersion(DATE *date)

C# int GetLicenseExpirationDateForProductVersion(ref system.DateTime date)

Parameters

Value

Description

date

Date

Date when license expires

38.026.297.001 en

173

Program interfaces

Operating instructions _connect.BRAIN

GetLicenseExpirationDateForSpecificLicense This method checks the expiry date of time-limited licenses. After expiring, the license is no longer available and the function cannot be used in _connect.BRAIN any longer. Syntax and parameter C++ long GetLicenseExpirationDateForSpecificLicense(long licenseType, DATE *date)

C# int GetLicenseExpirationDateForSpecificLicense(int licenseType, ref system.DateTime date)

Parameters

Value

licenseType

License type:

Description

1: BCS_LICENSE_TYPE_DEVICE_CX 2: BCS_LICENSE_TYPE_DEVICE_GX 3: BCS_LICENSE_TYPE_DEVICE_IX 4: BCS_LICENSE_TYPE_DEVICE_BRAIN 5: BCS_LICENSE_TYPE_VS 6: BCS_LICENSE_TYPE_INTERFACE_2FILE 7: BCS_LICENSE_TYPE_INTERFACE_2DB 8: BCS_LICENSE_TYPE_INTERFACE_2SAP 9: BCS_LICENSE_TYPE_DEVICE_MX date

Date

Date when license expires

GetLicenseInformations

18

This method finds out information about the licensing system currently used, e.g. version number and license server name. The information is generated as xml structure. Syntax and parameter C++ long GetLicenseInformations(BSTR *xmlLicensingInformations)

C# int GetLicenseInformations(ref string xmlLicensingInformations)

Parameters

Value

Description

xmlLicensingInformations

Character string

XML data

174

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

GetLicenseNameForProductVersion This method returns the license required by the installed _connect.BRAIN. The result can be used to whether the required license is available on the license server. If the license is missing, _connect.BRAIN cannot be used any longer. Syntax and parameter C++ long GetLicenseNameForProductVersion(BSTR *licenseProductVersion)

C# int GetLicenseNameForProductVersion(ref string licenseProductVersion)

Parameters

Value

Description

licenseProductVersion

Character string

Name of the required license, e.g. IS_connect_V30. The product cannot be executed without this license.

GetLicenseSystemName The method identifies the licensing system currently used (up to now BSP only). Syntax and parameter C++ long GetLicenseSystemName(BSTR *licensingSystemName)

C# int GetLicenseSystemName(ref string licensingSystemName)

Parameters

Value

Description

licensingSystemName

Character string

Name of the current licensing system, BSP character string at the moment

38.026.297.001 en

175

18

Program interfaces

Operating instructions _connect.BRAIN

GetSerialNumber It returns the _connectServer serial number. If the Open method has not been carried out, GetSerial Number reports an error. Syntax and parameter C++ long GetSerialNumber (BSTR *szSerialNumber)

C# int GetSerialNumber (ref string zSerialNumber)

Parameters

Value

Description

szSerialNumber

Character string

_connectServerserial number

18

176

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

Open It opens access to a device via _connectServer. Syntax and parameter C++ long Open (BSTR szIdent, BSTR szDeviceName, short nTelegramType, short nAccess, short bLightLicenceEnable)

C# int Open (string szIdent, string szDeviceName, short nTelegramType, short nAccess, short bLightLicenceEnable)

Parameters

Value

szIdent

Any character string name for allocation of errors that occur.

szDeviceName

Name of an active device (character string)

nTelegramType

0:

normal

nAccess

0:

multiple access

1:

single access

0:

full version

bLightLicenceEnable

Description

Name of the system to be opened. This name is defined in _connectConfig. All active systems can be queried via the information interface.

Specifies whether the device shall transmit spontaneous telegrams to 1: spontaneous telethe client. Spontaneous telegrams grams can only be sent to a client. Telegram duplication is not ed. If a client is opened for spontaneous telegrams, the attempt to open more clients for spontaneous telegrams causes an error message. However, the interface can be opened normally. Device access type. In the event of single access, only one client communicates with the device, in the event of multiple access, more clients communicate with the device. Licensing mechanism

1:

light version (Bizerba software)

38.026.297.001 en

177

18

Program interfaces

Operating instructions _connect.BRAIN

Receive It provides reception data (header and data) and the transmission status. It requires the handle from the Send method. If the Open method has not been carried out, Receive reports an error. Syntax and parameter C++ long Receive (BSTR *szHeader, BSTR *szData, BSTR szHandle, long lTimeout, long *lStatus)

C# int Receive (ref string szHeader, ref string szData, string szHandle, int lTimeout, ref int lStatus)

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle that is returned from the method.

Send lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

178

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ReceiveAuthorizationRequest It provides a license code which is used by the client to generate a response. The client inserts the calculated license code in the SendAuthorizationResponse method. This method is only used by the Bizerba software. If the Open method has not been carried out, ReceiveAuthorizationRequest reports an error. Syntax and parameter C++ long ReceiveAuthorizationRequest (BSTR *szLizenzKey)

C# int ReceiveAuthorizationRequest (ref string szLizenzKey)

Parameters

Value

Description

szLizenzKey

Character string

License code generated by _connectServer

18

38.026.297.001 en

179

Program interfaces

Operating instructions _connect.BRAIN

ReceiveOne It provides reception data (header and data combined) and the transmission status. It requires the handle from the Send method. If the Open method has not been carried out, ReceiveOne reports an error. Syntax and parameter C++ long ReceiveOne (BSTR *szHeaderData, BSTR szHandle, long lTimeout, long *lStatus)

C# int ReceiveOne (ref string szHeaderData, string szHandle, int lTimeout, ref int lStatus)

Parameters

Value

Description

szHeaderData

Character string

Combination of header and data

szHandle

Character string

Handle that is returned from the method.

Send lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

180

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ReceiveOneWithoutAck It receives spontaneous telegrams without direct acknowledgement. When using this method, the customer application can delay the transmission of the acknowledgement and transmit data (e.g. lock) to the labeler prior to transmitting the acknowledgement. The acknowledgement is separately transmitted using the SendAcknowledge method. The ReceiveOneWithoutAck method can only be used for spontaneous data. The customer application has to acknowledge the data record with SendAcknowledge so that a GLP proceeds after a lock. Syntax and parameter C++ long ReceiveOneWithoutAck (BSTR *szHeaderData, BSTR szHandle, long lTimeout, long *lStatus)

C# int ReceiveOneWithoutAck (ref string szHeaderData, string szHandle, int lTimeout, ref int lStatus)

Parameters

Value

Description

szHeaderData

Character string

Header data (data description)

szHandle

Character string

Handle for spontaneous data (DUSTBIN or created queue). Spontaneous data deriving from the device without related queue is automatically allocated to a DUSTBIN queue. They can be picked up using the DUSTBIN handle.

lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

1:

timeout

Transmission status

2:

more data available

38.026.297.001 en

181

18

Program interfaces

Operating instructions _connect.BRAIN

ReceiveWithoutAck It receives spontaneous telegrams without direct acknowledgement. When using this method, the customer application can delay the transmission of the acknowledgement and transmit data (e.g. lock) to the labeler prior to transmitting the acknowledgement. The acknowledgement is separately transmitted using the SendAcknowledge method. The ReceiveWithoutAck method can only be used for spontaneous data. The customer application has to acknowledge the data record with SendAcknowledge so that a GLP proceeds after a lock. Syntax and parameter C++ long ReceiveWithoutAck (BSTR *szHeader, BSTR *szData, BSTR szHandle, long lTimeout, long *lStatus)

C# int ReceiveWithoutAck (ref string szHeader, ref string szData, string szHandle, int lTimeout, ref int lStatus)

18

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle for spontaneous data (DUSTBIN or created queue).

lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

182

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

Reset It cancels the current send request. If a send request is not cancelled, it remains active until transmission is completed. Thus, it is impossible to start a new send request. Use Reset to cancel the send request from the _connectServer transmission list. If the data record has already been sent to the device before Reset and the device continues responding after Reset, the response is identified as spontaneous data record and made available because the corresponding send request no longer exists. Syntax and parameter C++ long Reset (BSTR szHandle)

C# int Reset (string szHandle)

Parameters

Value

szHandle

Character string

Description Handle that is returned from the method.

Send

18

38.026.297.001 en

183

Program interfaces

Operating instructions _connect.BRAIN

Send It sends data to the connected evaluation unit. If the Open method has not been carried out, Send reports an error. Syntax and parameter C++ long Send (BSTR szHeader, BSTR szData, BSTR *szHandle, long lTimeout, long *lStatus)

C# int Send (string szHeader, string szData, ref string szHandle, int lTimeout, ref int lStatus)

Parameters

Value

Description

szHeader

Character string

Header data (data description)

szData

Character string

data

szHandle

Character string

Handle generated by _connectServer. It has to be specified in the Receive method to provide the client with the relevant data.

lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

184

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

SendAcknowledge It closes the ReceiveWithoutAck method with a positive acknowledgement. Syntax and parameter C++ long SendAcknowledge (BSTR szHandle)

C# int SendAcknowledge (string szHandle)

Parameters

Value

szHandle

Character string

Description Handle used in the ReceiveWimethod.

thoutAck

SendAcknowledgeNeg It closes the ReceiveWithoutAck method with a negative acknowledgement. Transmits an error message to the device. Syntax and parameter C++ long SendAcknowledgeNeg (BSTR szHandle, long lError, BSTR szErrTxt)

C# int SendAcknowledgeNeg (string szHandle, int lError, string szErrTxt)

Parameters

Value

szHandle

Character string

Description Handle used in the ReceiveWimethod.

thoutAck lError

Number

Error number to be sent to the device

szErrTxt

Character string

Error text to be sent to the device

38.026.297.001 en

185

18

Program interfaces

Operating instructions _connect.BRAIN

SendAuthorizationResponse It compares the license code calculated by the client with the license code transmitted by _connectServer via ReceiveAuthorizationRequest. This method is only used by the Bizerba software. In case of noncompliance, an error is reported. If the Open method has not been carried out, SendAuthorizationReponse reports an error. Syntax and parameter C++ long SendAuthorizationResponse (BSTR szLizenzKey)

C# int SendAuthorizationResponse (string szLizenzKey)

Parameters

Value

Description

szLizenzKey

Character string

License code calculated by the client

SendCheck It verifies whether data is available, the command has been completely processed or transmitted, and a positive or negative acknowledgement has been received. Syntax and parameter C++ long SendCheck (BSTR szHandle, long lTimeout, long *lStatus)

C# int SendCheck (string szHandle, int lTimeout, ref int lStatus)

18

Parameters

Value

szHandle

Character string

Description Handle that is returned from the method.

Send lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

186

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

SendOne It sends data to the connected evaluation unit. If the Open method has not been carried out, Send reports an error. Syntax and parameter C++ long SendOne (BSTR szHeaderData, BSTR *szHandle, long lTimeout, long *lStatus)

C# int SendOne (string szHeaderData, ref string szHandle, int lTimeout, ref int lStatus)

Parameters

Value

Description

szHandle

Character string

Handle generated by _connectServer. It has to be specified in the Receive method to provide the client with the relevant data.

lTimeout

Number

Period of time during which the method waits for an answer from the device. After the time elapsed, the function will be exited with status 1 (timeout). The send request remains in the transmission list.

lStatus

0:

function OK

Transmission status

1:

timeout

2:

more data available

18

38.026.297.001 en

187

Program interfaces

Operating instructions _connect.BRAIN

SetReceiveQueueFilter It sets a filter for reception data. The filter is required to receive data by means of customer-specific reception queues that have been created using the CreateReceiveQueue method. Without filters, spontaneous data is automatically assigned to the DUSTBIN reception queue. Example for a GX: Use CreateReceiveQueue to create an individual queue for package data records starting with PV05. To allocate the package data records to the method, call up the SetReceiveQueueFilter method with the queue name and the PV05 filter parameter. If data records, e.g. starting with PV05 or PV06, are to be allocated to the same queue, call up the SetReceiveQueueFilter method two times. Specify the same queue both times and use the PV05 filter parameter at one time and the PV06 filter parameter the other time. Syntax and parameter C++ long SetReceiveQueueFilter (BSTR szQueueName, BSTR szFilter)

C# int SetReceiveQueueFilter (string szQueueName, string szFilter)

Parameters

Value

Description

szQueueName

Character string

Queue name generated by _connectServer The CreateReceiveQueue method returns this name.

szFilter

Character string

Filter parameter, e.g. PV05 for a GX.

18

188

38.026.297.001 en

Operating instructions _connect.BRAIN

18.3.3

Program interfaces

Events

BCCDataArrival It indicates reception of spontaneous telegrams and transmits the identification of the communication channel (handle) which can be used for receiving data via the Receive, ReceiveWithoutAck, ReceiveOneWithoutAck or ReceiveOne method. Syntax and parameter C++ void BCCDataArrival(BSTR szHandle)

C++ void BCCDataArrival(string szHandle)

Parameters

Value

Description

szHandle

Character string

Identification of communication channel (handle)

BCCRemoteDataArrival It answers a send request with a ?, A? or I? header. Transmits the identification of the communication channel (handle) which can be used for receiving data via the Receive, ReceiveWithoutAck, ReceiveOneWithoutAck or ReceiveOne method. Syntax and parameter C++ void BCCRemoteDataArrival(BSTR szHandle)

C# void BCCRemoteDataArrival(string szHandle)

Parameters

Value

Description

szHandle

Character string

Identification of communication channel (handle)

38.026.297.001 en

18

189

Program interfaces

Operating instructions _connect.BRAIN

BCCError It indicates the failure of a previous action. Further details are displayed by the error code and text. Syntax and parameter C++ void BCCError(long lErrCode, BSTR szErrTxt)

C# void BCCError(int lErrCode, string szErrTxt)

Parameters

Value

Description

lErrCode

Number

Error code

szErrTxt

Character string

Error text

18.4

BctFunctions

The BctFunctions.dll is a COM-Dll that makes available auxiliary functions for handling Bx telegrams. It includes conversion functions for handling dimensionful values and UTF-8/ Unicode texts as well as parse functions for Bx telegrams in different formats.

18

190

38.026.297.001 en

Operating instructions _connect.BRAIN

18.4.1

Program interfaces

Conversion function

ConvertBxNetToWeight Conversion function that breaks down a Bx dimension value in single components. Syntax and parameter C++ HRESULT ConvertBxNetToWeight([in] BSTR szWeightData, [in] BSTR szWeightDelimiter, [out] BSTR *szWeight, [out] BSTR *szWeightUnit);

C# int ConvertBxNetToWeight(string szWeightData, string szWeightDelimiter, out string szWeight, out string szWeightUnit);

Parameters

Description

szWeightData

Dimension value in Bx format Example: "kg;-3;1234"

szWeightDelimiter

Decimal separator to be used

szWeight

The weight is returned as string with the specified decimal separator.

szWeightUnit

It is used to return the Bx dimension value unit.

Example (C#) string weight, weightUnit; tools.ConvertBxNetToWeight("kg;-3;1234", ".", out weight, out weightUnit); Console.WriteLine(weight + " " + weightUnit); // "1.234 kg"

18

38.026.297.001 en

191

Program interfaces

Operating instructions _connect.BRAIN

ConvertWeightToBxNet Conversion function that creates a Bx dimension value from weight, decimal separator and weight unit. Syntax and parameter C++ HRESULT ConvertWeightToBxNet([in] BSTR szWeight, [in] BSTR szWeightDelimiter, [in] BSTR szWeightUnit, [out] BSTR *szWeightData);

C# int ConvertWeightToBxNet(string szWeight, string szWeightDelimiter, string szWeightUnit, out string szWeightData);

Parameters

Description

szWeight

Weight as string with decimal separator Example: "1.234 kg".

szWeightDelimiter

Decimal separator used in szWeight. Example: ","

szWeightUnit

Weight unit used in szWeight. Example: "kg"

szWeightData

Dimension values are returned in Bx format. Example: "kg;-3;1234"

Example (C#) string weight.Data; tools.ConvertWeightToBxNet("1.234", ".", "kg", out weightData); Console.WriteLine(weightData); // "kg;-3;1234"

18

192

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ConvertTextUnicodeToBxNetUTF8 Function that converts a Unicode string in UTF-8. Characters that cannot be represented in ASCII format are coded according to Bx rules. Syntax and parameter C++ HRESULT ConvertTextUnicodeToBxNetUTF8([in] BSTR szUnicodeText, [out] BSTR *szBxNetUTF8Text);

C# int ConvertTextUnicodeToBxNetUTF8(string szUnicodeText, out string szBxNetUTF8Text);

Parameters

Description

szUnicodeText

Unicode string

szBxNetUTF8Text

An entered string is returned as UTF-8 text that is coded according to Bx rules for texts.

Example (C#) string utf8; tools.ConvertTextUnicodeToBxNetUTF8("fünf €", out utf8); Console.WriteLine(utf8); // "f@C3@BCnf @E2@82@AC"

ConvertTextBxNetUTF8ToUnicode Function that converts a UTF-8 string in Unicode. The input string must be coded according to the Bx rules. Syntax and parameter C++ HRESULT ConvertTextBxNetUTF8ToUnicode([in] BSTR szBxNetUTF8Text, [out] BSTR *szUnicodeText);

18

C# int ConvertTextBxNetUTF8ToUnicode(string szBxNetUTF8Text, out string szUnicodeText);

Parameters

Description

szBxNetUTF8Text

UTF-8 string coded according to Bx rules for texts

szUnicodeText

Return of decoded Unicode string

Example (C#) string unicode; tools.ConvertTextBxNetUTF8ToUnicode("f@C3@BCnf @E2@82@AC", out unicode); Console.WriteLine(unicode); // "fünf €"

38.026.297.001 en

193

Program interfaces

18.4.2

Operating instructions _connect.BRAIN

Parse functions

ParseTelegram Parse function used to break down Bx telegrams (header and data separated) in single components. Syntax and parameter C++ HRESULT ParseTelegram([in] BSTR szHeader, [in] BSTR szData, [out] VARIANT *pHeaders, [out] VARIANT *pDatas);

C# int ParseTelegram(string szHeader, string szData, out object pHeaders, out object pDatas);

Parameters

Description

szHeader

Bx header

szData

Bx data string suitable for Bx header

pHeaders

Returns single command as array.

pDatas

Returns single data values as array.

Example (C#) object headers, datas; string[] headersArray, datasArray; tools.ParseTelegram("I!LV01|RX01|GT08|LX02", "Scale1", out headers, out datas); headersArray = (string[])headers; // "LV01", "RX01", "GT08", "LX02" datasArray = (string[])datas; // "", "", "Scale1", ""

18

194

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ParseTelegramEx Parse function used to break down Bx telegrams (header and data combined) in single components. Syntax and parameter C++ HRESULT ParseTelegramEx([in] BSTR szHeaderData, [out] VARIANT *pHeaders, [out] VARIANT *pDatas);

C# int ParseTelegramEx(string szHeaderData, out object pHeaders, out object pDatas);

Parameters

Description

szHeaderData

Bx telegram, header and data combined

pHeaders

Returns single command as array.

pDatas

Returns single data values as array.

Example (C#) object headers, datas; string[] headersArray, datasArray; tools.ParseTelegramEx("I!LV01|RX01|GT08|Scale1|LX02", out headers, out datas); headersArray = (string[])headers; // "LV01", "RX01", "GT08", "LX02" datasArray = (string[])datas; // "", "", "Scale1", ""

18

38.026.297.001 en

195

Program interfaces

Operating instructions _connect.BRAIN

ParseMemocardTelegram Parse function used to divide memory card telegrams deriving from Gx (header and data separated) in single telegrams Gx (header and data separated). Syntax and parameter C++ HRESULT ParseMemocardTelegram([in] BSTR szHeader, [in] BSTR szData, [out] VARIANT *pHeaders, [out] VARIANT *pDatas);

C# int ParseMemocardTelegram(string szHeader, string szData, out object pHeaders, out object pDatas);

Parameters

Description

szHeader

Gx memory card header

szData

Gx memory card data string suitable for header

pHeaders

Returns single header telegrams deriving from the memory card as array.

pDatas

Returns single data telegrams deriving from the memory card as array.

Example (C#) object headers, datas; string[] headersArray, datasArray; tools.ParseMemocardTelegram("A!MV07|GT01|LV01|RX01|GT08|LX02|LX02", "test| Scale1", out headers, out datas); headersArray = (string[])headers; // "A!GT01", "A!LV01|RX01|GT08|LX02" datasArray = (string[])datas; // "test", "Scale1"

18

196

38.026.297.001 en

Operating instructions _connect.BRAIN

Program interfaces

ParseMemocardTelegramEx Parse function used to divide memory card telegrams deriving from Gx (header and data combined) in single telegrams Gx (header and data separated). Syntax and parameter C++ HRESULT ParseMemocardTelegramEx([in] BSTR szHeaderData, [out] VARIANT *pHeaders, [out] VARIANT *pDatas);

C# int ParseMemocardTelegramEx(string szHeaderData, out object pHeaders, out object pDatas);

Parameters

Description

szHeaderData

Gx memory card telegram, header and data combined

pHeaders

Returns single header telegrams deriving from the memory card as array.

pDatas

Returns single data telegrams deriving from the memory card as array.

Example (C#) object headers, datas; string[] headersArray, datasArray; tools.ParseMemocardTelegramEx("A!MV07|GT01|test|LV01|RX01|GT08|Scale1|LX02| LX02", out headers, out datas); headersArray = (string[])headers; // "A!GT01", "A!LV01|RX01|GT08|LX02" datasArray = (string[])datas; // "test", "Scale1"

18

38.026.297.001 en

197

Program interfaces

Operating instructions _connect.BRAIN

ParseMemocardTelegramEx2 Parse function used to divide memory card telegrams deriving from Gx (header and data combined) in single telegrams Gx (header and data combined). Syntax and parameter C++ HRESULT ParseMemocardTelegramEx2([in] BSTR szHeaderData, [out] VARIANT *pHeaderData);

C# int ParseMemocardTelegramEx2(string szHeaderData, out object pHeaderData);

Parameters

Description

szHeaderData

Gx memory card telegram, header and data combined

pHeaderData

Returns single telegrams with header and data combined, as array.

Example (C#) object headerdata; string[] headerDataArray; tools.ParseMemocardTelegramEx2("A!MV07|GT01|test|LV01|RX01|GT08|Scale1|LX02| LX02", out headerdata); headerDataArray = (string[])headerdata; // "A!GT01|test", "A!LV01|RX01|GT08| Scale1|LX02"

18

198

38.026.297.001 en