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.
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 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 |
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.
