Siemens Nixdorf Informationssysteme AG. Softwareprodukt CIS. Version A10. Zusatzmanual CISDC32. CISSRV und

Transkript

1 Siemens Nixdorf Informationssysteme AG Softwareprodukt CIS Version A10 Zusatzmanual CISSRV und CISDC32 Ausgabe: Mai 1996

2 Inhaltsverzeichnis 1 CISSRV Funktionsumfang Datenfluß Bedienung Einrichten von CISSRV Start des CISSRV-Prozesses Parameter für CISSRV Bedienung während des Betriebs Beendigung von CISSRV CISDC Allgemeines Einbettung CISDC Einbettung unter Unix Einbettung unter Windows 95 / NT Funktionen cis_at cis_sr cis_dt cis_ln Prototypen Datei cisdc32.h unter Unix Datei cisdc32.h unter Windows Declare-Statements für Visual Basiv 4.0 (Datei CISDC32B.TXT) Declare-Statements für VBA in Winword Declare-Statements für VBA in Excel Diagnosekommandos für CISDC Ablaufumgebung Verbindungsaufbau Nachrichtenverkehr Konfigurationsdatei Umgebungsvariable...31 CIS V A10 Zusatzmanual

3 CISSRV 1 CISSRV 1.1 Funktionsumfang Dieses Programm ersetzt ab Version 12.0 Korrekturstand A10 das Programm CISSERV. In diesem Kapitel wird der Aufbau der Client-Server-Architektur mit dem CIS-Server erläutert. Der Server ist ein BS2000-DCAM-Programm, das auch im Multitask-Betrieb laufen kann (multiple server). Die Clients sind Terminals oder Programme, die im Netz verteilt sein können. Sie werden vom Server im CIS-Aktiv-Modus bedient. Die ausgetauschten Daten sind also alle abdruckbar. Die Clients von CISSRV können sein: - BS-2000 Terminals - CISDC auf einem SINIX-Rechner (MX-i oder RM) - CISDC unter Windows (16 bit) - CISDC32 unter Windows (32 bit) oder Unix CISSRV ist eine DCAM-NEA Anwendung. Terminals können also ohne weiteres mit dem Server verkehren. Die Module CISDC/CISDC32 bilden das NEA-Protokoll nach. Wird CISSRV im Multitask-Betrieb gefahren, so kann der Primary-Task so eingestellt werden, daß er sich nur um die Kommunikation kümmert, selbst aber keine CIS-Routinen aufruft. Dies ist ein Sicherheitsaspekt, da ein DCAM-Primary, der sich fehlerhaft beendet, die ganze Anwendung beendet. CIS V A10 Zusatzmanual - 3 -

4 CISSRV 1.2 Datenfluß BS2000-Terminal SINIX-Rechner DCAM Anwender- Programm CISDC 1) CISSRV PC mit Windows (16-bit) Anwender- Programm CISDC 2) Unix / Windows (32-bit) CIS- Daten Anwender- Programm CISDC32 3) 1) CMX plus CCP 2) Emu + Driver + Hardware CMX + CCP + Hardware TCP/IP (WINSOCK.DLL) + Hardware 3) TCP/IP (WSOCK32.DLL) + Hardware CIS V A10 Zusatzmanual - 4 -

5 CISSRV 1.3 Bedienung CISSRV wird in einem ENTER-Prozeß gestartet. Alle Anpassungen an die jeweiligen Belange werden über Parameter in diesem Prozeß gesteuert. Eingriffe während des Betriebs können über das BS2000-Kommando '/SEND-MESSAGE' oder über das CIS-Kommando $D vorgenommen werden Einrichten von CISSRV Es werden zwei Phasen von CISSRV ausgeliefert: CISSRV mit Datensicherung CISSRV.ODASI ohne Datensicherung Die dazugehörenden Bindeprozeduren werden mitgeliefert. Anpassungen an CISVARI/CISVARI1 werden ausgeführt wie bei CIS oder CIS.ODASI: - Anpassungen an CISVARI / CISVARI1 - Neu binden von CISSRV / CISSRV.ODASI oder mit Parameter CISVARI+a= Start des CISSRV-Prozesses Folgende ENTER-Prozedur muß definiert werden: /LOGON /SET-FILE-LINK FILE-NAME=Name,LINK-NAME=DB /SET-FILE-LINK FILE-NAME=Name,LINK-NAME=KUKO /SET-FILE-LINK FILE-NAME=MODLIB.CIS.12,LINK-NAME=BLSLIB01 *) /START-PROGRAM FROM-FILE=CISSRV[.ODASI].. (Parameter für CISSRV). END /LOGOFF *) - zum Nachladen von CISGEN. CIS V A10 Zusatzmanual - 5 -

6 CISSRV Parameter für CISSRV Übersicht: Parameter Bedeutung Default-Wert *... Kommentar APPLI=a Definition Anwendungsname CIS AUTEND Automatisch beenden CISVARI+a=... Änderungen in CISVARI/CISVARI1 Bitte nicht mehr benutzen!!! END Ende Parameter ENT-JOB=params Parameter zum Starten weiterer CISSRV-Tasks LOG=x Logging der Ein-/Ausgaben (J/N) N OUT-P=x Ausgabemodus für Programme (F/L) L OUT-T=x Ausgabemodus für Terminals (F/L) L POS=n Anzahl Einträge in Partnertabelle 200 PRIMWAIT Primary soll warten PW-P=p Paßwort für Programme PW-T=p Paßwort für Terminal TASKS=n Anzahl CISSRV-Tasks 1 TIME-END=hhmm Ende-Zeit TIME-STOP=hhmm Abbruch-Zeit TIMEOUT=n Timeout-Zeit für Transaktionen im Keep-Zustand (in 600 Sekunden) VERS-P=x Versionsmeldung bei Programmen (J/N) N VERS-T=x Versionsmeldung bei Terminals (J/N) J Bemerkung zum Keep-Zustand: Eine Transaktion in Unix/Windows kann über CISDC32 den Befehl $@#KEEP an CISSRV senden und sich dann mit cis_dt abmelden. Die Transaktion wird in CISSRV jedoch weitergeführt. Sobald sie sich wieder mit cis_at anmeldet, kann sie weiterarbeiten. Jedoch setzt CISSRV diese Transaktion zurück, wenn sie sich nicht innerhalb der Zeit von TIMEOUT=n wieder meldet. (Siehe auch Beschreibung von CISDC32). CIS V A10 Zusatzmanual - 6 -

7 CISSRV *... Kommentar - ohne Auswirkung. Es können beliebig viele Kommentare vorhanden sein. APPLI=a Definition des Anwendungsprogramms von CISSRV. Es kann ein 1- bis 8-stelliger Name angegeben werden. Fehlt der Parameter, so wird "CIS" angenommen. AUTEND Automatisches Ende. Wenn der letzte Partner sich abmeldet, wird auch CISSRV beendet. Fehlt der Parameter, so muß CISSRV mit dem TIME-Parameter oder durch Eingriff beendet werden. CISVARI+a={C... /X... } Änderungen in CISVARI/CISVARI1. Im Modul CISVARI (in CISSRV) oder CISVARI1 (in CISSRV.ODASI) werden an der Adresse a (hexa abdruckbar) die Korrekturen C... oder X... vor dem Starten von CIS ausgeführt. Bitte diesen Parameter nicht mehr benutzen!!! (Es wird eine interne Kopie von CISSRV geändert. Die Änderungen betreffen daher nicht alle Module z.b. sind die Änderungen nicht gültig im Modul CISUTM) END Ende der Parameter. CIS V A10 Zusatzmanual - 7 -

8 CISSRV ENT-JOB=params Parameter zum Starten weiterer CISSRV-Tasks. CISSRV schreibt die Parameter params in ein ENT-JOB Kommando (max. 200 Bytes lang und ruft dieses Kommando so oft auf bis der Wert von TASKS=N erreicht ist. Fehlt der Parameter, so müssen zusätzliche Tasks manuell gestartet werden. Intern wird das Kommando: /ENTER-JOB FROM-FILE =params aufgerufen. LOG={J/N} Logging der Ein- und Ausgaben auf SYSLST. J Protokollierung N keine Protokollierung OUT-P={F/L} Ausgabemodus für Programme als Partner. F formatiert L Zeilenmodus (Line) = Standardwert OUT-T={F/L} Ausgabemodus für Programme auf Terminal. F formatiert L Zeilenmodus (Line) = Standardwert CIS V A10 Zusatzmanual - 8 -

9 CISSRV POS=n Anzahl Einträge in Partnertabelle. Dies ist die Anzahl der Partner (Terminal oder CISDC-Verbindungen), die gleichzeitig mit CISSRV arbeiten können. Fehlt dieser Parameter so wird der Wert 200 angenommen. PRIMWAIT Primary soll warten. Wird dieser Parameter angegeben, so bearbeitet der Primary-Task keine CIS-Aufrufe. Er bedient lediglich die Kommunikation. PW-P=p Paßwort für Programme. Paßwort, das bei Verbindungsaufbau von einem Partner, der ein Programm ist, angegeben werden muß. (Siehe auch Bearbeitung von CISDC) Das Paßwort ist 1 bis 16 Zeichen lang. PW-T=p Paßwort für ein Terminal. Das Anmelden des Terminals hat folgendes Format: O_Name,...,MSG=c'PW=p' Das Paßwort ist 1 bis 16 Zeichen lang. CIS V A10 Zusatzmanual - 9 -

10 CISSRV TASKS=n Anzahl CISSRV-Tasks. TASKS steuert das Laden zusätzlicher CISSRV-Tasks in Zusammenhang mit dem Parameter ENT-JOB=params. Fehlt der Parameter, so wird der Wert 1 angenommen. TIME-END=hhmn Ende-Zeit Ist diese Zeit erreicht, so geht CISSRV in den "AUTEND"-Zustand. (Siehe Parameter AUTEND.) TIME-STOP=hhmn Abbruch-Zeit Ist diese Zeit erreicht, so wird CISSRV sofort beendet. TIMEOUT=n Timeout-Zeit für Transaktionen im Keep-Zustand (in Sekunden). Fehlt dieser Parameter, so wird der Wert 600 angenommen. Eine Transaktion in Unix/Windows kann über CISDC32 den Befehl $@#KEEP an CISSRV senden und sich dann mit cis_dt abmelden. Die Transaktion wird in CISSRV jedoch weitergeführt. Sobald sie sich wieder mit cis_at anmeldet, kann sie weiterarbeiten. Jedoch setzt CISSRV diese Transalktion zurück, wenn sie sich nicht innerhalb der Zeit von TIMEOUT=n wieder meldet. (Siehe auch Beschreibung von CISDC32). CIS V A10 Zusatzmanual

11 CISSRV VERS-P={J/N} Ausgabe der Versionsmeldung beim Anmelden für Programme als Partner. J Ja N Nein (Standardwert) VERS-T={J/N} Ausgabe der Versionsmeldung beim Anmelden des Terminals. J Ja (Standardwert) N Nein CIS V A10 Zusatzmanual

12 CISSRV Bedienung während des Betriebs Die Bedienung erfolgt entweder über das BS2000 Kommando '/SEND-MESSAGE' oder über das CIS- Kommando $D. Übersicht: Kommando /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))], MESSAGE=LOG[_x] $D_SLOG[_x] /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))], MESSAGE=LST[_p] $D_SLST[_p] /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))], MESSAGE=END $D_SEND] /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))], MESSAGE=STOP Erläuterung Logging (Info/Ein/Aus) Information über Partner Ende Abbruch CIS V A10 Zusatzmanual

13 CISSRV /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))],MESSAGE=LOG[_x] $D_SLOG[_x] Logging der Ein-/Ausgaben auf SYSLST. Dieses Kommando kann je nach Wert von x das Logging einschalten, ausschalten oder Infos über die Schaltung ausgeben. x =? es wird informiert ob Logging ein oder aus ist. x = J Logging wird eingeschatet. x = N Logging wird ausgeschaltet. /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))],MESSAGE=LST[_p] $D_SLST[_p] Information über Partner. Dieses Kommando bewirkt, daß eine Liste der aktiven Partner ausgegeben wird. Es werden jeweils 20 Zeilen gedruckt. Sollen weitere Partner aufgelistet werden, so wird beim Kommando die Position (p) angegeben, ab der protokolliert werden soll. /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))],MESSAGE=END $D_SEND Ende Mit diesem Kommando wird CISSRV in den Modus geschaltet, in dem es sich beendet wenn der letzte Partner sich abmeldet. /SEND-MESSAGE TO=PROGRAM[(JOB-ID=TSN(xxxx))],MESSAGE=STOP Abbruch Mit diesem Kommando wird CISSRV sofort beendet. CIS V A10 Zusatzmanual

14 CISSRV Beendigung von CISSRV Es gibt verschiedene Möglichkeiten, CISSRV zu beenden: a) Parameter AUTEND oder /SEND-MESSAGE...END oder $D_SEND CISSRV beendet sich wenn der letzte Partner sich abmeldet. b) TIME-END=hhmn Bei Erreichen dieser Zeit geht CISSRV in den Zustand wie unter a) beschrieben. c) /SEND-MESSAGE...STOP oder /BCLOSE_Name oder /BCEND CISSRV wird sofort beendet. d) TIME-STOP=hhmn Bei Erreichen dieser Zeit wird CISSRV sofort beendet. CIS V A10 Zusatzmanual

15 2 CISDC Allgemeines Dieses Modul soll nicht das bisherige Modul CISDC ersetzen. Es ist vielmehr die Variante für die 31- Bit-Welt ; also für Windows 95 und für Windows NT, sowie auch für Unix. Es baut im Gegensatz zu CISDC nur auf die TCP/IP-Socket-Schnittstelle auf. Das Modul CISDC32 ist das Verbindungsmodul zum CIS-Server. Es bietet eine Anmeldefunktion, eine Abmeldefunktion und eine Übertragungsfunktion an. Die Schnittstellen sind so gehalten, daß sie sich an CIS orientieren aber nicht am Betriebssystem oder an der Übertragungsmethode. CISDC32 ist für diverse Unix-Systeme und für PC's unter Windows 95 oder Windows NT verfügbar. Das Modul CISDC32 setzt auf die Socket-Schnittstelle (TCP/IP) auf. Es kann mehrere Verbindungen gleichzeitig bedienen. Das Modul CISDC32 ist unter folgenden Betriebssystemen getestet worden: SINIX V5.41 (RM 400) BSD/OS Version 2.1 Linux Version Windows 95 Windows NT Version 3.51 und Version 4.0 Windows 2000 Windows XP Soll CISDC32 unter einem anderen Unix-System ablaufen, so dürfte die Portierung unproblematisch sein, sofern die Socket-Schnittstelle (Berkeley Sockets) vorhanden ist. CIS V A10 Zusatzmanual

16 2.2 Einbettung CISDC Einbettung unter Unix Unix Anwender- Programm Konfigurationsdatei CISDC32 cisdc32.cfg TCP/IP (Sockets) BS2000 DCAM CIS-Daten CISSRV Das oberste Kästchen stellt ein Unix-Programm dar, das CIS-Kommandos durch Aufruf von CISDC32-Funktionen absetzt. CIS V A10 Zusatzmanual

17 2.2.2 Einbettung unter Windows 95 / NT MS Windows 95 / NT Anwender- Programm Konfigurationsdatei cisdc32.dll cisdc32.cfg TCP/IP (Sockets) WSOCK32.DLL BS2000 DCAM CIS-Daten CISSRV Das oberste Kästchen stellt ein Windows-Programm dar, das CIS-Kommandos durch Aufruf von CISDC32-Funktionen absetzt. CIS V A10 Zusatzmanual

18 2.3 Funktionen cis_at 1. Beschreibung: Diese Funktion baut die Verbindung zum CIS-Server auf. Sie braucht verschiedene Parameter: - Verbindungsname: Dies ist der Name der Verbindung. Er kann bis zu 16 Zeichen lang sein. Dieser Name muß in der Konfigurationsdatei cisdc32.cfg definiert sein. Das Modul CISDC32 belegt hierfür einen Platz in einer internen Tabelle, in der alle relevanten Daten über die Verbindung gespeichert werden. Die Nummer dieses Platzes wird zurückgemeldet. Bei allen folgenden Funktionen wird diese Nummer angegeben. Damit ist jederzeit die Verbindung genau definiert. - Lizenznummer: Es kann eine Lizenznummer an den CIS-Server übergeben werden. Dieser prüft, ob es diese Lizenz schon gibt. Ist die Lizenz schon vorhanden, nimmt er den Verbindungswunsch nicht an. Die Lizenznummer hat das Format: n[@a], wobei n aus 1 bis 12 alphanumerischen Zeichen (eigentliche Lizenznummer) und a aus 1 bis 4 Ziffern (Anzahl der Lizenzen) besteht. - Fehlertext: Angabe des Feldes, in das CISDC32-Fehler zurückmeldet werden. Wird ein Null-Pointer übergeben, so gibt CISDC32 die Fehlermeldung unter Unix auf stderr, unter Windows in eine Message-Box aus. 2. Definition der Funktion: int cis_at(verb_name, lic_nr, f_text) char *verb_name; char *lic_nr; char *f_text; Verbindungsname Pointer auf die Lizenz-Nummer oder NULL Pointer auf Bereich für Fehlertext (256 Bytes) oder NULL Bemerkungen: Gibt es keine Lizenznummer, so kann entweder der Pointer NULL übergeben oder ein Leerstring eingetragen werden. Gibt es keinen Bereich für Fehlertext, so kann der Pointer NULL übergeben werden. Die Fehlermeldung wird dann von CISDC32 unter Unix auf stderr, unter Windows in eine Message-Box ausgegeben. CIS V A10 Zusatzmanual

19 3. Ergebnis: Bei erfolgreicher Beendigung liefert die Funktion die Verbindungsnummer, andernfalls den Wert -1 zurück. Die Verbindungsnummer ist die Position in der internen Tabelle, an der CISDC32 sich alle relevanten Daten über die Verbindung gemerkt hat. Diese Nummer wird in den folgenden Funktionen cis_sr und cis_dt angegeben. Der Zugriff auf die interne Tabelle mit dieser Nummer ist wesentlich schneller als das Durchsuchen nach einem bestimmten Namen. Die Nummer liegt im Bereich 0 bis Fehler: Fehler werden von CISDC32 in den Bereich, der mit f_text adressiert wird, zurückgemeldet. Wird der Pointer NULL an CISDC32 übergeben, so wird die Meldung unter UNIX auf stderr, unter Windows in eine Message-Box ausgegeben. Der Wert -1 wird zurückgemeldet. Eigenen Terminalnamen vergeben. Es ist möglich einen eigenen Terminalnamen zu vergeben, der nicht aus der Konfigurationsdatei cisdc32.cfg stammt. Hierzu wird statt der Lizenznummer der String $@#Txxxxxxxx verwendet, wobei xxxxxxxx der Terminalname ist. Bei diesem Namen bitte Großbuchstaben verwenden. Eindeutigen Terminalnamen von CIS besorgen. Den vorher definierten Terminalnamen kann sich ein Programm auch als eindeutigen Terminalnamen von CIS mit folgenden Aufrufen an CISDC32 besorgen: cis_at cis_sr cis_dt ( normal ) Kommando: $D CNTA Antwort: IM01xxxxxxxx (dies ist der Name) Dann wird mit cis_at die Verbindung unter Benutzung des vorher erhaltenen Namens aufgebaut. CIS V A10 Zusatzmanual

20 2.3.2 cis_sr 1. Beschreibung: Diese Funktion sendet Daten zu CIS und empfängt eine Nachricht von CIS. Sie braucht folgende Parameter: - Verbindungsnummer: Dies ist die Nummer der Verbindung. Die Verbindung muß mit der Funktion cis_at erfolgreich aufgebaut worden sein, wobei die Verbindungsnummer zurückgemeldet wurde. - Sendedaten: Dies ist ein CIS-Aktiv-Kommando. Es kann bis zu 3800 Bytes lang sein. Die Daten haben C-Format (Nil am Ende). - Empfangsdaten: In diesem Bereich stehen die von CIS zurückgelieferten Daten. Sie beginnen immer mit der 4-stelligen CM. Beginnt sie mit IM, dann folgen ab dem fünften Byte die Daten (sie können maximal Bytes lang sein). Ist die CM IM80, IM81, IM90 oder IM91, dann folgt eine 15-stellige AZI mit führenden Nullen. Im Fehlerfall steht ab dem fünften Byte die komplette 80-stellige Fehlermeldung mit CM und VM. Die Daten haben C-Format (Nil am Ende). - Fehlertext: Es kann ein Feld angegeben werden, in das CISDC32 Fehler zurückmeldet. Wird ein Null-Pointer übergeben, so gibt CISDC32 die Fehlermeldung unter UNIX auf stderr, unter Windows in eine Message- Box aus. 2. Definition der Funktion: int cis_sr(verb_nr, send_dat, empf_dat. f_text) int verb_nr; Verbindungsnummer (0-15) char *send_dat; Pointer auf Sende-Daten char *empf_dat; Pointer auf Empfangsfeld char *f_text; Pointer auf Bereich für Fehlertext (256 Bytes) oder NULL Bemerkung: Gibt es keinen Bereich für Fehlertext, so kann der Pointer NULL übergeben werden. Die Fehlermeldung wird dann von CISDC32 unter UNIX auf stderr, unter Windows in eine Message-Box ausgegeben. 3. Ergebnis: Bei erfolgreicher Beendigung liefert die Funktion den Wert 0, sonst den Wert Fehler: Fehler werden von CISDC32 in den Bereich, der mit f_text adressiert wird, zurückgemeldet. Wird der Pointer NULL an CISDC32 übergeben, so wird die Meldung unter UNIX auf stderr, unter Windows in eine Message-Box ausgegeben. Der Wert -1 wird zurückgemeldet. CIS V A10 Zusatzmanual

21 2.3.3 cis_dt 1. Beschreibung: Diese Funktion baut eine Verbindung zu einem CIS-Server wieder ab. Die Verbindung muß vorher mit der Funktion cis_at aufgebaut worden sein. Sie braucht folgende Parameter: - Verbindungsnummer: Dies ist die Nummer der Verbindung. Diese Verbindung muß mit der Funktion cis_at erfolgreich aufgebaut worden sein. - Fehlertext: Hier kann ein Feld angegeben werden, in welches CISDC32 Fehler zurückmeldet. Wird ein Null-Pointer übergeben, so gibt CISDC32 die Fehlermeldung unter UNIX auf stderr, unter Windows in eine Message- Box aus. 2. Definition der Funktion: int cis-dt(verb_nr, f_text) int verb_nr; char *f_text; Verbindungsnummer Pointer auf Bereich für Fehlertext (256 Bytes) oder NULL Bemerkung: Gibt es keinen Bereich für Fehlertext, so kann der Pointer NULL übergeben werden. Die Fehlermeldung wird dann von CISDC32 unter UNIX auf stderr, unter Windows in eine Message-Box ausgegeben. 3. Ergebnis: Bei erfolgreicher Beendigung liefert die Funktion den Wert 0, sonst den Wert Fehler: Fehler werden von CISDC32 in den Bereich, der mit f_text adressiert wird, zurückgemeldet. Wird der Pointer NULL an CISDC32 übergeben, so wird die Meldung unter UNIX auf stderr, unter Windows in eine Message-Box ausgegeben. Der Wert -1 wird zurückgemeldet. Keep -Funktion. Soll die Transaktion in CISSRV beibehalten werden, damit das Programm sich später wieder mit cis_at anschließen und weiterarbeiten kann, so ist ein Abmelden mit Keep zu verwenden. Hierzu wird vor dem cis_dt-befehl per cis_sr das CIS-Kommando $@#KEEP gesendet. Die Transaktion wird eine bestimmte Zeit in CISSRV offen gehalten. Diese Zeit ist in CISSRV mit dem Parameter TIMEOUT=n eingestellt. Default-Wert ist 600 Sekunden = 10 Minuten. CIS V A10 Zusatzmanual

22 2.3.4 cis_ln 1. Beschreibung: Diese Funktion liefert Informationen über die maximal zu sendenden und zu empfangenden Bytes. Sie braucht folgende Parameter: - Sendelänge: Es wird die maximale Anzahl der Bytes, die an CIS gesendet werden können, gemeldet. - Empfangslänge: Es wird die maximale Anzahl der Bytes, die vom CIS-Server zurückgesendet werden können, gemeldet. 2. Definition der Funktion: void cis_ln (send,receive) int *send; int *receive; Pointer auf int-feld für Sendelänge Pointer auf int-feld für Empfangslänge 3. Ergebnis: Die Ergebnisse stehen als int-werte in den beiden Feldern. Allerdings darf die Funktion nur zwischen cis_at und cis_dt aufgerufen werden. CIS V A10 Zusatzmanual

23 2.4 Prototypen C-Programme enthalten das Statement #include "cisdc32.h" am Anfang des Programms Visual-Basic- Programme enthalten Declare-Anweisungen für die Aufrufe con CISDC Datei cisdc32.h unter Unix /********************************************************** * * * c i s d c 3 2. h * * * * include-datei fuer Programme, die Funktionen von * * CISDC32 benützen. * * * **********************************************************/ #ifndef NULL #define NULL 0 #endif extern int cis_at (char*, char*, char*), cis_sr (int, char*, char*), cis_dt (int, char*); extern void cis_ln (int*, int*); Datei cisdc32.h unter Windows /********************************************************** * * * c i s d c 3 2. h * * * * include-datei fuer Programme, die Funktionen von * * cisdc benutzen. * * * **********************************************************/ #ifndef NULL #define NULL 0 #endif #define DllImport declspec(dllimport) extern "C" DllImport int WINAPI cis_at (char*, char*, char*); extern "C" DllImport int WINAPI cis_sr (int, char*, char*, char*); extern "C" DllImport int WINAPI cis_dt (int, char*); extern "C" DllImport void WINAPI cis_ln (int*, int*); CIS V A10 Zusatzmanual

24 2.4.3 Declare-Statements für Visual Basiv 4.0 (Datei CISDC32B.TXT) ' ************************************************************************* ' * * ' * Declares fuer cisdc32.dll (fuer MS Visual Basic Vers. 4.0) * ' * * ' * 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 "cisdc32.dll" Alias "_cis_at@12"_ (ByVal s As String, ByVal s As String, ByVal s As String) As Long Declare Function cis_sr Lib "cisdc32.dll" Alias "_cis_sr@16"_ (ByVal l As Long, ByVal s As String, ByVal s As String, ByVal s As String) As Long Declare Function cis_dt Lib "cisdc32.dll" Alias "_cis_dt@8"_ (ByVal l As Long, ByVal s As String) As Long Declare Sub cis_ln Lib "cisdc32.dll" Alias "_cis_ln@8"_ (s As Long, r As Long) Declare-Statements für VBA in Winword 7.0 Declare Function cis_at Lib "CISDC32.DLL" Alias "_cis_at@12" \ (V$ As String, L$ As String, F$ As String) As Integer Declare Function cis_sr Lib "CISDC32.DLL" Alias "_cis_sr@16" \ (i As Integer, K$ As String, A$ As String, F$ As String) As Integer Declare Function cis_dt Lib "CISDC32.DLL" Alias "_cis_dt@8" \ (i As Integer, F$ As String) As Integer CIS V A10 Zusatzmanual

25 2.4.5 Declare-Statements für VBA in Excel 7.0 Deklariere Funktion cis_at Biblio "CISDC32.DLL" Original (AlsWert S Als ZeichenF; AlsWert S Als ZeichenF; AlsWert S Als ZeichenF) Als Ganz Deklariere Funktion cis_sr Biblio "CISDC32.DLL" Original "_cis_sr@16" (AlsWert I Als Ganz; AlsWert S Als ZeichenF; AlsWert S Als ZeichenF; AlsWert S Als ZeichenF) Als Ganz Deklariere Funktion cis_dt Biblio "CISDC32.DLL" Original "_cis_dt@8" (AlsWert I Als Ganz; AlsWert S Als ZeichenF) Als Ganz CIS V A10 Zusatzmanual

26 2.5 Diagnosekommandos für CISDC32 Einige Diagnosekommandos von CIS werden gleich im Modul CISDC32 abgearbeitet. Diese Kommandos beginnen mit "$d x" oder "$D X". Die Antwort wird im allgemeinen Format ausgegeben: 4 Bytes CM: Immer IM00 und 80 Bytes Text : Hier *OK* mit Spaces oder n mal 80 Bytes Text : Wenn es eine Funktion ist. Mögliche Funktionen: Es folgt eine Auflistung der möglichen Aufrufe. Jeder Aufruf kann klein oder groß geschrieben werden. $D X? Help-Funktion. Die möglichen Funktionen werden aufgelistet. Rückmeldung: IM00 Zeilen à 80 Bytes mit der jeweiligen Funktion. $D XLST Liste der Verbindungen ausgeben. Rückmeldung: IM00 Zeilen à 80 Bytes mit den Werten der jeweiligen Verbindung. $D XINFO Allgemeine Infos ausgeben. Rückmeldung: IM00 Zeilen à 80 Bytes mit der jeweiligen Information. $D XLEN Info über maximale Längen ausgeben. Rückmeldung: IM00 LEN-IN=nnnnn/LEN-OUT=nnnnn (+ 54 Spaces) $D XLOG n Logging auf den Wert 0, 1, 2 oder 3 schalten. - 0 : kein Logging - 1 : Logging der Aufrufe - 2 : wie 1 + gesendete Daten - 3 : wie 2 + empfangene Daten Rückmeldung: IM00 *OK* (+ 76 Spaces) $D XDT n Verbindung n abbauen. (Nur nach Rücksprache mit CIS-Team!) Rückmeldung: IM00 *OK* (+ 76 Spaces) $D XS0 n Status 0 für Verbindung n setzen. (Nur nach Rücksprache mit CIS-Team!) Rückmeldung: IM00 *OK* (+ 76 Spaces) $D XRESET CISDC32 initialisieren. (Nur nach Rücksprache mit CIS-Team!) Rückmeldung: IM00 *OK* (+ 76 Spaces) CIS V A10 Zusatzmanual

27 2.6 Ablaufumgebung Verbindungsaufbau Die folgende Abbildung zeigt die Zusammenhänge beim Verbindungsaufbau. Unix / MS Windows 95 / NT Anwender-Programm int cis_at(name,...) Konfigurationsdatei pos name socket cisdc32 TCP/IP socket name partner Rechner station BS2000 DCAM CISSRV Erläuterungen: pos name partner rechner station socket Position in der internen Tabelle, wird bei weiteren Funktionen benützt (schneller Zugriff). Frei gewählter Name für die Verbindung. Vereinbarung zwischen Aufrufer und cisdc32.cfg. Name der DCAM-Name von CISSRV (Anwendungsname im BS2000). IP-Adresse des Rechners oder Name in der Host-Datei. Eindeutiger Name für diesen Partner (1-8 Zeichen). Socket für diese Verbindung.. CIS V A10 Zusatzmanual

28 2.6.2 Nachrichtenverkehr Die folgende Abbildung zeigt die Zusammenhänge im Nachrichtenverkehr. Unix / MS Windows 95 / NT Anwender-Programm cis_sr(pos,.daten,...) pos name socket cisdc32 TCP/IP socket BS2000 DCAM CIS-Daten CISSRV Erläuterungen: pos name partner rechner station socket Position in der internen Tabelle, wird bei weiteren Funktionen benützt (schneller Zugriff). Frei gewählter Name für die Verbindung. Vereinbarung zwischen Aufrufer und cisdc32.cfg. Name der DCAM-Name von CISSRV (Anwendungsname im BS2000). IP-Adresse des Rechners oder Name in der Host-Datei. Eindeutiger Name für diesen Partner (1-8 Zeichen). Socket für diese Verbindung.. CIS V A10 Zusatzmanual

29 2.7 Konfigurationsdatei Allgemeines: Die Konfigurationsdatei enthält allgemeine Einstellungen sowie Beschreibungen der aufzubauenden Verbindungen. Im Modul CISDC32 werden die Verbindungen mit einem Namen angesprochen. Die Konfigurationsdatei weist diesem Namen eine Verbindung zu. Die Verbindung ist durch einen Rechnernamen und durch einen Partnernamen definiert. Desweiteren wird ein eindeutiger Name für den Client benötigt. Wird zum Aufbau der Verbindung ein Paßwort benötigt, so wird es in der Konfigurationsdatei angegeben. Für jede mögliche Verbindung gibt es in der Datei eine Zeile. Die Anzahl, sowie die Art der Einträge ist gegeben durch die Tatsache, daß das ISO-Protokoll nach RFC1006 benutzt wird. Hier wird eine Verbindung grundsätzlich zu Port 102 aufgebaut. Aus diesem Grund muß zusätzlich zum Rechnernamen noch der Name der Anwendung bekannt sein. Der Client-Teil, d.h. das Anwendungsprogramm meldet sich hier nicht mit seiner Portnummer, sondern mit einem für den Rechner (Unix oder Windows) eindeutigen Namen. Name der Datei: Die Datei soll den Namen "cisdc32.cfg" haben. Will man der Datei einen anderen Namen geben, so wird dieser über die Umgebungsvariable CISCFG bekannt gemacht. Diese Datei wird im Verzeichnis gesucht in welchem das Anwenderprogramm läuft. Unter Windows wird sie, sofern nicht gefunden, zusätzlich noch im Systemverzeichnis gesucht. Inhalt der Datei: Jede Zeile der Datei hat das Format: -set:logging=n oder -conn:verb_name=part_name,rechnername,station[,paßwort] - Logging=n Hiermit kann das Logging eingestellt werden. Wird protokolliert, so gehen die Daten in die Datei cislog.txt. Es gibt folgende Werte für n: 0 : kein Logging 1 : Logging der Aufrufe 2 : wie 1 + gesendete Daten 3 : wie 2 + empfangene Daten - verb_name: Dies ist der Name einer Verbindung. Er ist bis zu 16 Zeichen lang. Dieser Name ist ein "logischer Name". Er kann also beim Aufruf von CISDC32 beliebig gewählt werden. Es muß nur sichergestellt sein, daß der Name auch in der Konfigurationsdatei vorhanden ist. - part_name: Dies ist der Name des Partners, d.h. der DCAM-Anwendung CISSRV. Er wird in CISSRV mit dem Parameter APPLI= eingestellt. 1-8 Zeichen, 1. Zeichen alphabetisch. - rechnername: Dies ist der Name des Rechners in der Host-Datei oder im DNS. Es kann auch direkt die IP-Adresse des Rechners angegeben werden. - station: Dies ist ein eigener Name für die CISDC32-Anwendung. Der Name muß auf dem Unix- bzw. Windows-Rechner eindeutig sein. 1-8 Zeichen, 1. Zeichen alphabetisch. CIS V A10 Zusatzmanual

30 - paßwort: Hier kann ein Paßwort angegeben werden, das vom CIS-Server verlangt wird. Stimmt das Paßwort nicht, so nimmt der CIS-Server den Verbindungswunsch nicht an. Das Paßwort besteht aus 1 bis 16 beliebigen abdruckbaren Zeichen. CIS V A10 Zusatzmanual

31 2.8 Umgebungsvariable Folgende zwei Umgebungsvariable werden von CISDC32 jeweils bei der Funktion cis_at ausgewertet: - LANG : Sprache für Fehlermeldungen (nur Unix). Enthält LANG den String De, so werden deutsche Fehlermeldungen ausgegeben. Im anderen Fall englische. - CISCFG : Name der Konfigurationsdatei. Diese Umgebungsvariable enthält den Namen der Konfigurationsdatei. Fehlt die Umgebungsvariable, so wird als Name der Datei "cisdc32.cfg" angenommen. CIS V A10 Zusatzmanual