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.
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.
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. Também suporta pesquisa de 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. Também suporta pesquisa de conteúdo dentro de um stream file usando regex. | IBM i Developer |
get_table_columns | Obtém metadados de colunas para uma tabela ou visão do Db2 for i, correspondendo tanto nomes SQL quanto de sistema. | 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 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 |
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 suporta transferências de 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 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 |
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.
