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.
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.
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. Unterstützt auch die Suche nach Inhalten 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. Unterstützt auch die Suche nach Inhalten innerhalb einer Stream-Datei per Regex. | IBM i Developer |
get_table_columns | Spaltenmetadaten für eine Db2 for i-Tabelle oder -View abrufen, mit Abgleich von SQL- und Systemnamen. | 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 |
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 |
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 unterstützt auch Dateiübertragungen ü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 |
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 |
Zusätzliche Auto-Approve-Berechtigung
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 folgende Auto-Approve-Berechtigung:
- Documentation: Erlaubt Bob, alle Documentation-Tools zur Abfrage von IBM i-Dokumentation zu verwenden, ohne um Erlaubnis zu fragen.
