Tools
Nutze IBM i-spezifische Tools, um Member oder Stream-Dateien zu lesen und zu schreiben, CL-Befehle und SQL-Anweisungen auszuführen und vieles mehr.
IBM Bob Premium Package for i erweitert Bobs eingebaute Tool-Fähigkeiten um eine Reihe IBM i-spezifischer Tools. Eine allgemeine Einführung in die Funktionsweise von Tools und welche eingebaut sind, findest du unter Tools.
Diese Tools sind nach Funktion gegliedert und stehen Bob je nach Tool im IBM i Developer- und IBM i Database-Modus zur Verfügung.
Read
Inhalte in QSYS oder IFS lesen und durchsuchen.
Edit
Inhalte in QSYS oder IFS erstellen und schreiben.
SQL
Schemas, Dateien, Tabellen und Befehle in Db2 for i auflösen.
Execute
CL-Befehle, SQL-Anweisungen und PASE-Befehle ausführen.
Build
IBM i-Quellcode kompilieren.
Test
Unit-Test-Stubs generieren und Test-Suites mit Code-Coverage ausführen.
Documentation
Offizielle IBM i-Dokumentation, CL-Befehlsdokumentation und SQL-Beispiele suchen und abrufen.
Understand
Gescannte IBM i-Anwendungsobjekte und ihre Abhängigkeiten erkunden.
Read-Tools
Die folgenden IBM i-Read-Tools fallen unter die Auto-Approve-Berechtigung read:
| Tool | Zweck | Verfügbar in |
|---|---|---|
read_member | Inhalt eines oder mehrerer Quell-Member in QSYS lesen. | IBM i Developer, IBM i Database |
search_qsys | Bibliotheken, Objekte oder Quell-Member in QSYS suchen, einschließlich Inhaltssuche innerhalb eines Members per Regex. | IBM i Developer, IBM i Database |
read_stream_file | Inhalt einer oder mehrerer Stream-Dateien im IFS lesen. | IBM i Developer |
search_ifs | Stream-Dateien und Verzeichnisse im IFS suchen, einschließlich Inhaltssuche innerhalb einer Stream-Datei per Regex. | IBM i Developer |
Write-Tools
Die folgenden IBM i-Write-Tools fallen unter die Auto-Approve-Berechtigung write:
| Tool | Zweck | Verfügbar in |
|---|---|---|
write_member | Ein neues Quell-Member erstellen oder ein vorhandenes Quell-Member in QSYS überschreiben. | IBM i Developer |
write_stream_file | Eine neue Stream-Datei erstellen oder eine vorhandene Stream-Datei im IFS überschreiben. | IBM i Developer |
generate_dds | DDS-Quellcode für physische Dateien (PF), logische Dateien (LF), Anzeigedateien (DSPF) und Druckerdateien (PRTF) aus strukturierter Eingabe generieren, mit Vorab-Validierung für häufige Layout-Probleme. | IBM i Developer |
Execute-Tools
Die folgenden IBM i-Execute-Tools fallen unter die Auto-Approve-Berechtigung execute:
| Tool | Zweck | Verfügbar in |
|---|---|---|
execute_cl_command | Einen CL-Befehl auf IBM i ausführen. Standardmäßig verlangt Bob bibliotheksqualifizierte Befehle (z. B. QSYS/...) und schlägt beim Kompilieren automatisch Parameter zur Erzeugung von Event-Dateien vor. Die Aktivierung dieser Schutzmaßnahme für qualifizierte CL-Befehle ist in den Erweiterungseinstellungen konfigurierbar. | IBM i Developer |
execute_sql_statement | Eine SQL-Anweisung auf IBM i ausführen. Bestimmte SQL-Anweisungstypen (z. B. DROP, UPDATE, TRUNCATE) erfordern vor der Ausführung eine explizite Benutzerbestätigung. Diese Liste abgelehnter Anweisungstypen ist in den Erweiterungseinstellungen konfigurierbar. | IBM i Developer, IBM i Database |
execute_pase_command | Einen PASE-Befehl auf IBM i ausführen. | IBM i Developer |
convert_rpg_source | Den CL-Befehl zum Konvertieren von RPG-Quellcode (CVTRPGSRC) ausführen, um RPG III- oder RPG/400-Quellcode in das neue RPG IV-Format zu konvertieren. Dieses Tool überträgt Dateien auch über alle drei Workspaces. | IBM i Developer |
Build-Tools
Die folgenden IBM i-Build-Tools fallen unter die Auto-Approve-Berechtigung execute:
| Tool | Zweck | Verfügbar in |
|---|---|---|
get_compile_actions | Vordefinierte Code for IBM i-Aktionen für eine gegebene Datei abrufen. Für lokale Dateien werden diese aus den lokalen Aktionen des Projekts abgerufen, die in .vscode/actions.json gespeichert sind. Für Quell-Member oder Stream-Dateien werden Standard- und benutzerdefinierte Aktionen der Verbindung abgerufen. | IBM i Developer |
execute_compile_action | Eine bestimmte Code for IBM i-Aktion, die mit dem Tool get_compile_actions abgerufen wurde, für eine gegebene Datei ausführen. | IBM i Developer |
Test-Tools
Die folgenden IBM i-Test-Tools fallen unter die Auto-Approve-Berechtigungen read und execute:
| Tool | Zweck | Verfügbar in |
|---|---|---|
generate_rpg_unit_test_stub | RPGUnit-Test-Stubs für eine RPGLE- oder SQLRPGLE-Datei mit exportierten Prozeduren generieren. Dies entspricht dem Generieren über den IBM i Testing-Test-Stub-Generator. | IBM i Developer |
run_rpg_unit_test_suite | RPGUnit-Test-Suites kompilieren und ausführen, optional mit zeilengenauer (*LINE) oder prozedurengenauer (*PROC) Code-Coverage. | IBM i Developer |
SQL-Tools
Die folgenden IBM i-SQL-Tools fallen unter die Auto-Approve-Berechtigung execute:
| Tool | Zweck | Verfügbar in |
|---|---|---|
get_schema_info | Einen Bibliotheks- oder Schemanamen in seinen Systemnamen (10 Zeichen, für CL-Befehle) und seinen SQL-Schemanamen (bis zu 128 Zeichen, für SQL-Anweisungen) auflösen. Behandelt normale Namen, lange SQL-Schemanamen und delimitierte Bezeichner. | IBM i Developer, IBM i Database |
get_file_info | Einen Tabellen- oder Dateinamen in seine vollständigen Metadaten auflösen, einschließlich Systemname, SQL-Name, Objekttyp und Beschreibung. Löst normale Namen, lange SQL-Tabellennamen, SQL-Aliase und Groß-/Kleinschreibung-sensitive delimitierte Bezeichner korrekt auf. | IBM i Developer, IBM i Database |
get_table_columns | Spaltenmetadaten für eine Db2 for i-Tabelle oder -View abrufen, mit Groß-/Kleinschreibung-unsensitivem Abgleich für SQL- und Systemnamen, einschließlich delimitierter Bezeichner und Namen mit gemischter Groß-/Kleinschreibung. | IBM i Database |
get_cl_command_library | Alle Bibliotheken ermitteln, in denen ein CL-Befehl registriert ist, einschließlich Proxy-Befehlsdetails für korrekte Bibliotheksqualifizierung. | IBM i Developer, IBM i Database |
Documentation-Tools
Die folgenden IBM i-Documentation-Tools fallen unter die Auto-Approve-Berechtigung documentation:
| Tool | Zweck | Verfügbar in |
|---|---|---|
search_ibm_i_docs_with_rag | RAG (Retrieval-Augmented Generation) nutzen, um IBM i-Dokumentation zu finden, wenn konzeptionelle oder offene Fragen zu IBM i beantwortet werden müssen, die semantisches Verständnis erfordern – nicht nur Schlüsselwort-Matching. Abgedeckt werden alle IBM i-Themen: ILE-Programmierung (RPG, CL, DDS, COBOL, C, C++), Db2 for i SQL, IFS- und QSYS-Dateisysteme, Systembetrieb, Sicherheit, Performance, Netzwerk, Speicher und Fehlersuche. Gibt kontextuell relevante Dokumentationsauszüge zurück, geordnet nach semantischer Ähnlichkeit zur Anfrage. | IBM i Developer, IBM i Database |
fetch_cl_command_doc | Dokumentation für einen CL-Befehl auf dem verbundenen IBM i abrufen, einschließlich Parameterbeschreibungen, Verwendungsbeispielen und möglichen Fehlermeldungen. Diese Dokumentation wird mit dem CL-Befehl GENCMDDOC generiert. | IBM i Developer, IBM i Database |
search_sql_examples | SQL-Beispiele suchen, die bestimmte SQL-Services aus den SQL-Beispielen der Erweiterung Db2 for IBM i nutzen. | IBM i Developer, IBM i Database |
fetch_sql_example | Den vollständigen Inhalt eines SQL-Beispiels abrufen, das mit dem Tool search_sql_examples gefunden wurde. | IBM i Developer, IBM i Database |
Understand-Tools
Die folgenden Understand-Tools sind Teil der Auto-Approve-Berechtigung Understand. Sie sind nur verfügbar, wenn die Understand-Komponente installiert ist.
| Tool | Zweck | Verfügbar in |
|---|---|---|
understand_list_apps | Alle registrierten Understand-Anwendungen auf dem verbundenen IBM i-System auflisten. | IBM i Developer, IBM i Database |
understand_app_summary | Eine Architekturübersicht einer Anwendung in einem Aufruf abrufen: Objektbestand nach Typ und Sprache, Anzahl der Abhängigkeiten, die am stärksten abhängigen und gekoppelten Objekte, Risiko- und Modernisierungssignale (OPM-Programme, dynamisches SQL, Adopted Authority, Einstiegspunkte, physische Dateien ohne Journalisierung), Datenbankregeln (Fremdschlüssel, kaskadierende Löschvorgänge, Trigger), Scan-Warnungen und referenzierte Bibliotheken außerhalb der Anwendung. | IBM i Developer, IBM i Database |
understand_find_objects | Von Understand gescannte Objekte suchen. Kombiniere Filter für Namens-Platzhalter, Typ, Bibliothek, Attribut/Sprache, OPM vs. ILE, dynamische SQL-Nutzung, keine eingehenden Abhängigkeiten und nicht verwendet seit N Tagen. Sortiere nach eingehenden Abhängigkeiten, um die kritischsten Objekte zu finden. Gibt Name, Typ, Attribut, OPM/ILE, Bibliothek, Anzahl der eingehenden/ausgehenden Abhängigkeiten, Datum der letzten Verwendung und ein Flag für dynamisches SQL zurück, mit Paging-Unterstützung. | IBM i Developer, IBM i Database |
understand_describe_object | Ein vollständiges Profil eines einzelnen IBM i-Objekts in einem einzigen Aufruf abrufen: Metadaten (Attribut, OPM/ILE, Bibliothek, Quellpfad, Eigentümer, Aktivierungsgruppe, Adopted Authority, Compiler, Datumsangaben, dynamisches SQL), Anzahl der ein-/ausgehenden Abhängigkeiten nach Art sowie typspezifische Abschnitte – Bindings, Exporte, Importe, Spalten, Trigger, Fremdschlüssel, Journalisierung, Bindungsverzeichniseinträge und Befehlsdefinitionen. | IBM i Developer, IBM i Database |
understand_trace_dependencies | Die ein- oder ausgehenden Abhängigkeiten eines Objekts bis zu einer konfigurierbaren Tiefe verfolgen, gefiltert nach Abhängigkeitsart (z. B. FILE_OPEN, PGM_CALL, BOUND_SRVPGM). | IBM i Developer, IBM i Database |
understand_find_symbol | Finden, wo eine Prozedur oder ein exportiertes Symbol definiert ist und welche Objekte es importieren (Scans ab IBM i 7.6+). | IBM i Developer, IBM i Database |
Zusätzliche Auto-Approve-Berechtigungen
Die eingebauten Auto-Approve-Berechtigungen stehen sowohl im IBM i Developer- als auch im IBM i Database-Modus zur Verfügung. Diese Modi bieten zusätzlich die folgenden Auto-Approve-Berechtigungen:
- Documentation: Erlaubt Bob, alle Documentation-Tools zur Abfrage von IBM i-Dokumentation zu verwenden, ohne um Erlaubnis zu fragen.
- Understand: Erlaubt Bob, alle Understand-Tools zur Erkundung gescannter IBM i-Objekte und Abhängigkeiten zu verwenden, ohne um Erlaubnis zu fragen. Diese Berechtigungsgruppe ist nur verfügbar, wenn die Understand-Komponente installiert ist.
