RPG mit ChatGPT dokumentieren: Was KI wirklich kann und wo sie scheitert

Entwickler nutzt KI, um RPG-Code in technische Dokumentation umzuwandeln.

RPG mit ChatGPT dokumentieren: Was bringt das in der Praxis?

Wer seit vielen Jahren mit IBM i arbeitet, kennt die Situation. Ein RPG Programm läuft seit 15 oder 20 Jahren zuverlässig. Der ursprüngliche Entwickler ist längst nicht mehr im Unternehmen. Kommentare finden sich nur vereinzelt im Sourcecode und eine aktuelle Programmdokumentation existiert nicht. Genau hier kann KI helfen. Wenn Sie RPG mit ChatGPT dokumentieren, können Sie sich vorhandenen Sourcecode erklären lassen, Programmabläufe strukturieren und aus RPG Code eine erste technische Dokumentation erstellen. Sie sollten das Ergebnis aber niemals ungeprüft übernehmen.

ChatGPT kann beispielsweise:

Das spart vor allem beim ersten Einstieg in unbekannte Programme Zeit. Die entscheidende Einschränkung lautet jedoch: ChatGPT sieht zunächst nur das, was Sie ihm zur Verfügung stellen. Ein einzelnes RPG Programm bildet selten den kompletten Geschäftsprozess ab. Ein Aufruf eines anderen Programms, eine Datei, ein Serviceprogramm oder eine externe Schnittstelle kann entscheidende Informationen enthalten. KI liefert deshalb keine automatische Wahrheit über Ihre Anwendung. Sie liefert eine Analyse auf Basis des verfügbaren Kontextes. Das ist ein wichtiger Unterschied. Wer diesen Unterschied berücksichtigt, kann ChatGPT sinnvoll als Werkzeug für die RPG Dokumentation einsetzen.

Warum KI bei altem RPG Code besonders interessant wird?

Viele IBM i Anwendungen sind über Jahrzehnte gewachsen. Das ist zunächst kein Problem. Gut geschriebener RPG Code kann lange zuverlässig seinen Dienst erfüllen. Schwieriger wird es, wenn Wissen verloren geht. Ein Entwickler erkennt vielleicht sofort, warum eine bestimmte Datei gelesen wird oder weshalb vor einem UPDATE noch ein bestimmtes Programm aufgerufen wird. Ein neuer Mitarbeiter sieht zunächst nur Sourcecode.

Beim RPG mit ChatGPT dokumentieren kann KI diese Einstiegshürde reduzieren. Geben Sie der KI beispielsweise ein überschaubares RPG Programm und einen klaren Arbeitsauftrag. Lassen Sie nicht einfach nur „den Code erklären“.

Fordern Sie stattdessen eine feste Struktur:

Gerade der letzte Punkt ist wichtig. Die KI soll nicht versuchen, jede Lücke selbst zu schließen. Sie soll deutlich kennzeichnen, welche Zusammenhänge sie aus dem vorliegenden Sourcecode nicht sicher bestimmen kann. Damit verändert sich auch die Aufgabe des RPG Entwicklers. Sie müssen nicht mehr jede Zeile der Dokumentation selbst formulieren. Stattdessen prüfen und ergänzen Sie einen automatisch erzeugten Entwurf. Das funktioniert besonders gut, wenn Sie selbst genügend RPG und IBM i Wissen besitzen, um Fehler und Fehlinterpretationen zu erkennen. KI ersetzt an dieser Stelle nicht das Fachwissen. Sie hilft Ihnen, vorhandenes Fachwissen schneller in eine brauchbare Dokumentation zu übertragen.

Praxisbeispiel: Ein RPG Programm mit ChatGPT dokumentieren

Nehmen wir ein typisches Szenario. Sie übernehmen ein RPG Programm zur Auftragsverarbeitung. Der Sourcecode umfasst mehrere hundert Zeilen und enthält Embedded SQL sowie verschiedene Prozeduraufrufe. Kopieren Sie nicht sofort alles in ChatGPT. Gehen Sie strukturiert vor.

Schritt 1: Aufgabe definieren

Geben Sie ChatGPT zunächst einen eindeutigen Auftrag:

„Analysiere den folgenden RPGLE Sourcecode. Erstelle eine technische Dokumentation. Trenne eindeutig zwischen Informationen, die direkt aus dem Sourcecode hervorgehen, und Annahmen.“

Schritt 2: Struktur vorgeben

Fordern Sie anschließend beispielsweise folgende Bereiche:

Schritt 3: Ergebnis kontrollieren

Jetzt beginnt die wichtige Arbeit.

Prüfen Sie jede Aussage gegen den Sourcecode. Besonders kritisch sind Aussagen zur fachlichen Bedeutung. Eine Variable mit dem Namen KDNST könnte beispielsweise einen Kundenstatus enthalten. Aus dem Namen allein ergibt sich aber noch keine belastbare fachliche Definition.

Schritt 4: Kontext ergänzen

Geben Sie bei Bedarf weitere relevante Sourcen hinzu. Dazu können Copybooks, aufgerufene Programme oder Definitionen gehören.

Schritt 5: Dokumentation nachbearbeiten

Übernehmen Sie nur geprüfte Aussagen.

Damit erhalten Sie nicht einfach eine KI Zusammenfassung, sondern eine nachvollziehbare technische Dokumentation, die ein Entwickler später tatsächlich verwenden kann.

Wo ChatGPT an Grenzen kommt und IBM Bob interessant wird

Waage symbolisiert Chancen und Grenzen von ChatGPT bei der RPG-Dokumentation.

Bei einem einzelnen RPG Programm kann ChatGPT bereits erstaunlich hilfreich sein. Schwieriger wird es bei gewachsenen Anwendungen mit vielen Abhängigkeiten. Ein Programm ruft ein zweites Programm auf. Dieses verwendet ein Serviceprogramm. Zusätzlich spielen Tabellen, Data Areas, CL Programme und weitere Objekte eine Rolle. Fehlt dieser Kontext, kann die KI Zusammenhänge übersehen oder falsch interpretieren.

Deshalb sollten Sie insbesondere folgende Ergebnisse kritisch prüfen:

An dieser Stelle wird IBM Bob für IBM i interessant. IBM richtet das Premium Package for i speziell auf bestehende IBM i Umgebungen aus. Bob unterstützt unter anderem RPG, CL, SQL, DDS und QSYS. Zu den vorgesehenen Anwendungsfällen gehören das Erklären und Dokumentieren von Anwendungen sowie die Extraktion von Geschäftslogik. Damit unterscheidet sich der Ansatz von einer isolierten Analyse eines kopierten Sourcecodes. Trotzdem bleibt ein Grundsatz bestehen:

Lassen Sie KI Ergebnisse prüfen.

Gerade bei geschäftskritischen IBM i Anwendungen reicht eine plausibel klingende Erklärung nicht aus. Nutzen Sie KI deshalb als Werkzeug für Analyse und Dokumentation. Verbinden Sie ihre Geschwindigkeit mit dem Wissen erfahrener IBM i Entwickler. Dann entsteht aus KI Unterstützung ein sinnvoller Entwicklungsprozess.

Fazit: Erst RPG verstehen, dann KI sinnvoll einsetzen

RPG mit ChatGPT dokumentieren kann Ihnen viel Arbeit abnehmen. Besonders bei schlecht dokumentierten Bestandsprogrammen erhalten Sie schnell einen ersten Überblick über Strukturen, Datenzugriffe und Programmlogik.

Die Methode funktioniert aber nur dann zuverlässig, wenn Sie das Ergebnis fachlich kontrollieren. ChatGPT kennt nicht automatisch Ihre Anwendung, Ihre Namenskonventionen oder die Geschichte hinter einem RPG Programm. Fehlender Kontext bleibt fehlender Kontext.

Mein Vorgehen wäre deshalb klar:

IBM Bob geht für IBM i inzwischen noch einen Schritt weiter. IBM hat spezielle IBM i Funktionen für das Verstehen, Dokumentieren und Modernisieren bestehender Anwendungen integriert. Damit lohnt sich auch der Vergleich zwischen allgemeinen KI Werkzeugen und speziell auf IBM i ausgerichteten Lösungen. Entscheidend bleibt jedoch Ihr RPG Wissen. Je besser Sie RPG Code, Datenbankzugriffe und die Architektur von IBM i Anwendungen verstehen, desto besser können Sie auch die Ergebnisse einer KI beurteilen.

Wenn Sie Ihre RPG Kenntnisse dafür aufbauen oder auffrischen möchten, bietet Power Education unter anderem Schulungen zu Free RPG Batch und Listenprogrammen sowie Free RPG Dialogprogrammen an.

Wir empfehlen Ihnen den Einstieg über unsere Pakete: RPG und IBM i Schulungen bei Power Education.

Verschlagwortet , , , , , ,
  • Power Education

Newsletter

Erhalten Sie immer die neusten Info´s rund um das System Power i

Anmeldung zum Newsletter