BCAT-FTP1-03. IBM Österreich. BusinessContact/FTP. Kommunikation. Benutzerhandbuch

Transkript

1 BCAT-FTP1-03 IBM Österreich BusinessContact/FTP Kommunikation Benutzerhandbuch

2 Dieses Dokument wurde erstellt von: Wilhelm Reitberger, Michael Höller Mail: Erstellt am 23. November 1998 Letzte Änderung am 26. Februar

3 Inhaltsverzeichnis 1. ALLGEMEINES Übersicht Voraussetzungen Netzverbindung zur Mailbox Software beim Kunden Funktionen Installationsarbeiten BENUTZUNG Die FTP-Befehle Die BC/FTP Dateien Commanddateien Anfangsbuchstabe 'C' Bearbeitete Commanddateien Anfangsbuchstabe 'J' Fehlerdateien Anfangsbuchstabe 'E' (Error) Sendedateien Anfangsbuchstabe 'S' (Send) Empfangsdateien Anfangsbuchstabe = 'R' (Receive) Datenaustauschprotokolldateien Anfangsbuchstabe 'P' (Prot.) Empfehlungen Handhabung Verarbeitungszeit am Server Integration in EDI Anwendungen INHALT UND AUFBAU DER BEFEHLSDATEI Schlüsselworte und Parameterangaben Parameter, die für spezielle Aufgaben benötigt werden (z.b. Senden Sonstige Daten zum IE- Gateway): BEISPIELE ZU BC/FTP FTP Verbindungsaufbau Senden zur Mailbox Empfangen von der Mailbox Passwortdialoge Passwortänderung Passwort ist abgelaufen AKTUELLES Passwort ist falsch Normaler Passwort Änderungsdialog Sonderfall: NEUES Passwort bei Passwortänderung ist nicht erlaubt Sonderfall: Benutzernummer ist gesperrt Sonderfall: Benutzernummer ist nicht im System definiert

4 1. Allgemeines 1.1. Übersicht IBM BusinessContact/FTP (BC/FTP) ist ein Gatewayprogramm, welches es EDI Service-Anwendern ermöglicht, mittels Standard TCP/IP-Filetransfer-Programmen (FTP) mit den EDI Mailbox-Services IBM BusinessContact und IBM ECODEX Daten auszutauschen. Beispiele für Standard FTP-Programme sind die FTP- Funktionen, die praktisch jedes gängige Unix-, PC- und Host System meist schon als Betriebssystem Grundfunktion anbietet. Die Regeln für FTP-Programme sind in dem Dokument RFC 959 allgemein verfügbar. Die nachfolgende Beschreibung bezieht sich nur auf folgende EDI-Mailbox-Systeme: ECODEX ECODEX ist der EDI-Service von EAN Austria für ihre Kunden. IBM BusinessContact BusinessContact ist ein EDI-Service von IBM Österreich Voraussetzungen Netzverbindung zur Mailbox Das beschriebene FTP-Gateway ist nur über das abgesicherte IBM Multiprotokoll Netzwerk erreichbar. Dieses Netz wird von der Fa. AT&T betreut und gewartet. Technischer Zugang zu diesem Netz ist möglich über: Standleitungsverbindung zum AT&T Multiprotokoll-Netzwerk für IBM Kunden (MPN): Beim Kunden wird von AT&T ein Router installiert (Konfiguration und Wartung durch AT&T), der über Poststandleitung zum AT&T Multiprotokollnetz verbunden ist. Wählleitungsverbindung zum AT&T Multiprotokoll-Netzwerk (TCP/IP Dial Service): Anschlußmöglichkeit über asynchrone Modems oder ISDN. Zutrittskontrolle erfolgt über Benutzernummern und Passwort. Protokoll: PPP und PAP Authentifizierung (Standard Windows Internet Dial) - 4 -

5 AT&T bietet für die gängigen Windowsversionen ein optional verwendbares Einwahl-Modul mit komfortablen Zusatzfunktionen zum Download an. Die IP-Adresse des FTP-Gateways im Produktionsbetrieb ist Software beim Kunden Der Kunde, der dieses Service benutzen möchte, muß ein FTP-Programm verwenden, welches zumindest die einfacheren FTP-Befehle unterstützt und mit dem von IBM im Betriebssystem OMVS zur Verfügung gestellten TCP/IP FTP-Serverprogramm kompatibel ist Funktionen alle von IBM BusinessContact Mailbox Service angebotenen Funktionen werden auch von diesem BC/FTP Interface unterstützt. die Benutzernummer (sog. RACF Userid) im BusinessContact oder ECODEX Mailbox Service wird auch für das BC/FTP Gateway als FTP-Benutzernummer verwendet. die Mailbox-Verarbeitungsbefehle werden in einfacher, variabler Form in eine Befehlsdatei gestellt und an den BC/FTP Server als Datei geschickt. Unterscheidung der Art der Dateien (Befehlsdatei, Datenaustausch-Protokoll- Datei, Sendedatei, Empfangsdatei etc.) erfolgt über den Anfangsbuchstaben der Datei. das Interface prüft laufend die an das Gateway gesendeten Dateien und jede Befehlsdatei löst eine Verarbeitung im Mailbox-Service aus. die entstehenden Dateien tragen denselben Namen wie die Befehlsdatei (ausgenommen natürlich der Anfangsbuchstabe) Protokollierung der Verarbeitung am FTP-Gateway. Es wird auch im Verzeichnis des Benutzers eine Log-Datei mitgeführt Installationsarbeiten Bei Wählleitungszugang wird vom EDI Servicebetreiber eine Netzbenutzernummer zugewiesen. Damit wird die Anwahl eingerichtet. In jedem Fall wird von IBM eine Mailbox (= FTP Benutzernummer) eingerichtet, die zum Login notwendig ist. Auf Wunsch wird von IBM eine Testdatei (1 MB) nach den EDIFACT Syntaxregeln in die Mailbox des Kunden gestellt, die er abholen und für eigene Tests (Sendetest) verwenden kann

6 2. Benutzung 2.1. Die FTP-Befehle WICHTIG: Achten Sie bei Dateinamen immer auf Groß-/Kleinschreibung und übertragen Sie die Dateien im binary-filemode (Befehl binary). Anmerkung: Dies ist nur ein Überblick. Die genaue Beschreibung der Befehle entnehmen Sie bitte der Dokumentation Ihres verwendeten FTP-Clientprogrammes. ls [Dateiname] Der ls-befehl zeigt alle Ihre Dateien auf dem BC/FTP-Server in Kurzform an. Sie können Platzhalterzeichen ('*' oder '?') verwenden. dir [Dateiname] Der dir-befehl zeigt Dateinamen und Dateigrößen an (ähnlich dem dir-befehl unter DOS). put Dateiname_lokal [Dateiname_server] Der put-befehl überträgt eine einzelne Datei von Ihrem Rechner auf den BC/FTP-Server. Es besteht die Möglichkeit, einen Dateinamen für die auf dem Server zu speichernde Datei zu vergeben. Es dürfen keine Platzhalterzeichen verwendet werden. mput Dateiname_lokal Der mput-befehl kann mehrere Dateien mit einem Befehlsaufruf auf den Server übertragen und erlaubt die Benutzung von Platzhalterzeichen: mput S971009* mput C C get Dateiname_Server [Dateiname_lokal] Dieser Befehl erlaubt es Ihnen, eine gewünschte Datei auf Ihren Rechner zu übertragen. Die Datei wird mit folgendem Befehl auf Ihrem Rechner unter dem Namen Datei01 abgespeichert (ohne Angabe des zweiten Parameters behält die Datei ihren ursprünglichen Namen): get P Datei01.txt - 6 -

7 Der get-befehl kann auch dazu verwendet werden, um eine Datei, ohne sie auf den eigenen Rechner zu übertragen, auf dem Bildschirm auszugeben. Das Minus- Zeichen dient in Verbindung mit dem get-befehl diesem Zweck: get P Anmerkung: Um im Standard-FTP-Client von DOS/Windows fortlaufende Textausgabe zu unterbrechen, müssen Sie die Textkombination [Strg]+[S] drücken. [Strg] +[Q] bewirkt die Fortsetzung der Textausgabe. mget Dateiname_Server Mit dem mget-befehl können Sie mehrere Dateien auf Ihren Rechner übertragen. Selbstverständlich sind hierbei Platzhalterzeichen erlaubt. delete Dateiname_Server Der delete-befehl erlaubt es Ihnen, einzelne Dateien auf dem Server zu löschen. mdelete Dateinamen_Server Mit dem mdelete-befehl können Sie mehrere Dateien auf einmal löschen. Platzhalterzeichen sind hierbei möglich. Vorsicht ist geboten. quit oder bye Die beiden Befehle beenden die FTP-Verbindung. Sonstiges Wenn Sie eine Datenübertragung vorzeitig abbrechen wollen, so müssen Sie die Tastenkombination [Strg]+[C] drücken Die BC/FTP Dateien Bei BC/FTP gibt es grundsätzlich 6 verschiedene Dateiarten. Jede Datei ist durch ihren Anfangbuchstaben eindeutig zuzuordnen. WICHTIG: Die Anfangsbuchstaben werden stets groß geschrieben Commanddateien Anfangsbuchstabe 'C' Diese Dateien müssen immer von Ihnen erzeugt werden und enthalten Informationen über den von Ihnen gewünschten Verarbeitungsvorgang. Die Informationen werden durch die Kombination Schlüsselwort und Parameter angegeben, z.b.: schlüsselwort(parameter) schlüsselwort(parameter) - 7 -

8 Alle Angaben können in Groß- und Kleinbuchstaben geschrieben werden. Die Angaben können je nach Belieben in einer oder mehreren Zeilen stehen. Weiters besteht die Möglichkeit, Kommentare einzufügen. Kommentarzeilen werden durch einen '*' in der ersten Stelle der Zeile gekennzeichnet. Die Schlüsselworte "Ser" (für Service) und "Typ" (Datentyp) sind natürlich für die Verarbeitung im Mailboxservice notwendig. Fehlt eine dieser beiden Angaben, dann wird folgendes angenommen: Default Datentyp = E (Edifact) Default Service = W (Mailboxabfrage) Möglicher Aufbau einer Commanddatei: * Hier können Sie Kommentare einfügen * S = Senden E = EDIFACT Ser(S) Typ(E) Bearbeitete Commanddateien Anfangsbuchstabe 'J' Wurde ein Commanddatei erfolgreich bearbeitet, so ändert sich ihr erster Buchstabe in ein 'J'. Man kann damit sofort erkennen, dass die Commanddatei vom Server bearbeitet wurde. Der Dateiinhalt wird hierbei nicht verändert. Somit besteht die Möglichkeit, die Datei zu einem späteren Zeitpunkt durch Umbenennen in eine Commanddatei wieder zu aktivieren. Falls Sie die bearbeitete Commanddatei nicht mehr benötigen, sollten Sie diese mit dem delete-befehl löschen Fehlerdateien Anfangsbuchstabe 'E' (Error) Falls ein Fehler bei der Bearbeitung einer Commanddatei auftritt, der die Weiterverarbeitung unmöglich macht (zum Beispiel fehlende Datendatei beim Sender von Daten), so ändert sich der erste Buchstabe in 'E'. Tritt dieser Fall ein, dann lesen Sie am besten in der Logdatei (siehe weiter unten) nach, woran die Verarbeitung gescheitert ist Sendedateien Anfangsbuchstabe 'S' (Send) Falls Sie Dateien mittels BC/FTP senden wollen, so muß der Dateiname mit dem der Commanddatei, der erste Buchstabe natürlich ausgenommen, übereinstimmen. WICHTIG: Die Sendedatei muß vor der Commanddatei übertragen werden! - 8 -

9 Beispiel: Commanddatei: C Sendedatei: S Empfangsdateien Anfangsbuchstabe = 'R' (Receive) Wollen Sie Dateien empfangen, so entsteht nach der Bearbeitung der Commanddatei eine Receivedatei. Stehen keine Daten in der Mailbox für Sie bereit, so hat die Receivedatei eine Dateigröße von 0 Byte Datenaustauschprotokolldateien Anfangsbuchstabe 'P' (Prot.) Bei jeder Bearbeitung einer Commanddatei wird ein Datenaustauschprotokoll erstellt. Näheres darüber finden Sie im ECODEX- bzw. im BusinessContact Benutzerhandbuch Empfehlungen Löschung der Daten Der Übersichlichkeit wegen sollten nach jedem abgeschlossenem Übertragungsvorgang die nicht mehr benötigten Dateien auf dem BC/FTP-Server gelöscht werden. Dateien, die älter als 5 Tage sind, werden automatisch vom FTP Gateway entfernt. Namensgebung Es wird erwartet, daß jeder Verarbeitungsvorgang eine eindeutige Dateikennung verwendet. Am Server wird jede Verarbeitung mitprotokolliert, die Auswertung der entstehenden Log-Dateien durch den Helpdesk ist ohne Eindeutigkeit der gesendeten Command-Dateien nicht detailliert möglich. Beispiel für Namensgebung: - 9 -

10 Format: wobei: Cjjmmttn.nnn C = Dateiart für Commanddatei jjmmtt = Erstellungsdatum der Commanddatei n.nnn = laufende Nummer pro Tag also z.b. C Commanddatei 25 vom S dazugehörende Sendedatei oder C Commanddatei S dazugehörende Sendedatei 2.3. Handhabung Verarbeitungszeit am Server Der Server prüft in kurzen Abständen auf das Vorhandensein einer Commanddatei im Verzeichnis des Benutzers. Nachdem eine Commanddatei gefunden wurde, versucht der Server, die Daten an das Mailboxsystem zu senden (oder von dort zu holen). Es kann damit gerechnet werden, dass abhängig von den Dateigrößen die Verarbeitung binnen einiger Minuten abgeschlossen ist. Wenn das Mailboxservice z.b. im Falle von Wartungsarbeiten nicht verfügbar ist, bleibt der Commandfile solange unbearbeitet, bis das Mailboxservice wieder aktiv wird Integration in EDI Anwendungen Im Gegensatz zu anderen BusinessContact-Schnittstellen erfolgt die Verarbeitung hier nicht im direkten Dialog zwischen Client und Mailboxserver, sondern in zwei Schritten. Daher ist diese Art der Mailbox-Verbindung etwas schwieriger in die EDI Abläufe einzubinden. Zur Automatisierung von FTP-Abläufen gibt es am Markt verfügbare Produkte

11 3. Inhalt und Aufbau der Befehlsdatei 3.1. Schlüsselworte und Parameterangaben Die Spalte Kurz zeigt die mögliche Alternativangabe für das Schlüsselwort. Nähere Angaben zu den einzelnen Parametern sind im ECODEX- oder BusinessContact-Handbuch zu finden. Alle Parameter sind optional. Werden Service oder Typ nicht angegeben, werden die Default-Einstellungen verwendet. Befehl Kurz Parameter Service ser() typ() s() t() S Senden H Holen W Abfrage Mailboxinhalt (DEFAULT) F Status der gesendeten Daten R Reaktivieren (nur in Verbindung mit Datum) L Löschen (nur in Verbindung mit Datum) Typ der Daten E EDIFACT (DEFAULT) B Sedas BESTELLDATEN R Sedas RECHNUNGEN S Sonstige A Abrechnungsdaten D Verteilerlisten Service Zusatzangabe (ECODEX Handbuch; siehe Prüf). P nur Prüflauf (nur bei SEDAS Bestellungen) so() z() 1 nur 1 Interchange (UNA UNZ) holen (nur bei EDIFACT Holen) U nur Unabgeholte Daten bei ser(w) oder ser(f) anzeigen yymmdd() y() Datum für Reaktivieren im Format JJMMTT, z.b. y(971009) VON-Paketnummer beim Reaktivieren fromi() v() Paketnummer: ist die Angabe, die im Datenaustauschprotokoll unter LFD.NR aufscheint. toi() w() BIS-Paketnummer beim Reaktivieren umc() m() User Message Class ack() b() Acknowledgement (Empfangsbestätigungsanforderung)

12 3.2. Parameter, die künftig NICHT mehr verwendet werden können: Planungsinformation: die folgenden Parameter und generell die Varianten für "Sonstige Daten" werden in zukünftigen österreichischen EDI Serviceangeboten NICHT mehr unterstützt werden. Für alle Information Exchange Anwendungen ist dann ein Information Exchange Client (z.b. Expedite Serie, IE/FTP etc.) zu verwenden. folgende Parameter sind nur für Senden Sonstige Daten in Verbindung mit der internationalen IE Mailbox verwendbar Befehl Kurz Parameter pas() p() Information Exchange Passwort darf nur angegeben werden, wenn die eigene IE Benutzernummer auch angegeben werden muß z.b: beim Versenden von Sonstigen Daten über IE-Gateway acc() a() Information Exchange Account-ID use() u() Information Exchange UserID new() n() Information Exchange Neues Passwort dac() d() Information Exchange Account-ID des Empfängers (Destination Account-ID) dus() e() Information Exchange Destination User-ID dno() f() Destination IE-System

13 4. Beispiele zu BC/FTP 4.1. FTP Verbindungsaufbau >ftp Connected to FTPD1 IBM FTP CS V2R10 at viemvsc, 15:53:15 on Connection will close if idle for more than 60 minutes. User ( :(none)): $uuuuuuu 331 Send password please. Password: 230 $uuuuuu is logged on. Working directory is "/usr/local/bc/ftp/...". ftp> binary <========== optional 200 Representation type is Image 4.2. Senden zur Mailbox Nehmen wir an, Sie wollen die Datei RECHNG.EDI senden. Folgende Schritte sind dafür notwendig: Commandfile erzeugen Zuerst müssen Sie auf Ihrem Rechner mit einem Editor einen Commandfile erzeugen. Der Dateiname dieser Datei ist z.b. C , der Inhalt muß folgendermassen aussehen: Typ(E) Ser(S) Starten einer FTP-Sitzung zum BC/FTP-Server Beim Standard FTP-Client von Windows würde mit folgendem Befehl eine Sitzung mit dem BC/FTP-Server aufgebaut: ftp Nach dem Verbindungsaufbau wird der Benutzer nach Username und Passwort befragt. Senden der Datendatei (unbedingt VOR der Commanddatei senden da die Datendatei vollständig im Directory stehen muß) put RECHNG.EDI S Senden der Commanddatei put C

14 Abfrage auf Verarbeitung ls? Falls die Bearbeitung bereits stattgefunden hat, sollten nun folgende Dateinamen ausgegeben werden: J P Empfangen der Protokolldatei get P Löschen der Dateien am Server mdelete? Beenden der FTP-Sitzung bye oder quit 4.3. Empfangen von der Mailbox Commandfile erzeugen Wieder muß eine Commanddatei mit einem Editor erstellt werden. Der Dateiname ist z.b. Cholen, der Inhalt folgender: Ser(H) Typ(E) Starten einer FTP-Sitzung zum BC/FTP-Server Beim Standard FTP-Client von Windows würde mit folgendem Befehl eine Sitzung mit dem BC/FTP-Server aufgebaut: ftp Nach dem Verbindungsaufbau wird der Benutzer nach Username und Passwort befragt. Senden der Commanddatei Zum Übertragen der Commanddatei, die wir diesesmal gleich umbenennen wollen, dient wieder der FTP-put-Befehl: put Cholen C Abfrage auf Verarbeitung ls? Nach erfolgreicher Bearbeitung sollten folgende Dateien vorhanden sein: J P R Empfangen der Dateien Mit dem FTP-mget-Befehl übertragen Sie alle 3 Dateien: mget?

15 Löschen der Dateien am Server mdelete? Beenden der FTP-Sitzung bye oder quit 4.4. Passwortdialoge WICHTIGER HINWEIS: die folgenden Dialoge sind NICHT FIXER Bestandteil von BC/FTP sondern entsprechen der derzeitigen Implementierung auf der IBM OMVS Plattform. Bei Wechsel des Mailbox-Service auf andere Server Plattformen ÄNDERN sich diese Meldungen gemäß dem dort implementierten FTP ServerModul und von den Kunden müssen gegebenenfalls automatisierte Prozesse angepaßt werden Passwortänderung erfolgt durch zweimalige Angabe eines neuen Passwortes nach der FTP Meldung 331: 331 Send password please. Password: altespasswort/neuespasswort/neuespasswort Passwort ist abgelaufen C:\BC\HOST>ftp Connected to FTPD1 IBM FTP CS V2R8 at viemvsc, 17:41:54 on Connection will close if idle for more than 60 minutes. User ( :(none)): $myv Send password please. Password: 530 PASS command failed - passwd() error : EDC5168I Password has expired. Login failed. ftp> AKTUELLES Passwort ist falsch ftp Connected to FTPD1 IBM FTP CS V2R8 at viemvsc, 17:54:33 on Connection will close if idle for more than 60 minutes

16 User ( :(none)): $myv Send password please. Password: 530 PASS command failed - passwd() error : EDC5111I Permission denied. Login failed. ftp> Normaler Passwort Änderungsdialog C:\BC\HOST>ftp Connected to FTPD1 IBM FTP CS V2R8 at viemvsc, 17:56:02 on Connection will close if idle for more than 60 minutes. User ( :(none)): $MYV Send password please. Password: 530 PASS command failed - passwd() error : EDC5168I Password has expired. Login failed. ftp> user $myv Send password please. Password: 230-Password has been changed. 230 $MYV01 is logged on. Working directory is "...". ftp> Sonderfall: NEUES Passwort bei Passwortänderung ist nicht erlaubt In diesem Fall müssen Sie das neue Paswort so wählen, daß es nicht trivial ist - mindestens 6 Stellen lang - mindestens eine Ziffer, aber nicht an Stelle 1 - keine 3 Zeichen aus der Benutzernummer - keine 3 Zeichen aus dem letzten Passwort - keine 3 gleichen Zeichen (4 bei Länge 7 od. 8) - kein früher verwendetes Passwort Password:

17 530 PASS command failed - passwd() error : EDC5169I Password is invalid. Login failed. ftp> Sonderfall: Benutzernummer ist gesperrt In diesem Fall müssen Sie den EDI Helpdesk kontaktieren. 331 Send password please. Password: 530 PASS command failed - passwd() error : EDC5163I SAF/RACF extract error. Login failed. ftp> Sonderfall: Benutzernummer ist nicht im System definiert In diesem Fall verständigen Sie bitte den EDI Helpdesk. C:\BC\test\ftp>ftp Connected to FTPD1 IBM FTP CS V2R8 at viemvsc, 18:04:27 on Connection will close if idle for more than 60 minutes. User ( :(none)): xyzz 331 Send password please. Password: 530 PASS command failed - passwd() error : EDC5143I No such process. Login failed. ftp>