Outils
Utilise des outils IBM i spécifiques pour lire et écrire dans des membres ou des fichiers flot, exécuter des commandes CL, des instructions SQL, et bien plus encore.
IBM Bob Premium Package for i enrichit les capacités d'outils intégrés de Bob avec un ensemble d'outils spécifiques à IBM i. Pour une introduction générale au fonctionnement des outils et à leurs variantes intégrées, consulte Tools.
Ces outils sont organisés par fonction et sont disponibles pour Bob lorsqu'il travaille dans les modes IBM i Developer et IBM i Database, selon l'outil.
Lecture
Lire et rechercher du contenu dans QSYS ou l'IFS.
Édition
Créer et écrire du contenu dans QSYS ou l'IFS.
SQL
Résoudre des schémas, fichiers, tables et commandes sur Db2 for i.
Exécution
Exécuter des commandes CL, des instructions SQL et des commandes PASE.
Build
Compiler du code source IBM i.
Tests
Générer des stubs de tests unitaires et exécuter des suites de tests avec couverture de code.
Documentation
Rechercher et récupérer la documentation officielle IBM i, la documentation des commandes CL et des exemples SQL.
Understand
Explorer les objets d'application IBM i scannés et leurs dépendances.
Outils de lecture
Les outils IBM i de lecture suivants relèvent de la permission d'auto-approbation read :
| Outil | Objectif | Disponible dans |
|---|---|---|
read_member | Lire le contenu d'un ou plusieurs membres source dans QSYS. | IBM i Developer, IBM i Database |
search_qsys | Rechercher des bibliothèques, des objets ou des membres source dans QSYS, y compris le contenu d'un membre via une expression régulière. | IBM i Developer, IBM i Database |
read_stream_file | Lire le contenu d'un ou plusieurs fichiers flot dans l'IFS. | IBM i Developer |
search_ifs | Rechercher des fichiers flot et des répertoires dans l'IFS, y compris le contenu d'un fichier flot via une expression régulière. | IBM i Developer |
Outils d'écriture
Les outils IBM i d'écriture suivants relèvent de la permission d'auto-approbation write :
| Outil | Objectif | Disponible dans |
|---|---|---|
write_member | Créer un nouveau membre source ou écraser un membre source existant dans QSYS. | IBM i Developer |
write_stream_file | Créer un nouveau fichier flot ou écraser un fichier flot existant dans l'IFS. | IBM i Developer |
generate_dds | Générer le source DDS pour les fichiers physiques (PF), fichiers logiques (LF), fichiers d'affichage (DSPF) et fichiers d'impression (PRTF) à partir de données structurées, avec validation pré-écriture pour les problèmes de mise en page courants. | IBM i Developer |
Outils d'exécution
Les outils IBM i d'exécution suivants relèvent de la permission d'auto-approbation execute :
| Outil | Objectif | Disponible dans |
|---|---|---|
execute_cl_command | Exécuter une commande CL sur IBM i. Par défaut, Bob exige que les commandes soient qualifiées par une bibliothèque (par ex., QSYS/...) et suggère automatiquement d'inclure des paramètres pour générer des fichiers d'événements lors de la compilation du code source. L'activation de ce garde-fou de commande CL qualifiée est configurable dans les paramètres de l'extension. | IBM i Developer |
execute_sql_statement | Exécuter une instruction SQL sur IBM i. Certains types d'instructions SQL (comme DROP, UPDATE, TRUNCATE) nécessitent une approbation explicite de l'utilisateur avant l'exécution. Cet ensemble de types d'instructions refusées est configurable dans les paramètres de l'extension. | IBM i Developer, IBM i Database |
execute_pase_command | Exécuter une commande PASE sur IBM i. | IBM i Developer |
convert_rpg_source | Exécuter la commande CL de conversion du source RPG (CVTRPGSRC) pour convertir du code source RPG III ou RPG/400 vers le nouveau format RPG IV. Cet outil transfère également les fichiers entre les trois espaces de travail. | IBM i Developer |
Outils de build
Les outils IBM i de build suivants relèvent de la permission d'auto-approbation execute :
| Outil | Objectif | Disponible dans |
|---|---|---|
get_compile_actions | Récupérer les actions Code for IBM i prédéfinies pour un fichier donné. Pour les fichiers locaux, celles-ci seront récupérées depuis les actions locales du projet, stockées dans .vscode/actions.json. Pour les membres source ou les fichiers flot, elles seront récupérées depuis les actions par défaut et celles définies par l'utilisateur sur la connexion. | IBM i Developer |
execute_compile_action | Exécuter une action Code for IBM i spécifique récupérée via l'outil get_compile_actions sur un fichier donné. | IBM i Developer |
Outils de test
Les outils IBM i de test suivants relèvent des permissions d'auto-approbation read et execute :
| Outil | Objectif | Disponible dans |
|---|---|---|
generate_rpg_unit_test_stub | Générer des stubs de tests RPGUnit pour un fichier RPGLE SQLRPGLE contenant des procédures exportées. Cela accomplit le même objectif que leur génération via le générateur de stubs de test IBM i Testing. | IBM i Developer |
run_rpg_unit_test_suite | Compiler et exécuter des suites de tests RPGUnit avec une couverture de code optionnelle au niveau ligne (*LINE) ou au niveau procédure (*PROC). | IBM i Developer |
Outils SQL
Les outils IBM i SQL suivants relèvent de la permission d'auto-approbation execute :
| Outil | Objectif | Disponible dans |
|---|---|---|
get_schema_info | Résoudre un nom de bibliothèque ou de schéma vers son nom système (10 caractères, pour les commandes CL) et son nom de schéma SQL (jusqu'à 128 caractères, pour les instructions SQL). Gère les noms ordinaires, les noms de schéma SQL longs et les identificateurs délimités. | IBM i Developer, IBM i Database |
get_file_info | Résoudre un nom de table ou de fichier vers ses métadonnées complètes, notamment le nom système, le nom SQL, le type d'objet et la description. Résout correctement les noms ordinaires, les noms de table SQL longs, les alias SQL et les identificateurs délimités sensibles à la casse. | IBM i Developer, IBM i Database |
get_table_columns | Récupérer les métadonnées de colonnes d'une table ou vue Db2 for i, avec correspondance insensible à la casse pour les noms SQL et système, notamment les identificateurs délimités et les noms à casse mixte. | IBM i Database |
get_cl_command_library | Rechercher toutes les bibliothèques où une commande CL est enregistrée, y compris les détails de commandes proxy pour une qualification correcte. | IBM i Developer, IBM i Database |
Outils de documentation
Les outils IBM i de documentation suivants relèvent de la permission d'auto-approbation documentation :
| Outil | Objectif | Disponible dans |
|---|---|---|
search_ibm_i_docs_with_rag | Utiliser RAG (retrieval-augmented generation) pour trouver de la documentation IBM i lorsqu'il faut répondre à des questions conceptuelles ou ouvertes sur IBM i qui nécessitent une compréhension sémantique plutôt qu'une correspondance exacte de mots-clés. Couvre tous les sujets IBM i : programmation ILE (RPG, CL, DDS, COBOL, C, C++), Db2 for i SQL, systèmes de fichiers IFS et QSYS, opérations système, sécurité, performances, réseau, stockage et dépannage. Retourne des extraits de documentation contextuellement pertinents classés par similarité sémantique avec la requête. | IBM i Developer, IBM i Database |
fetch_cl_command_doc | Récupérer la documentation d'une commande CL sur l'IBM i connecté, incluant les descriptions des paramètres, des exemples d'utilisation et les messages d'erreur possibles. Cette documentation est générée à l'aide de la commande CL GENCMDDOC. | IBM i Developer, IBM i Database |
search_sql_examples | Rechercher des exemples SQL utilisant des services SQL spécifiques parmi les exemples SQL définis dans l'extension Db2 for IBM i. | IBM i Developer, IBM i Database |
fetch_sql_example | Récupérer le contenu complet d'un exemple SQL obtenu via l'outil search_sql_examples. | IBM i Developer, IBM i Database |
Outils Understand
Les outils Understand suivants font partie de la permission d'auto-approbation Understand. Ils sont uniquement disponibles lorsque le composant Understand est installé.
| Outil | Objectif | Disponible dans |
|---|---|---|
understand_list_apps | Lister toutes les applications Understand enregistrées sur le système IBM i connecté. | IBM i Developer, IBM i Database |
understand_app_summary | Obtenir une vue d'ensemble architecturale d'une application en un seul appel : inventaire des objets par type et langage, nombres de dépendances, les objets les plus dépendants et les plus couplés, signaux de risque et de modernisation (programmes OPM, SQL dynamique, autorité adoptée, points d'entrée, fichiers physiques sans enregistrement de journal), règles de base de données (clés étrangères, suppressions en cascade, déclencheurs), avertissements de scan et bibliothèques référencées hors de l'application. | IBM i Developer, IBM i Database |
understand_find_objects | Rechercher des objets scannés par Understand. Combine des filtres pour les caractères génériques de nom, le type, la bibliothèque, l'attribut/langage, OPM vs ILE, l'utilisation SQL dynamique, l'absence de dépendances entrantes et la non-utilisation depuis N jours. Trie par dépendances entrantes pour trouver les objets les plus critiques. Retourne le nom, le type, l'attribut, OPM/ILE, la bibliothèque, les nombres de dépendances entrantes/sortantes, la date de dernière utilisation et un indicateur SQL dynamique, avec support de pagination. | IBM i Developer, IBM i Database |
understand_describe_object | Obtenir un profil complet d'un objet IBM i en un seul appel : métadonnées (attribut, OPM/ILE, bibliothèque, chemin source, propriétaire, groupe d'activation, autorité adoptée, compilateur, dates, SQL dynamique), nombres de dépendances entrantes/sortantes par type, et sections spécifiques au type — liaisons, exportations, importations, colonnes, déclencheurs, clés étrangères, journalisation, entrées de répertoire de liaison et définitions de commandes. | IBM i Developer, IBM i Database |
understand_trace_dependencies | Tracer les dépendances entrantes ou sortantes d'un objet jusqu'à une profondeur configurable, filtrées par type de dépendance (par ex. FILE_OPEN, PGM_CALL, BOUND_SRVPGM). | IBM i Developer, IBM i Database |
understand_find_symbol | Trouver où une procédure ou un symbole exporté est défini et quels objets l'importent (scans IBM i 7.6+). | IBM i Developer, IBM i Database |
Permission d'auto-approbation supplémentaire
Les permissions d'auto-approbation intégrées sont disponibles dans les modes IBM i Developer et IBM i Database. Ces modes disposent également des permissions d'auto-approbation supplémentaires suivantes :
- Documentation : Autorise Bob à utiliser tous les outils de documentation pour récupérer de la documentation IBM i sans demander la permission.
- Understand : Autorise Bob à utiliser tous les outils Understand pour explorer les objets et dépendances IBM i scannés sans demander la permission. Ce groupe de permissions n'est disponible que lorsque le composant Understand est installé.
