CIS - Info CIS - Info CIS - Info Nr. 107 vom 22.02.2011 CIS im 64-Bit-Windows Inhalt: 1 Das Problem... 3 1.1 Bisheriges 32-Bit-Windows... 3 1.2 Was neu ist im 64-Bit-Windows... 3 1.3 32-Bit-Programme im 64-Bit-Windows... 3 2 Die Lösung... 4 2.1 Allgemeines... 4 2.2 Unsere neue DLL... 4 2.3 Sonstige neue Programme... 4 2.4 Wie weiß man, ob man ein Windows-64-Bit hat?... 4 3 Installation... 6 3.1 Allgemeines... 6 3.2.NET Framework 4 installieren... 9 3.3 Programme installieren... 11 3.4 Sources installieren... 15 4 Konfiguration (CISCFG64.EXE)... 16 4.1 Programm starten... 16 4.2 Verbindung eintragen... 18
5 Beispielprogramme... 19 5.1 CISVB64.EXE... 19 5.2 CISVC64.EXE... 22 5.3 CISLZ64.EXE... 26 5.4 CISVBA64... 29 6 Declares... 34 6.1 Declares für Lazarus... 34 6.2 Declares für VB 2010... 34 6.3 Declares für VBA (Office 2010)... 35 6.4 Declares für VC++ 2010... 35 7 Infos zu CIS... 36 7.1 Wo findet man die Infos?... 36 7.2 Kontakt zur technischen CIS-Hotline... 36 7.3 Kontakt zur CIS-Projektleitung... 36 CIS-Info Nr. 107: CIS im 64-Bit-Windows - 2 -
1 Das Problem 1.1 Bisheriges 32-Bit-Windows Bisher haben wir in der 32-Bit-Welt gearbeitet. Hier sind die Adressen 32 Bit (4 Bytes) lang. Ohne Vorzeichen kann man hier Werte bis zu 4 GB angeben. Da Windows selber aber im gleichen Adressraum steht hat man normalerweise Adressen bis zu 2 GB. Wenn jemand aus einem Programm in Windows Daten aus CIS haben will, so muss er eine von uns erstellte DLL benutzen. Diese DLL genauso wie die Programme des Benutzers liefen bisher in der 32- Bit-Welt. Unsere DLL (cisdc32.dll) steht im System-Verzeichnis von Windows (C:\Windows\System32) in einem 32-Bit-Windows. Die Konfigurations-Datei cisdc32.cfg steht auch in diesem Verzeichnis. Sie wird von unserem Programm CISCFG.EXE bearbeitet. 1.2 Was neu ist im 64-Bit-Windows Im 64-Bit-Windows sind die Adressen 64 Bit (8 Bytes) lang. Damit können Adressen weit über 4 GB angegeben werden. Das obere Limit einer Adresse dürfte von der Windows-Variante abhängen. Auf jeden Fall müssen hier 8-Byte-Adressen benutzt werden. Unsere DLL musste neu programmiert werden, do dass sie 64-Bit-Adressen bearbeitet. Wenn nämlich ein 64-Bit-Programm eine Funktion unserer DLL aufruft, so werden 64-Bit-Adressen (8 Bytes) ausgetauscht. Die neue 64-Bit-DLL steht im Verzeichnis C:\Windows\System32 in einem 64-Bit-Windows. In diesem Verzeichnis muss dann auch die CFG-Datei stehen. 1.3 32-Bit-Programme im 64-Bit-Windows Im 64-Bit-Windows können noch die alten 32-Bit-Programme laufen. Es gibt jetzt 2 Programm- Verzeichnisse: Eins für die 32-Bit-Programme wie bisher (z.b. C:\Programme) mit dem Zusatz (x86) im Namen Und eins für die 64-Bit-Programme ohne den Zusatz im Namen Für die DLLs gibt es jetzt 2 Verzeichnisse: C:\Windows\System32 für die 64-Bit-DLLs C:\Windows\SYSWOW64 für die 32-Bit-DLLs Will man in einer 32-Bit-DLL das Systemverzeichnis per Programm erfahren, so erhält man den Wert C:\Windows\System32 obwohl in Wirklichkeit der echte Name C:\Windows\SYSWOW64 ist. Somit merken die 32-Bit-DLLs nicht, dass sie in einem 64-Bit-Windows laufen. Für unsere Kunden bedeutet das: Wenn der Kunde ein 32-Bit-Programm benutzt, dann wird cisdc32.dll und cisdc32.cfg im Verzeichnis C:\Windows\SYSWOW64 benutzt. Das Programm glaubt aber dass diese beiden im Verzeichnis C:\Windows\System32 stehen. Wenn der Kunde ein 64-Bit-Programm benutzt, dann wird cisdc64.dll und cisdc64.cfg im Verzeichnis C:\Windows\System32 benutzt. (und auch so angezeigt). CIS-Info Nr. 107: CIS im 64-Bit-Windows - 3 -
2 Die Lösung 2.1 Allgemeines Es musste also eine cisdc64.dll erstellt werden. Diese benutzt die cisdc64.cfg. Um diese Datei zu pflegen, brauchen wir ein Dienstprogramm: CISCFG64.EXE. Es mussten auch Beispielprogramm, wenigsten für Visual Basic und Visual C++ erstellt werden. Ein Beispiel fürs neue Visual Basic for Applications im 64-Bit-Office wäre auch nicht schlecht. 2.2 Unsere neue DLL Es wird eine neue cisdc64.dll ausgeliefert. Sie benutzt die Konfigurations-Datei cisdc64.cfg. 2.3 Sonstige neue Programme Es muss auf jeden Fall ein Programm zum Bearbeiten von cisdc64.cfg ausgeliefert werden. Das ist das Programm CISCFG64.EXE. Dann müssen noch Beispielprogramme (ausführbar und wahlweise auch als Source-Dateien) ausgeliefert werden für die Programmiersprachen Visual C++ (2010), Visual Basic (2010) und für Visual Basic for Applications (Office 2010). Auch müssen die Deklarationen, wie sie jetzt in den Source-Programmen aussehen sollen, ausgeliefert werden. 2.4 Wie weiß man, ob man ein Windows-64-Bit hat? Rechtsklick auf Computer und hier dann Linksklick auf Eigenschaften. Es Erscheint: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 4 -
Eine andere Möglichkeit: im Internet unter CIS Downloads CISDC64: Cisinfo32.exe bringt in einem 64-Bit-Windows die Meldung: Cisinfo64.exe bringt in einem 64-Bit-Windows die Meldung: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 5 -
3 Installation 3.1 Allgemeines Die entsprechende Seite im Internet laden wie in Punkt Wo findet man die Infos? angegeben. Hier dann setup64.exe laden: Weiter: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 6 -
Weiter: Weiter: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 7 -
Eventuell anderes Verzeichnis eintragen dann Weiter: Hier muss jetzt gewählt werden, was zu installieren ist: Programme installieren: es wird die DLL installiert sowie CISCFG64.EXE und die Beispielprogramme als ablauffähige Programme Diese Programme (auch CISCFG64.EXE) brauchen.net4 Sources installieren: ist nur interessant wenn man die Source-Codes der Beispiel-Programme anschauen will.net4 installieren: die Programme brauchen.net4. Wenn dies noch nicht installiert ist, dann wird es hier ermöglicht Wenn.NET Framework 4 nicht installiert ist, dann kommt schon bei dem Programm CISCFG64.EXE die Fehlermeldung: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 8 -
3.2.NET Framework 4 installieren Um Microsoft.NET Framework 4 zu installieren (kann auch mit anderen installiert werden): Weiter: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 9 -
Installieren. Die Installation dauert schon einige Minuten. Am Ende: Über Systemsteuerung Programme sieht man die 4 Komponenten, die installiert wurden: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 10 -
3.3 Programme installieren Es erscheint dann: Man kann hier den Startmenü-Ordner ändern. Dann Weiter: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 11 -
Installieren. Am Ende erscheint: C:\Windows\System32\cisdc64.cfg als Modell anlegen: O.K.: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 12 -
Dies ist der Inhalt der Modell-Datei: Details zu CISCFG64.EXE siehe weiter unten. Wenn Programm-Ende, dann: Jetzt sind die Programme installiert. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 13 -
Um irgendein Programm zu starten: Start Alle Programme CISDC64 bringt: Infos zu den einzelnen Programmen in den nächsten Kapiteln. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 14 -
3.4 Sources installieren Kann allein (wie hier unten) oder mit den Programmen installiert werden: Nach dieser (zusätzlichen) Installation sieht es so aus: (zusätzliche Elemente rosa hinterlegt) : CIS-Info Nr. 107: CIS im 64-Bit-Windows - 15 -
4 Konfiguration (CISCFG64.EXE) 4.1 Programm starten Das Programm CISCFG64.EXE soll die DATEI cisdc64.cfg im Verzeichnis System32 bearbeiten. Daher sollte dieses Programm als Administrator ausgeführt werden. Rechtsklick auf CISCFG64 und dann Linksklick auf als Administrator ausführen. Es erscheint: Durch klicken von C:\WINDOWS\System32\cisdc64.cfg überschreibbar machen kann die cfg- Datei bearbeitet werden. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 16 -
CFG-Datei bearbeiten bringt: Dies ist der Inhalt der Modell-Datei. Es können 3 verschiedene Daten eingegeben werden: 1. Wert für Logging (normal 0, nach Rücksprache mit CIS-Team hier Wert eintragen) 2. Logging-Datei (Sie sollte in einem Verzeichnis stehen) 3. Verbindung(en) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 17 -
4.2 Verbindung eintragen Man kann eine Zeile der Verbindungen anklicken; daraufhin erscheinen die einzelnen Werte in den unteren Feldern. Mit Eintrag ändern/eintrag anlegen wird der Eintrag geändert (wenn der Name der Verbindung derselbe geblieben ist) oder eine neue Verbindung eingetragen. Mit unsortierte Liste kann man die Liste der Verbindungen unsortiert oder sortiert anzeigen. (So wird sie dann auch später gespeichert), Mit Eintrag löschen wird die angeklickte Zeile gelöscht. Die Verbindung hat folgende Teile: 1. Name der Verbindung Dies ist ein maximal 16-stelliger Name der Verbindung, welcher im cis_at-auruf der DLL als Name angegeben wird. Werden Kleinbuchstaben eingegeben, so werden sie in Grossbuchstaben übersetzt. 2. BS2000-Appliname Dies ist der maximal 8-stellige Name der BS2000-DCAM-Anwendung. Er wird immer in Grossbuchstaben gespeichert. 3. Proxy (oder leer) Hier kann ein Proxy auf dem Weg zum BS2000 angegeben werden. 4. BS2000-Rechner Dies ist die IP-Adresse oder der Name des BS2000-Rechners. Wird ein Name angegeben, so muss er in der Datei \System32\drivers\etc\hosts stehen. 5. Namens-Präfix (oder leer) Hier kann ein 3-stelliges oder 4-stelliges Präfix für den Namen der Anwendung in Windows angegeben werden. Dieses Präfix wird mit der Port-Nummer der Verbindung ergänzt. Wird nichts angegeben, so wird CIS genommen. Bei einem 3-stelligen Präfix wird die Port-Nummer 5-stellig (evtl. führende Nullen) angefügt. Bei einem 4-stelligen Präfix werden die rechten 4 Nummern des Ports angefügt. 6. Passwort (oder leer) Hier kann ein maximal 16-stelliges Passwort angegeben werden. Dies ist notwendig wenn der CISSRV-Parameter PW-P= angegeben wurde. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 18 -
5 Beispielprogramme 5.1 CISVB64.EXE Dieses ist ein Visual-Basic-Programm und ist mit Microsoft Visual Studio 2010 programmiert. Verbindung aufbauen: (Wenn der Name der Verbindung in Klein-buchstaben eingegeben wird, dann wird er in Grossbuchstaben übersetzt) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 19 -
CIS-Befehle eingeben: (z.b. z,$,a,db.fmulti) Die Daten können in eine Textdatei ausgegeben werden und per Notepad angezeigt werden. Notepad (neu) zeigt nur die letzten Daten. Notepad (add) fügt die Daten zu den bisherigen dazu und zeigt alle. Verbindung abbauen: Verbindung wird abgebaut ohne spezielle Meldung. Info über Verbindung: Programm beenden: Das Programm wird beendet. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 20 -
Info über Programm: Spezial-CIS-Aufrufe ($D x ): hier können Komandos an die DLL eingegeben werden (Format: $d x ) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 21 -
5.2 CISVC64.EXE Dieses ein Visual-C++-Programm und ist mit Microsoft Visual Studio 2010 programmiert. Verbindung aufbauen: (Wenn der Name der Verbindung in Klein-buchstaben eingegeben wird, dann wird er in Grossbuchstaben übersetzt) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 22 -
CIS-Befehle eingeben: (z.b. z,$,a,db.fmulti) Die Daten können in eine Textdatei ausgegeben werden und per Notepad angezeigt werden. Notepad - Neu zeigt nur die letzten Daten. Notepad Addieren fügt die Daten zu den bisherigen dazu und zeigt alle. Verbindung abbauen: Verbindung wird abgebaut ohne spezielle Meldung. Programm beenden: Das Programm wird beendet. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 23 -
Info über Verbindung: Info über Programm: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 24 -
Spezial-CIS-Aufrufe ($D x ): hier können Komandos an die DLL eingegeben werden (Format: $d x ) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 25 -
5.3 CISLZ64.EXE Dieses Programm ist mit Lazarus Version 0.9.28.2 Beta programmiert. Verbindung aufbauen: (Wenn der Name der Verbindung in Klein-buchstaben eingegeben wird, dann wird er in Grossbuchstaben übersetzt) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 26 -
CIS-Befehle eingeben: (z.b. z,$,a,db.fmulti) Die Daten können in eine Textdatei ausgegeben werden und per Notepad angezeigt werden. Notepad zeigt nur die letzten Daten. Notepad addieren fügt die Daten zu den bisherigen dazu und zeigt alle. Verbindung abbauen: Verbindung wird abgebaut ohne spezielle Meldung. Info über Verbindung: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 27 -
Info über Programm: Programm beenden: Das Programm wird beendet. Spezial-CIS-Aufrufe ($D x ): hier können Komandos an die DLL eingegeben werden (Format: $d x ) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 28 -
5.4 CISVBA64 Dieses ist ein Coding, welches unter Microsoft Office 2010 im 64-Bit-Modus läuft. Hier muss erst z.b. Excel geladen werden: Dann Entwicklertools : Dann Visual Basic und Datei importieren :: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 29 -
In C:\CISDC64\CISVBA64 die Dateien: UserForm1 Modul1 laden: Jetzt UserForm1 doppelklicken, Sub/Userform ausführen(f5) dann erscheint: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 30 -
Aufbau der Verbindung: (Wenn der Name der Verbindung in Klein-buchstaben eingegeben wird, dann wird er in Grossbuchstaben übersetzt) CIS-Aktiv: (z.b. z,$,a,db.fmulti) Abbau der Verbindung: Verbindung wird abgebaut ohne spezielle Meldung. CIS-Info Nr. 107: CIS im 64-Bit-Windows - 31 -
Spezial ($d x ): hier können Komandos an die DLL eingegeben werden (Format: $d x ) Ende des Programms Das Programm wird beendet. Info Verbindung: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 32 -
Info Programm: CIS-Info Nr. 107: CIS im 64-Bit-Windows - 33 -
6 Declares 6.1 Declares für Lazarus ' ************************************************************************** ' * * ' * Declares fuer cisdc64.dll (fuer Lazarus) * ' * * ' * cis_at : Verb.Name Liz.Nr. Fehler * ' * Rueckmeldung: Verb.Nr. oder -1 * ' * cis_sr : Verb.Nr. CIS-Kommando CIS-Antwort Fehler * ' * Rueckmeldung: 0 oder -1 * ' * cis_dt : Verb.Nr. Fehler * ' * Rueckmeldung: 0 oder -1 * ' * cis_ln : Len-hin Len-retour * ' * Rueckmeldung: 0 oder -1 * ' * * ' * * ' ************************************************************************** Function cis_at(g_cis_name, G_CIS_Lizenz, G_CIS_Fehler: PChar): Longint; stdcall; EXTERNAL 'CISDC64.DLL' NAME 'cis_at'; Function cis_sr(g_cis_nummer : Integer; G_CIS_Kommando, G_CIS_Antwort, G_CIS_Fehler: PChar): Longint; stdcall; EXTERNAL 'CISDC64.DLL' NAME 'cis_sr'; Function cis_dt(g_cis_nummer : Integer; G_CIS_Fehler: PChar): Longint; stdcall; EXTERNAL 'CISDC64.DLL' NAME 'cis_dt'; Function cis_ln(out G_CIS_Len_Send, G_CIS_Len_Receive: integer): Longint; stdcall; EXTERNAL 'CISDC64.DLL' NAME 'cis_ln'; 6.2 Declares für VB 2010 ' ************************************************************************** ' * * ' * Declares fuer cisdc64.dll (fuer MS Visual Basic 2010) * ' * * ' * cis_at : Verb.Name Liz.Nr./NULL Fehler/NULL * ' * Rueckmeldung: Verb.Nr. oder -1 * ' * cis_sr : Verb.Nr. CIS-Kommando CIS-Antwort Fehler/NULL * ' * Rueckmeldung: 0 oder -1 * ' * cis_dt : Verb.Nr. Fehler/NULL * ' * Rueckmeldung: 0 oder -1 * ' * cis_ln : Len-hin Len-retour * ' * Rueckmeldung: 0 oder -1 * ' * * ' * in Visual Basic steht nicht "NULL" sondern "vbnullstring" wenn * ' * ein leerer Pointer angegeben werden soll. * ' * * ' ************************************************************************** Declare Function cis_at Lib "cisdc64.dll" _ (ByVal s As String, ByVal s As String, ByVal s As String) As Integer Declare Function cis_sr Lib "cisdc64.dll" _ (ByVal l As Integer, ByVal s As String, ByVal s As String, ByVal s As String) As Integer Declare Function cis_dt Lib "cisdc64.dll" _ (ByVal l As Integer, ByVal s As String) As Integer Declare Sub cis_ln Lib "cisdc64.dll" _ (ByRef s As Integer, ByRef r As Integer) CIS-Info Nr. 107: CIS im 64-Bit-Windows - 34 -
6.3 Declares für VBA (Office 2010) ' ************************************************************************** ' * * ' * Declares fuer cisdc64.dll (fuer Visual Basic for Applications in * ' * MS Office 2010) * ' * * ' * cis_at : Verb.Name Liz.Nr. Fehler * ' * Rueckmeldung: Verb.Nr. oder -1 * ' * cis_sr : Verb.Nr. CIS-Kommando CIS-Antwort Fehler * ' * Rueckmeldung: 0 oder -1 * ' * cis_dt : Verb.Nr. Fehler * ' * Rueckmeldung: 0 oder -1 * ' * cis_ln : Len-hin Len-retour * ' * Rueckmeldung: 0 oder -1 * ' * * ' * * ' ************************************************************************** Declare PtrSafe Function cis_at Lib "cisdc64.dll" _ (ByVal name As String, ByVal lizent As String, ByVal fehler As String) As Long Declare PtrSafe Function cis_sr Lib "cisdc64.dll" _ (ByVal nummer As Long, ByVal kommando As String, ByVal antwort As String, ByVal fehler As String) As Long Declare PtrSafe Function cis_dt Lib "cisdc64.dll" _ (ByVal nummer As Long, ByVal fehler As String) As Long Declare PtrSafe Function cis_ln Lib "cisdc64.dll" _ (ByRef lensnd As Long, ByRef lenrcv As Long) As Long 6.4 Declares für VC++ 2010 /************************************************************************* * * * Aufrufe von cisdc64.dll (fuer MS Visual C++ 2010) * * * * cis_at : Verb.Name Liz.Nr./NULL Fehler/NULL * * Rueckmeldung: Verb.Nr. oder -1 * * cis_sr : Verb.Nr. CIS-Kommando CIS-Antwort Fehler/NULL * * Rueckmeldung: 0 oder -1 * * cis_dt : Verb.Nr. Fehler/NULL * * Rueckmeldung: 0 oder -1 * * cis_ln : Len-hin Len-retour * * Rueckmeldung: 0 oder -1 * * * *************************************************************************/ #define DllImport declspec(dllimport) extern "C" { } DllImport int WINAPI cis_at (char*, char*, char*); DllImport int WINAPI cis_sr (int, char*, char*, char*); DllImport int WINAPI cis_dt (int, char*); DllImport void WINAPI cis_ln (int*, int*); CIS-Info Nr. 107: CIS im 64-Bit-Windows - 35 -
7 Infos zu CIS 7.1 Wo findet man die Infos? Die aktuellen Infos zu CIS finden Sie immer im Internet: Unter: http://www.nickels.de dann den Punkt Das Produkt CIS auswählen dann den Punkt Downloads auswählen dann den Punkt CISDC64 auswählen 7.2 Kontakt zur technischen CIS-Hotline Nickels Informatik GmbH Abteilung CIS Anglerstr. 28 80339 München Telefon.: 089-45 47 58 46 Fax: 089-64 29 99 41 e-mail: cis@nickels.de 7.3 Kontakt zur CIS-Projektleitung Siemens IT Solutions and Services Frau Haslinger Richard-Strauß-Str. 76 81679 München Telefon.: 089 9221-2680 Fax: 089 9221-2992 e-mail: Petra.Haslinger@siemens.com CIS-Info Nr. 107: CIS im 64-Bit-Windows - 36 -