FTP Communication Jobs

Transkript

1 FTP Communication Jobs auf IBM iseries Administration Guide Stand: 20. April 2006 FTP Communication Jobs Seite 1

2 Zweck und Funktionen Die Anwendung FTP Communication Jobs ist ein Tool zur Steuerung periodischer Datenübertragungen per FPT. In einer Stammdatei können beliebig viele Jobs angelegt werden. Die Jobs werden mit einem Dienstprogramm gestartet und bleiben solange aktiv, bis sie wieder mit einem Dienstprogramm beendet werden. Für jeden Job sind in der Stammdatei alle für die FTP-Kommunikation relevanten Daten gespeichert. Außerdem enthält die Datei bestimmte Felder zur Steuerung der Jobs. Bei den Jobs handelt es sich immer um FTP-Client-Operationen, die entweder Daten aus dem IFS der iseries zu einem FTP-Server senden (FTP-PUT-Funktion) oder Daten von einem FTP-Server abholen (FTP-GET-Funktion) und in ein Verzeichnis im IFS der iseries stellen. Auf den FTP-Server übertragene Daten können (optional) in ein Sicherungsverzeichnis des lokalen Systems übertragen werden oder werden aus dem Quellenverzeichnis entfernt. Übernommene Daten werden auf dem FTP-Server entfernt. Mit der Spezifikation generischer Namen können Dateien selektiert werden. Es können Hilfsprogrammen spezifiziert werden, mit welchen Dateien bei der Übertragung umbenannt werden können. Es können Anwendungsprogramme spezifiziert werden, die nach der Übertragung einer Datei ausgeführt werden sollen, um z.b. die übertragenen Daten sofort weiterzuverarbeiten. Die Zeiten der Datenübertragung können wie folgt spezifiziert werden: Wochentag der Übertragung Zeitfenster (von Zeit bis Zeit) der Übertragung Zeitintervall, in welchem die Übertragung ausgeführt werden soll Max. 6 feste Uhrzeiten pro Tag, an denen die Übertragung stattfinden soll. Die Jobs können zur Ausführung in beliebige Jobwarteschlangen übertragen werden. Zur Verwaltung der Job-Spezifikationen und zur Überwachung der Job-Aktivitäten, incl. der Problemanalyse, stehen Dialogprogramme zur Verfügung, die mit dem Befehl WRKFTPCMN aufgerufen werden können. Die Quellen und Objekte der Anwendung stehen in der Bibliothek GASS, können aber auch in jede andere Bibliothek übertragen werden. Zur Ausführung der Programme muss sich die Bibliothek GSL in der Bibliothekssuchliste befinden. FTP Communication Jobs Seite 2

3 Work with FTP Communication Jobs Der Programmaufruf erfolgt mit dem Befehl WRKFTPCMN Im ersten Format kann ein bestimmter Job oder eine Gruppe von Jobs (über generischen Namen) ausgewählt werden. FTPD100 Work with FTP Communication Jobs Type choices, press Enter. Jobname *ALL Name, generic*, *ALL F3=Exit Die ausgewählten Jobs werden in folgendes Arbeitsformat übertragen: FTPD001 Work with FTP Communication Jobs Type choices, press Enter. 1=Create 2=Edit 4=Delete 5=Display 6=Start job 7=End job 8=Reset error 9=DspErrMsg Opt. Type Job Description Status Ended SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAA *ABNORMAL _ RCV AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAA *NORMAL _ SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAA *ABNORMAL _ RCV AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAA *NORMAL F3=Exit F5=Refresh F6=Start all F7=End all Weitere. Auswahl 1 = Create Mit der Auswahl 1 können neue FTP Communication Jobs erfasst werden. Benutzer müssen für diese Änderungsfunktionen durch einen Eintrag mit Objektberechtigung *ALL in der Systemberechtigungsliste FTPCMNJOB explizit berechtigt sein oder ihr Benutzerprofil muss *ALLOBJ-Berechtigung haben. Die Schlüsselfelder Type und Job müssen im Arbeitsformat eingegeben werden und sind hinterher nicht mehr änderbar. Dir Job Gibt die Übertragungsrichtung an. Mögliche Angaben sind: SND Übertragung vom lokalen System auf einen FTP-Server. RCV Übertragung vom FTP-Server zum lokalen System. Eindeutiger Name zu Identifizierung des Jobs. Unter diesem Namen wird der Job gestartet und ausgeführt. FTP Communication Jobs Seite 3

4 FTPD102 Work with FTP Communication Jobs (Create) Job : AAAAAAAAAA Type: SND Type information, press Enter. Description... Remote system.. Logon User ID.. Logon password Job user..... Remote pathname Local pathname Description Text zum FTP-Communication-Job Remote system Hostname oder IP-Adresse des FTP-Servers, mit dem dieser Communication-Job den Datenaustausch durchführen soll. Logon User ID Benutzerprofil, mit welchem sich der Communication-Job auf dem FTP-Server anmelden soll. Logon password Password, mit welchem sich der Communication-Job auf dem FTP-Server anmelden soll. Job user Benutzerprofil, unter welchem der Communication-Job ausgeführt werden soll. Remote pathname Pfadname des Verzeichnisses auf dem entfernten System, in welches die Dateien übertragen werden sollen, bzw. von welchem Daten geholt werden sollen. Local pathname Pfadname des Verzeichnisses auf dem lokalen System, aus welchem die Dateien zur Übertragung geholt werden sollen, bzw. in welches übertragenen Daten vom FTP- Server gestellt werden sollen. FTP Communication Jobs Seite 4

5 FTPD111 Work with FTP Communication Jobs (Create) Job : AAAAAAAAAA Type: SND Type information, press Enter. Save dir pathname *NONE File name.... File rename Pgm *NONE Library.... Exit Pgm..... *NONE Library.... Fix parameter.. Job queue.... Library.... Error msg queue Library.... Save dir pathname Pfadname des Verzeichnisses auf dem lokalen System, in welches die Dateien nach der Übertragung an den FTP-Server zur Sicherung gestellt werden sollen oder *NONE, wenn keine Sicherung erfolgen soll. Bei Einträgen mit Direction RCV bewirkt diese Eintragung keine automatische Übertragung durch den FTP-Communcation-Job, sondern muss ggf. von einem Anwendungsprogramm (in Exit Pgm spezifiziert) zur Sicherung dort hin übertragen werden. File name Dateiname zur Auswahl der zu übertragenden Dateien im Quellenverzeichnis. Es kann auch ein generischer Name eingetragen werden. Generische Namen enthalten einen Stern als Ersatzwert. z.b. *.CSV oder INP*. Ausnahme: Der Eintrag *.* überträgt alle existierenden Dateien. File Rename Pgm Library Name und Bibliothek eines Anwendungsprogramms, mit welchem Dateien bei der Übertragung umbenannt werden können. Es erhält als Eingangsparameter den Namen der existierenden Datei und gibt im Ausgabeparameter einen Namen zurück, in welchen die Datei umbenannt werden soll. Der Communication-Job benennt die Datei entsprechend um und zwar vor der Übertragung an den FTP-Server auf dem lokalen System oder nach der Übertragung vom FTP-Server auf dem lokalen System. Exit Pgm Library Name und Bibliothek eines Anwendungsprogramms, welches nach der Übertragung von Daten auf dem lokalen System aufgerufen werden soll. Es erhält als Eingabeparameter den Namen des Jobs, den Namen der übertragenen Streamfile und einen Fixparameter (Inhalt aus u.g. Feld Fix parameter ). Das Programm dient i.d.r. zur Weiterverarbeitung der übertragenen Daten oder kann auf dem entfernten System (mit entsprechenden Remote-Befehlen) eine solche Verarbeitung auslösen. FTP Communication Jobs Seite 5

6 Fix parameter In diesem Parameter, der dem Exit-Programm übergeben wird, wird i.d.r. die Firmennummer des Mandanten und ggf. weitere Kennzeichen zur Steuerung des Anwendungsprogramms übergeben. Für GEFIS-Programme wird hier der GASS-Call- Parameter hinterlegt. Job queue Library Name und Bibliothek der Jobwarteschlange, in welche der Communication-Job zur Ausführung übertragen wird. Error msg queue Library Name und Bibliothek der Nachrichtenwarteschlange, an welche Fehlermeldungen gesendet werden sollen. FTPD111 Work with FTP Communication Jobs (Create) Type information, press Enter. Schedule days.. MO TU WE TH FR SA SU Time window... from 0000 to 2400 Interval time.. Minutes Exec times... Status..... *LOCKED *FREE, *LOCKED Schedule days In diesem Feld wird spezifiziert, an welchen Wochentagen der Communication-Job Datenübertragungen durchführen soll. Die Reihenfolge der Angabe im Eingabefeld ist unerheblich; der Tag wird immer aufgrund des Namens identifiziert. Gültige Wochentagnamen sind (MO, TU, WE, TH, FR, SA, SU) Time window In diesem Feld wird spezifiziert, in welchem Zeitfenster (von Uhrzeit bis Uhrzeit) der Communication-Job Datenübertragungen durchführen soll. Werden hier Zeiten spezifiziert, dürfen in den u.g. Feldern für Exec times keine Angaben gemacht werden. Interval time Gibt an, in welchen Zeitabständen (in Minuten) der Communication-Job das Quellenverzeichnis auf zu übertragende Dateien prüfen soll. Wird hier ein Wert spezifiziert, dürfen in den u.g. Feldern für Exec times keine Angaben gemacht werden. Wurden in den u.g. Feldern für Exec times keine Angaben gemacht, muss hier eine Intervallzeit angegeben werden. Exec times Hier können maximal 6 Uhrzeiten (im Format HHMM) angegeben werden, an denen täglich der Communication-Job das Quellenverzeichnis auf zu übertragende Dateien prüfen soll. Die Differenzzeit zwischen den Zeiteinträgen in den Feldern muss mindestens 15 Minuten sein. Wird hier ein Wert spezifiziert, dürfen in den o.g. Feldern für Time window und Interval time keine Angaben gemacht werden. FTP Communication Jobs Seite 6

7 Status Gibt an, ob der Communication-Job aktiv oder inaktiv sein soll. Ist er inaktiv, kann er nicht gestartet werden. Beim Starten der Jobs mit der Option *ALL werden inaktive Einträge ignoriert. Mögliche Angaben sind: *LOCKED = inaktiv *FREE = aktiv Auswahl 2 = Edit Mit der Auswahl 2 können bestimmte Datenfeldinformationen geändert werden. Benutzer müssen für diese Änderungsfunktionen durch einen Eintrag mit Objektberechtigung *ALL in der Systemberechtigungsliste FTPCMNJOB explizit berechtigt sein oder ihr Benutzerprofil muss *ALLOBJ-Berechtigung haben. FTPD102 Work with FTP Communication Jobs (Change) Job : AAAAAAAAAA Type: SND Status..... : AAAAAAAAAAAA *NOMAL Last start... : /11:32:28/NNNNNN/KOESSLER/JJJJJJJJJJ Last end.... : /11:32:28 Type changes, press Enter. Description... AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Remote system.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Logon User ID.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Logon password AAAAAAAAAA Job user..... AAAAAAAAAA Remote pathname Local pathname FTPD102 Work with FTP Communication Jobs (Change) Job : AAAAAAAAAA Type: SND Type changes, press Enter. Save dir pathname *NONE File name.... AAAAAAAAAAAAAAAAAAAA File rename Pgm AAAAAAAAAA Library.... AAAAAAAAAA Exit Pgm..... AAAAAAAAAA Library.... AAAAAAAAAA Fix parameter.. AAAAAAAAAAAAAAAAAAAA Job queue.... AAAAAAAAAA Library.... AAAAAAAAAA Error msg queue AAAAAAAAAA Library.... AAAAAAAAAA FTP Communication Jobs Seite 7

8 FTP102 Work with FTP Communication Jobs (Change) Type changes, press Enter. Schedule days.. MO TU WE TH FR SA SU Time window... from HHMM to HHMM Interval time Minutes Exec times... HHMM HHMM HHMM HHMM HHMM HHMM Status..... *LOCKED *FREE, *LOCKED Auswahl 4 = Delete Benutzer müssen für diese Änderungsfunktionen durch einen Eintrag mit Objektberechtigung *ALL in der Systemberechtigungsliste FTPCMNJOB explizit berechtigt sein oder ihr Benutzerprofil muss *ALLOBJ-Berechtigung haben. FTPD101 Work with FTP Communication Jobs Press Enter to confirm your choices for Delete. Press to return to change your choices. Type Job Description Status Ended SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAA *NORMAL Auswahl 5 = Display Die Bildschirmformate zur Anzeige der Stammdaten ist analog zu den o.g. Formaten im Änderungsmodus. Es können jedoch keine Daten verändert werden. Für diese Anzeigefunktion gibt es keine Berechtigungsprüfungen. Auswahl 6 = Start job Der Start eines Communication-Jobs ist nur im Status *INACTIVE und nur bei der Beendigung *NORMAL zulässig. Ist die Beendigung *ABNORMAL, muss der Job zunächst mit der Auswahl 8 (=Reset error) auf Beendigung *NORMAL zurückgesetzt werden. FTPD001 Work with FTP Communication Jobs Press Enter to confirm your choices for starting jobs. Press to return to change your choices. Type Job Description Status Ended SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA *INACTIVE *NORMAL FTP Communication Jobs Seite 8

9 Auswahl 7 = End job Das Beenden eines Communication-Jobs ist nur im Status *ACTIVE zulässig. FTPD001 Work with FTP Communication Jobs Press Enter to confirm your choices for ending jobs. Press to return to change your choices. Type Job Description Status SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA *ACTIVE Auswahl 8 = Reset error Das Zurücksetzen eines Communication-Jobs ist nur im Status *INACTIVE und Beendigung *ABNORMAL zulässig. FTPD001 Work with FTP Communication Jobs Press Enter to confirm your choices for resetting error. Press to return to change your choices. Type Job Description Status Ended SND AAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA *INACTIVE *ABNORMAL Auswahl 9 = DspErrMsg Mit der Auswahl 9 kann eine Fehlernachricht angezeigt werden, wenn der Job abnormal beendet wurde. Die Anzeige erfolgt über ein Window (mit Programm ydspmsgwdw). Die gleiche Anzeige kann mit der Funktionstaste F11=Display Error Message aufgerufen werden, wenn mit Funktionsauswahl 5 der Display-Modus ausgewählt wurde. Befehle zum Starten und Beenden von FTP-Communication-Jobs 1. Starten von FTP-Communication-Jobs Zum Starten muss der Befehl STRFTPCMN benutzt werden. Der Aufruf erfolgt mit einem Befehlsparameter, der entweder den Namen des zu startenden Communication-Jobs oder den Sonderwert *ALL enthält. 2. Beenden von FTP-Communication-Jobs Zum Beenden muss der Befehl ENDFTPCMN benutzt werden. Der Aufruf erfolgt mit einem Befehlsparameter, der entweder den Namen des zu beendenden Communication-Jobs oder den Sonderwert *ALL enthält. FTP Communication Jobs Seite 9

10 Die FTP-Communication-Job-File FTPPCJ Feldname Feldbezeichnung Ty pe Länge Dez Bemerkung CJJOB JOB A 010 Name des FTP-Communication- Jobs Unique-Key-1 in PF CJDSC DESCRIPTION A 030 Beschreibung zum Job CJTYPE TYPE A 003 Typ der Übertragung: SND = Senden (PUT) RCV = Empfangen (GET) CJJOBUSR JOB-USER A 010 Benutzerprofil, unter welchem der FTP-Communication-Job ausgeführt werden soll. CJRMTSYS RMT-SYSTEM A 030 FTP-Server Host-Name oder IP-Adresse CJUSER USER-ID A 032 Benutzer-ID zur Anmeldung auf FTP-Server CJPWD PWD A 010 Kennwort zur Anmeldung auf FTP-Server CJRMTPTH RMT-PATHNAME A 255 Pfadname auf entferntem System (=FTP-Server) CJLOCPTH LOC-PATHNAME A 255 Pfadname auf lokalem System (=FTP-Client) CJSAVPTH SAV-PATHNAME A 255 Pfadname auf lokalem System (=FTP-Client) zur Sicherung nach der Übertragung oder *NONE CJGENNAM GEN-FILE-NAME A 020 Generischer Dateiname zur Auswahl der Streamfiles (*.* = Alle Dateien) CJRNMPGM FILE-RENAME-PGM A 010 Programmname zur Dateiumbenennung oder *NONE CJRNMPGLB RENAME-PGM-LIB A 010 Bibliothek CJEXTPGM EXIT-PGM A 010 Programmname zur Ausführung nach der Übertragung oder *NONE CJEXTPGLB EXIT-PGM-LIB A 010 Bibliothek CJFIXPARM FIX-PARM A 020 Fixparameter für Exit-Programm CJJOBQ JOBQ A 010 Jobwarteschlange zur Ausführung CJJBQLB JOBQ-LIB A 010 Bibliothek CJMSGQ MSGQ A 010 Nachrichtenwarteschlange für Fehlernachrichten CJMSGQLB MSGQ-LIB A 010 Bibliothek CJSCHDL SCHEDULE-DAYS A 007 Ausführungstage Pos.1 = So, Pos. 2 = Mo, usw. Pos. 7 = Sa 0 = nein, 1 = ja CJTMWDW TIME-WINDOW A 008 Zeitfenster für Ausführung HHMMHHMM (von HHMM bis HHMM) CJINTVL TIME-INTERVAL S Zeitintervall der Ausführung in Minuten FTP Communication Jobs Seite 10

11 Feldname Feldbezeichnung Ty pe Länge Dez Bemerkung CJEXTM1 EXEC-TIME-1 A 004 Ausführungsuhrzeit 1 (HHMM) CJEXTM2 EXEC-TIME-2 A 004 Ausführungsuhrzeit 2 (HHMM) CJEXTM3 EXEC-TIME-3 A 004 Ausführungsuhrzeit 3 (HHMM) CJEXTM4 EXEC-TIME-4 A 004 Ausführungsuhrzeit 4 (HHMM) CJEXTM5 EXEC-TIME-5 A 004 Ausführungsuhrzeit 5 (HHMM) CJEXTM6 EXEC-TIME-6 A 004 Ausführungsuhrzeit 6 (HHMM) CJCTL CTL-FLAG A 001 Steuerungs-Kennzeichen: 0 = Normal beendet 1 = Gestartet 3 = Fehlerhaft beendet 9 = Beendigung anstehend CJERRMSG ERROR-MSG-ID A 007 Fehlernachrichten-ID CJMSGDTA ERROR-MSG-DTA A 132 Fehlernachrichten-Daten CJSTRDT START-DATE S Letztes Startdatum CJSTRTM START-TIME S Letzte Startuhrzeit CJSTRUS START-USER A 010 Letzter Startbenutzer CJSTRJB START-JOB A 010 Letzter Startjob CJSTRNR START-JBNR S Letzte Start-Jobnummer CJENDDT END-DATE S Letztes Enddatum CJENDTM END-TIME S Letzte Enduhrzeit CJSTS STATUS A = Frei zur Ausführung 1 = Gesperrt Wichtiger Hinweise: Wenn in einem der Felder CJEXTM1 bis CJEXTM6 ein Eintrag vorgenommen werden soll, dürfen in den Feldern CJTMWDW und CJINTVL keine Spezifikationen gemacht werden. Die Differenzzeit zwischen den Einträgen in den Feldern CJEXTM1 bis CJEXTM6 muss mindestens 15 Minuten sein. FTP Communication Jobs Seite 11

12 Die FTP-Communication-Log-File FTPPCL Feldname Feldbezeichnung Ty pe Länge Dez Bemerkung CLJOBNR JOB-NBR S Job-Nummer CLJDATE JOB-DATE S Job-Datum CLJTIME JOB-TIME S Job-Uhrzeit CLJOB JOB A 010 Name des FTP-Communication- Jobs CLDSC DESCRIPTION A 030 Beschreibung zum Job CLTYPE TYPE A 003 Typ der Übertragung: SND = Senden (PUT) RCV = Empfangen (GET) CLJOBUSR JOB-USER A 010 Benutzerprofil, unter welchem der FTP-Communication-Job ausgeführt wurde. CLRMTSYS RMT-SYSTEM A 030 FTP-Server Host-Name oder IP-Adresse CLUSER USER-ID A 032 Benutzer-ID zur Anmeldung auf FTP-Server CLRMTPTH RMT-PATHNAME A 255 Pfadname auf entferntem System (=FTP-Server) CLLOCPTH LOC-PATHNAME A 255 Pfadname auf lokalem System (=FTP-Client) CLSAVPTH SAV-PATHNAME A 255 Pfadname auf lokalem System (=FTP-Client) zur Sicherung nach der Übertragung oder *NONE CLFILNAM FILE-NAME A 030 Name der zu übertragenden Datei CLCVTFILN CVT-FILE-NAME A 030 Neuer Dateiname bei Speicherung CLEXTPGM EXIT-PGM A 010 Programmname zur Ausführung nach der Übertragung oder *NONE CLEXTPGLB EXIT-PGM-LIB A 010 Bibliothek CLFIXPARM FIX-PARM A 020 Fixparameter für Exit-Programm Wichtiger Hinweise: Die Datei ist ungeschlüsselt, damit die Chronologie der Datenaufzeichnung für einzelnen Dateien erhalten bleibt. Auswertungsprogramme sind bisher keine vorgesehen, können aber per Query oder WRKDBF betrachtet werden. FTP Communication Jobs Seite 12