Ferramentas
Use ferramentas específicas do IBM i para ler e escrever em membros ou stream files, executar comandos CL, instruções SQL e muito mais.
O IBM Bob Premium Package for i estende as capacidades de ferramentas nativas do Bob com um conjunto de ferramentas específicas para IBM i. Para uma introdução geral sobre como as ferramentas funcionam e quais são as nativas, consulte Ferramentas.
Essas ferramentas são organizadas por função e estão disponíveis para o Bob ao trabalhar nos modos IBM i Developer e IBM i Database, dependendo da ferramenta.
Leitura
Leia e pesquise conteúdo em QSYS ou IFS.
Edição
Crie e escreva conteúdo em QSYS ou IFS.
SQL
Resolva schemas, arquivos, tabelas e comandos no Db2 for i.
Execução
Execute comandos CL, instruções SQL e comandos PASE.
Build
Compile código-fonte IBM i.
Testes
Gere stubs de testes unitários e execute suítes de testes com cobertura de código.
Documentação
Pesquise e obtenha documentação oficial do IBM i, documentação de comandos CL e exemplos SQL.
Understand
Explore objetos de aplicações IBM i escaneados e suas dependências.
Ferramentas de leitura
As seguintes ferramentas de leitura IBM i se enquadram na permissão de auto-aprovação read:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
read_member | Lê o conteúdo de um ou mais membros de fonte em QSYS. | IBM i Developer, IBM i Database |
search_qsys | Pesquisa bibliotecas, objetos ou membros de fonte em QSYS, incluindo conteúdo dentro de um membro usando regex. | IBM i Developer, IBM i Database |
read_stream_file | Lê o conteúdo de um ou mais stream files no IFS. | IBM i Developer |
search_ifs | Pesquisa stream files e diretórios no IFS, incluindo conteúdo dentro de um stream file usando regex. | IBM i Developer |
Ferramentas de escrita
As seguintes ferramentas de escrita IBM i se enquadram na permissão de auto-aprovação write:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
write_member | Cria um novo membro de fonte ou sobrescreve um existente em QSYS. | IBM i Developer |
write_stream_file | Cria um novo stream file ou sobrescreve um existente no IFS. | IBM i Developer |
generate_dds | Gera código-fonte DDS para arquivos físicos (PF), arquivos lógicos (LF), arquivos de display (DSPF) e arquivos de impressora (PRTF) a partir de entrada estruturada, com validação pré-escrita para problemas comuns de layout. | IBM i Developer |
Ferramentas de execução
As seguintes ferramentas de execução IBM i se enquadram na permissão de auto-aprovação execute:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
execute_cl_command | Executa um comando CL no IBM i. Por padrão, o Bob exige que os comandos sejam qualificados por biblioteca (ex.: QSYS/...) e sugere automaticamente incluir parâmetros para gerar arquivos de evento ao compilar código-fonte. A ativação desse mecanismo de proteção para comandos CL qualificados é configurável nas configurações da extensão. | IBM i Developer |
execute_sql_statement | Executa uma instrução SQL no IBM i. Certos tipos de instrução SQL (como DROP, UPDATE, TRUNCATE) exigem aprovação explícita do usuário antes da execução. Esse conjunto de tipos de instrução negados é configurável nas configurações da extensão. | IBM i Developer, IBM i Database |
execute_pase_command | Executa um comando PASE no IBM i. | IBM i Developer |
convert_rpg_source | Executa o comando CL de conversão de fonte RPG (CVTRPGSRC) para converter código-fonte RPG III ou RPG/400 para o novo formato RPG IV. Essa ferramenta também transfere arquivos entre todos os três workspaces. | IBM i Developer |
Ferramentas de build
As seguintes ferramentas de build IBM i se enquadram na permissão de auto-aprovação execute:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
get_compile_actions | Recupera ações do Code for IBM i predefinidas para um arquivo específico. Para arquivos locais, isso será recuperado das ações locais do projeto, armazenadas em .vscode/actions.json. Para membros de fonte ou stream files, isso será recuperado a partir de ações padrão e definidas pelo usuário na conexão. | IBM i Developer |
execute_compile_action | Executa uma ação do Code for IBM i específica, recuperada pela ferramenta get_compile_actions, em um arquivo específico. | IBM i Developer |
Ferramentas de teste
As seguintes ferramentas de teste IBM i se enquadram nas permissões de auto-aprovação read e execute:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
generate_rpg_unit_test_stub | Gera stubs de teste RPGUnit a partir de um arquivo RPGLE ou SQLRPGLE contendo procedimentos exportados. Isso realiza o mesmo objetivo que gerá-los pelo gerador de stubs de teste do IBM i Testing. | IBM i Developer |
run_rpg_unit_test_suite | Compila e executa suítes de testes RPGUnit com cobertura de código opcional por linha (*LINE) ou por procedimento (*PROC). | IBM i Developer |
Ferramentas SQL
As seguintes ferramentas SQL IBM i se enquadram na permissão de auto-aprovação execute:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
get_schema_info | Resolve um nome de biblioteca ou schema tanto para o nome de sistema (10 caracteres, para comandos CL) quanto para o nome de schema SQL (até 128 caracteres, para instruções SQL). Trata nomes comuns, nomes longos de schema SQL e identificadores delimitados. | IBM i Developer, IBM i Database |
get_file_info | Resolve um nome de tabela ou arquivo para seus metadados completos, incluindo nome de sistema, nome SQL, tipo de objeto e descrição. Resolve corretamente nomes comuns, nomes longos de tabela SQL, aliases SQL e identificadores delimitados sensíveis a maiúsculas. | IBM i Developer, IBM i Database |
get_table_columns | Obtém metadados de colunas para uma tabela ou visão do Db2 for i, usando correspondência sem distinção de maiúsculas para nomes SQL e de sistema, incluindo identificadores delimitados e nomes com maiúsculas e minúsculas misturadas. | IBM i Database |
get_cl_command_library | Busca cada biblioteca em que um comando CL está registrado, incluindo detalhes de comandos proxy para qualificação correta de biblioteca. | IBM i Developer, IBM i Database |
Ferramentas de documentação
As seguintes ferramentas de documentação IBM i se enquadram na permissão de auto-aprovação documentation:
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
search_ibm_i_docs_with_rag | Usa RAG (retrieval-augmented generation) para encontrar documentação do IBM i quando você precisa responder a perguntas conceituais ou abertas sobre IBM i que exigem compreensão semântica em vez de correspondência exata de palavras-chave. Abrange todos os tópicos do IBM i, incluindo: programação ILE (RPG, CL, DDS, COBOL, C, C++), Db2 for i SQL, sistemas de arquivos IFS e QSYS, operações de sistema, segurança, desempenho, rede, armazenamento e troubleshooting. Retorna trechos de documentação contextualmente relevantes classificados por similaridade semântica à consulta. | IBM i Developer, IBM i Database |
fetch_cl_command_doc | Busca a documentação de um comando CL no IBM i conectado, incluindo descrições de parâmetros, exemplos de uso e possíveis mensagens de erro. Essa documentação é gerada usando o comando CL GENCMDDOC. | IBM i Developer, IBM i Database |
search_sql_examples | Pesquisa exemplos de SQL que fazem uso de serviços SQL específicos dos exemplos SQL definidos na extensão Db2 for IBM i. | IBM i Developer, IBM i Database |
fetch_sql_example | Busca o conteúdo completo de um exemplo SQL recuperado pela ferramenta search_sql_examples. | IBM i Developer, IBM i Database |
Ferramentas do Understand
As seguintes ferramentas do Understand fazem parte da permissão de auto-aprovação Understand. Elas só estão disponíveis quando o componente Understand está instalado.
| Ferramenta | Finalidade | Disponível em |
|---|---|---|
understand_list_apps | Lista todas as aplicações Understand registradas no sistema IBM i conectado. | IBM i Developer, IBM i Database |
understand_app_summary | Obtém uma visão geral arquitetural de um app em uma chamada: inventário de objetos por tipo e linguagem, contagens de dependências, os objetos mais dependidos e mais acoplados, sinais de risco e modernização (programas OPM, SQL dinâmico, autoridade adotada, entry points, arquivos físicos sem registro de journal), regras de banco de dados (foreign keys, cascade deletes, triggers), avisos do scan e bibliotecas referenciadas fora do app. | IBM i Developer, IBM i Database |
understand_find_objects | Pesquisa objetos escaneados pelo Understand. Combine filtros para wildcards de nome, tipo, biblioteca, atributo/linguagem, OPM vs ILE, uso de SQL dinâmico, sem dependências de entrada e não usado desde N dias. Ordene por dependências de entrada para encontrar os objetos mais críticos. Retorna nome, tipo, atributo, OPM/ILE, biblioteca, contagens de dependências entrada/saída, data do último uso e indicador de SQL dinâmico, com suporte a paginação. | IBM i Developer, IBM i Database |
understand_describe_object | Obtém um perfil completo de um objeto IBM i em uma única chamada: metadados (atributo, OPM/ILE, biblioteca, caminho do fonte, proprietário, grupo de ativação, autoridade adotada, compilador, datas, SQL dinâmico), contagens de dependências entrada/saída por tipo e seções específicas por tipo — bindings, exportações, importações, colunas, triggers, foreign keys, journaling, entradas do binding directory e definições de comando. | IBM i Developer, IBM i Database |
understand_trace_dependencies | Rastreia as dependências de entrada ou saída de um objeto até uma profundidade configurável, filtradas por tipo de dependência (ex.: FILE_OPEN, PGM_CALL, BOUND_SRVPGM). | IBM i Developer, IBM i Database |
understand_find_symbol | Encontra onde um procedimento ou símbolo exportado está definido e quais objetos o importam (scans IBM i 7.6+). | IBM i Developer, IBM i Database |
Permissão de auto-aprovação adicional
As permissões de auto-aprovação nativas estão disponíveis nos modos IBM i Developer e IBM i Database. Esses modos também terão as seguintes permissões de auto-aprovação adicionais:
- Documentation: Permite que o Bob use todas as ferramentas de documentação para recuperar documentação do IBM i sem pedir permissão.
- Understand: Permite que o Bob use todas as ferramentas do Understand para explorar objetos IBM i escaneados e dependências sem pedir permissão. Este grupo de permissão só está disponível quando o componente Understand está instalado.
