Der einfache Weg zur fehlerfreien JCL

1. Smart/JCL Der einfache Weg zur fehlerfreien JCL Basisworkshop HORIZONT Software für Rechenzentren Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 - 0www.horizont-it.com

2. Vorwort • DerBasiskurs sollte beim ersten Mal in der vorgegebenen sequentiellen Reihenfolge durchgegangen werden. Er hilft Ihnen, SmartJCL besser kennen zu lernen. Der beste Weg dazu ist jedoch einfach: Benutzen Sie SmartJCL so oft es geht. Falls Sie den Kurs nicht in der sequentiellen Reihenfolge durchgehen, können Sie mit Hilfe des Index (s. nächste Folie) navigieren. Einführung Inhalt 1 Inhalt 2 Inhalt 3 Wenn Sie auf dieses Feld klicken, kommen Sie zurück zum Inhaltsverzeichnis.

3. Inhaltsverzeichnis Einführung Im Editor JCL prüfen Im Editor Scheduling-Variablen simulieren Tipps zum EDIT-Makro Mit ISPF-Dialog/Batch JCL prüfen Mit ISPF-Dialog/Batch Scheduling-Variablen simulieren Sonstiges zu TWS-Variablen

4. Einführung • SmartJCL ist ein JCL-Checker • Aufgabe eines JCL-Checkers ist das Auffinden von Fehlern in der JCL vor Produktionseinsatz • Das erfordert folgende Eigenschaften: • Einzelne Jobs müssen bei Erstellung geprüft werden: • Direkt bei der Änderung im ISPF-Editor • Nach der Änderung mittels • ISPF-Dialog • Batch-Modus

5. Einführung • Erforderliche Eigenschaften (Fs.): • Ganze Jobketten, im günstigsten Fall der gesamte Produktionsablauf, müssen geprüft werden • Dazu ist eine hohe Verarbeitungsgeschwindigkeit erforderlich • Eine Simulation der Katalogaktionen wäre wünschenswert • Variablen der Scheduling-Systeme müssen berücksichtigt bzw. aufgelöst werden • Für TWS zOS existiert die in SmartJCL integrierte Komponente TWS/SimJCL • Günstig wäre es, zukünftige Produktionsabläufe im Vorfeld zu prüfen

6. Standard-Kommandos • In dieser Präsentation werden die Standardaufruf-Kommandos verwendet. In Ihrem Unternehmen könnten die Kommandos anders heißen. • Die Standardkommandos beim EDIT-Makro sind: • JCK: JCL prüfen • OSJ: TWS-Variablen simulieren • OSJ JCK: TWS-Variablen simulieren und aufgelöste JCL prüfen

7. Standard-REXXen • In dieser Präsentation werden die Standardaufruf-REXXen verwendet. In Ihrem Unternehmen könnten die Aufrufe anders heißen oder in ISPF integriert sein. • Die REXXen in der Datei HLQ.SMARTJCL.CLIST zum Starten des ISPF-Dialoges ist: • JCKX: SmartJCL ISPF-Dialog

8. Aufruf-Varianten • SmartJCL kann auf folgende Arten eingesetzt werden: • EDIT-Modus • Einen Job prüfen • Einen Job simulieren • Einen Job simulieren und prüfen • ISPF-Dialog oder per Batchjob • viele Jobs prüfen • viele Jobs simulieren • viele Jobs simulieren und prüfen

9. JCL im Editor prüfen • Sie editieren JCL und wollen diese prüfen • Folgende Varianten sind möglich: • Editierte JCL checken • prüfen • simulieren • simulieren und prüfen • JCL aus Joblib • prüfen • simulieren • simulieren und prüfen

10. JCL im Editor prüfen JCL prüfen Verschiedene Beispiele Beispiel Katalogsimulation Beispiel IDCAMS-Statements prüfen

11. JCL im Editor prüfen Sie editieren Ihre JCL ... ... und wollen die JCL prüfen.

12. JCL im Editor prüfen Geben Sie JCK ein

13. JCL im Editor prüfen Wenn SmartJCL keinen Fehler findet, zeigt SmartJCL die Meldung „Check successful“ an. Ihre JCL ist OK.

14. JCL im Editor prüfen Hinweis: Prozeduren innerhalb des Jobs werden übrigens als NOTE-Zeilen in aufgelöster Form angezeigt

15. JCL im Editor prüfen Wenn SmartJCL einen Fehler findet, zeigt SmartJCL die Meldung „Errors occured“ an. Ihre JCL ist nicht OK. Alle Fehler werden als NOTE-Zeilen angezeigt, mit Label-Kennung, Messagenummer und einem Fehlertext

16. JCL im Editor prüfen Wenn Sie zu einem bestimmten Fehler springen wollen, geben Sie bitte „L .label-kennung“ ein,z.B. L .HAAA, um zum ersten Fehler zu kommen

17. JCL im Editor prüfen SmartJCL springt zum entsprechenden Fehler. Zu jedem fehlerhaften JCL-Statement ist als NOTE-Zeile der Fehlertext eingefügt

18. JCL im Editor prüfen Der Fehlertext „UNDEFINED PARAMETER DCG ON DD STMT“ zeigt an, das der Parameter DCG nicht erlaubt ist. Korrigieren Sie den Wert (hier DCB statt DCG), korrigieren Sie ggf. auch alle anderen Fehler und rufen Sie erneut JCK auf, ...

19. JCL im Editor prüfen ..., solange bis SmartJCL meldet, dass die Prüfung erfolgreich war.

20. Beispiele • Im Folgenden werden verschiedene Fehlerszenarien und ihre Meldungen gezeigt. Natürlich gibt es jede Menge weitere Fehlerszenarien, die hier nicht alle aufgeführt werden können. Invalid DCB-Parameter Invalid JCL statement, weil Fortsetzungszeichen fehlt Invalid JCL statement, DD falsch Invalid JCL statement, JOB falsch Invalid JCL statement, EXEC falsch Invalid DISP-Parameter Katalogsimulationsfehler, IDCAMS-DEL-Anweisung in Prozedur falsch

21. Invalid DCB-Parameter Falsch DORG, richtig DSORG

22. Invalid JCL-Statement Komma für Fortsetzungszeile fehlt

23. Invalid JCL-Statement Falsch DF, richtig DD

24. Invalid JCL-Statement Falsch JOP, richtig JOB

25. Invalid JCL-Statement Falsch XXEC, richtig EXEC

26. Invalid DISP Falsch KATLG, richtig CATLG

27. Katalogaktionen simulieren Wenn neben den JCL-Fehlern auch die Katalogaktionen geprüft werden sollen (dies kann per Parameter gesteuert werden), kann z.B. o.a. Meldung erscheinen „dataset is already cataloged“.

28. Katalogaktionen simulieren Springen Sie mit „l .haaa“ zu der entsprechenden Stelle

29. Katalogaktionen simulieren Die Datei soll hier neu angelegt werden. SmartJCL prüft, ob die Datei schon vorhanden ist und stellt fest, dass die Datei in Ihrem Katalog schon existiert und daher nicht noch einmal angelegt werden kann. Suchen Sie im Job nach dem ersten Auftreten des Dateinamens ...

30. Katalogaktionen simulieren ... und schon erkennen Sie, dass die Datei zu Beginn des Jobs in einer IDCAMS-Prozedur gelöscht werden soll und dass darin die DEL-Anweisung statt mit DEL mit DEK geschrieben wurde.

31. IDCAMS-Statements Wenn in Ihrer Installation aktiviert ist, dass SmartJCL auch IDCAMS-Statements prüfen soll, bekommen Sie von SmartJCL angezeigt, dass das DEL-Statement falsch geschrieben ist.

32. IDCAMS-Statements Korrigieren Sie das DEK-Statement in DEL

33. JCL im Editor simulieren • Simulieren bedeutet, dass die Scheduler-Variablen aufgelöst werden. • Bisher unterstützte Scheduling-Systeme TWS z/OS

34. TWS-JCL im Editor simulieren • Wenn SmartJCL die JCL mit TWS-Variablen simuliert, kommuniziert SmartJCL mit dem TWS. TWS sucht dabei die JCL in folgender Reihenfolge: • 1. In der JS-Datei • 2. In den TWS zugeordneten Job-Bibliotheken • Daher muss eine zu simulierende JCL entweder in der JS-Datei oder auf einer der TWS-Job-Bibliotheken stehen. • Weiterhin muss eine Operation im CP oder in der AD-Datei mit einem identischen Jobnamen existieren. • Dies ist auch der Grund, dass SmartJCL oder Sie beim Simulieren einer „neuen“ JCL die JCL zuerst auf eine TWS-Joblib oder in die JS-Datei schreiben und dass zum Jobnamen eine Muster-Operation existieren muss.

35. TWS-JCL im Editor simulieren JCL von Joblib simulieren Aktuell editierte JCL simulieren JCL simulieren und prüfen JCL simulieren und simulierte JCL in JS-Datei speichern Beispiele für Fehlermeldungen Simulation eines Noch-Nicht-TWS-Jobs Simulation eines Scripts

36. TWS-JCL im Editor simulieren Sie editieren die JCL auf einer Ihrer TWS-Job-Bibliotheken die JCL hat TWS-Variablen

37. TWS-JCL im Editor simulieren Sichern Sie die JCL mit SAVE und gehen zur nächsten Folie, oder ... ... klicken Sie hier drauf.

38. TWS-JCL im Editor simulieren Geben Sie OSJ ein

39. TWS-JCL im Editor simulieren Job-/Membername Der Jobname wird zuerst im TWS-Tagesplan (CP) gesucht. Meldung erscheint, ob der Job gefunden oder nicht gefunden wurde. Sie werden gefragt, ob der Job zusätzlich in der TWS-Definitionsdatei (AD) gesucht werden soll.

40. TWS-JCL im Editor simulieren Dabei durchsucht SmartJCL alle Operationen aller Aufträge aus der TWS-Definitionsdatei (AD). Dies kann unter Umständen bei sehr vielen Aufträgen mit sehr vielen Operationen je Systemauslastung etwas dauern.

41. TWS-JCL im Editor simulieren Alle Jobs aus dem Tagesplan (s. Wert CP in Spalte origin) und alle Jobs aus der Definitionsdatenbank (s. Wert AD in Spalte Origin) werden in einer Auswahlliste angezeigt.

42. TWS-JCL im Editor simulieren Geben Sie das Simulationsdatum und -zeit ein Geben Sie ein IA-Datum und eine IA-Zeit ein. Die IA ist zwingend, wenn Origin AD ist.

43. TWS-JCL im Editor simulieren Wählen Sie eine Operation aus

44. TWS-JCL im Editor simulieren SmartJCL löst die TWS-Variablen auf und zeigt Ihnen die simulierte JCL als NOTE-Zeilen an

45. Geänderte JCL im Editor simulieren • Folgende Vorgehensweise benötigen Sie, wenn: • die JCL im Editor verändert wurde und noch nicht gesichert worden ist • die JCL noch auf keiner TWS-Job-Bibliothek steht • Anmerkung:In beiden Fällen müssen Sie SmartJCL explizit mitteilen, dass es die JCL aus dem Editor zur Simulation verwenden soll.

46. Geänderte JCL im Editor simulieren Geben Sie OSJ ein

47. Geänderte JCL im Editor simulieren Der Jobname wird zuerst im TWS-Tagesplan (CP) gesucht. Eine Meldung erscheint, ob der Job gefunden oder nicht gefunden wurde. Sie werden gefragt, ob der Job zusätzlich in der TWS-Definitionsdatei (AD) gesucht werden soll.

48. Geänderte JCL im Editor simulieren Alle Jobs aus dem Tagesplan (s. Wert CP in Spalte origin) und alle Jobs aus der Definitionsdatenbank (s. Wert AD in Spalte Origin) werden in einer Auswahlliste angezeigt.

49. Geänderte JCL im Editor simulieren Geben Sie das Simulationsdatum und -zeit ein Geben Sie ein IA-Datum und eine IA-Zeit ein. Die IA ist zwingend, wenn Origin AD ist.

50. Geänderte JCL im Editor simulieren Geben Sie SP an