Editando Membros RPG, COBOL, CL, C, C++ e DDS

Utilize o editor LPEX do Remote Systems para editar os membros de origem. Esse editor tem muitos recursos interessantes e conhecidos oferecidos para RPG, COBOL, CL, e DDS, como a verificação de sintaxe, colocação automática de maiúsculas, verificação de programas e assim por diante.

No conteúdo da ajuda, expanda o editor LPEX para obter informações sobre como utilizar tais recursos, os quais estão disponíveis, também, no editor Remote Systems LPEX, como Comandos, Ações e Parâmetros do Editor e Inserindo e Editando Textos.

Dica: Você pode alternar entre os arquivos abertos na visualização do editor pressionando Ctrl+F6.
Restrição: O editor LPEX do Remote Systems não suporta a edição de membros de origem na biblioteca QTEMP.

Para abrir a origem no editor LPEX do Remote Systems:

  1. Expanda a conexão na visualização Remote Systems até localizar o arquivo que deseja editar.
  2. Dê um clique duplo no arquivo ou clique com o botão direito no arquivo e selecione Open With > Remote Systems LPEX Editor.
Dica: Para abrir rapidamente os membros do iSeries, você pode utilizar o atalho do teclado Ctrl+Shift+A ou clicar com o botão direito do mouse em iSeries Objects e selecionar Open Member, sem a necessidade de pesquisar detalhadamente o subsistema iSeries Objects para localizar o membro. Consulte Abertura Rápida para Membros do iSeries para obter informações adicionais.

Consulte as instruções a seguir e os links para as informações da página de preferências, para obter informações sobre as tarefas comuns que podem ser executadas com o editor LPEX do Remote Systems, como compilação e verificação. Muitas dessas opções estão disponíveis no menu pop-up no editor ou nos itens de menu Source, Compiler e Edit do workbench.

Tarefas freqüentes que podem ser executadas com o editor LPEX do Remote Systems:


Salvamento automático durante edição: Para ativar ou desativar o salvamento automático durante a edição no editor LPEX do Remote Systems, é necessário alterar uma preferência do editor. Clique no item de menu Window > Preferences > Remote Systems > LPEX Editor e clique na caixa de opções Autosave. O valor padrão de Minutes between saves está configurado como 5. Você pode especificar um valor entre 1 e 60 minutos. Se o workbench for fechado inesperadamente durante a edição de um arquivo, reinicie o workbench e reabra o arquivo que estava sendo editado. Se houver um backup desse arquivo, será solicitado que você o abra para edição.


Prompt de origem: Se estiver utilizando o editor LPEX do Remote Systems, achará mais fácil editar com o solicitante de origem. Para chamar o solicitante de origem, clique em qualquer lugar dentro de seu arquivo e pressione F4. Também é possível clicar em Source > Prompt no menu do workbench.


Atualizando o editor: Para remover as mensagens de erro da origem, execute uma Atualização a partir do menu do workbench clicando em Source > Refresh. Também é possível pressionar Ctrl+F5 para atualizar o editor.


Comparando arquivos: Para comparar um membro atualmente aberto com outro membro, clique em Edit > Compare > Compare na barra de menus. Também é possível selecionar dois itens na visualização Remote Systems mantendo pressionada a tecla Ctrl e clicando nos dois itens. Clique com o botão direito do mouse e selecione Compare > Each other. Os dois membros serão chamados lado a lado, com as alterações realçadas.


Atalhos pelo teclado: Utilize os seguintes atalhos pelo teclado durante a edição de texto.
  • Alt+L: para selecionar uma única linha ou bloco de linhas
  • Alt+C: para copiar
  • Alt+M para mover
  • Alt+D para excluir as linhas selecionadas
  • Alt+U para cancelar a seleção de todas as linhas
  • F1 para chamar a ajuda sensível ao idioma
  • F4 para chamar a solicitação de origem
  • Ctrl+Shift+C para compilar
  • Ctrl+F5 para atualizar a origem e remover as mensagens de erro de apresentação de linhas
  • Ctrl+Shift+V para verificar
    • Após verificação, pressione Ctrl+Shift+H para ir para o próximo problema e Ctrl+Shift+Y para ir para o problema anterior.
Consulte também Perfis do Editor para obter informações adicionais sobre as combinações de teclas do editor LPEX.


Abrindo uma Declaração de Sub-rotina ou de Procedimento com F3: Para abrir uma declaração de sub-rotina ou de procedimento em um arquivo ILE RPG, coloque o cursor em uma palavra ou parte de texto selecionada e pressione F3. O editor procurará uma sub-rotina ou procedimento com esse nome na origem atual e reposicionará o cursor em seu local.

Dicas e restrições:
  • O texto selecionado não pode conter espaços ou estender-se além de uma linha.
  • Se o texto contiver um colchete, '(', apenas o texto até ele será utilizado para a pesquisa (para permitir a seleção de parâmetros).
  • Se a linha atual tiver um opcode de EXSR ou CASxx, a pesquisa procurará uma sub-rotina. Caso contrário, procurará um procedimento por padrão.
  • Os nomes continuados não são suportados.
  • Se a procura não localizar uma sub-rotina ou procedimento, o cursor não será reposicionado e a edição poderá continuar normalmente.


Recuperando conteúdo de um arquivo remoto: Para inserir o conteúdo de um membro remoto no membro aberto atualmente, clique em File > Get File. Na caixa de diálogo, navegue pelos diretórios utilizando a estrutura de visualização em árvore. Selecione o arquivo que deseja inserir e clique em OK.


Ativando a ajuda sensível ao contexto: Durante a edição de uma origem, pressione F1 a qualquer momento com o cursor em uma palavra-chave para obter sua ajuda sensível ao contexto.


Seleção de linha: Para selecionar uma linha de origem, coloque o cursor no local da linha que deseja selecionar. Em seguida, clique com o botão direito do mouse e selecione Select line. Clique novamente com o botão direito do mouse e execute ações como Syntax Check Selection, Convert Selection To Free-Form, Cut, Copy, etc.
Nota: A opção Highlight Current Line está localizada na página Controls das preferências do Editor LPEX. Para abrir a janela Preferences, selecione o item de menu Window > Preferences. Na janela Preferences, selecione LPEX Editor > Controls. A opção Highlight Current Line é selecionada por padrão. Para alterar a cor de destaque da linha atual, selecione Appearance em LPEX Editor, clique em currentLine em Styles e clique no botão ao lado de Background para abrir a paleta de cores. Após ter selecionado uma nova cor, clique em OK para fechar a paleta de cores, depois clique em OK na janela Preferences para aplicar as alterações. Para obter informações adicionais sobre a opção highlightCurrentLine, consulte Parâmetros do Editor e clique em highlightCurrentLine na lista de nomes de parâmetros.


Mostrando a área de data: Para que o editor LPEX do Remote Systems exiba a área de data em sua origem, será necessário alterar uma preferência do editor. Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Na janela Preferences, selecione a caixa de opções Show date area. Você também pode clicar com o botão direito do mouse enquanto o cursor estiver na origem e selecionar Show date area no menu pop-up.


Verificação de sintaxe: Para executar a verificação de sintaxe, no menu Source ou no menu pop-up (com o cursor na origem), selecione Syntax Check Line ou Syntax Check All. A verificação de sintaxe é ativada para execução automática sempre que uma linha editada ou inserida é movida.
  • Para desativar ou reativar a verificação automática de sintaxe, clique no menu drop-down na visualização Remote Systems e selecione Preferences > iSeries LPEX Editor Parsers. Na janela Preferences, do lado esquerdo, há duas entradas para CL, COBOL, DDS, ILE RPG e RPG/400. Para cada tipo de membro de origem, é possível especificar se você deseja ou não ativar a verificação automática de sintaxe. Por exemplo, clique em CL no lado esquerdo da janela e selecione ou limpe a caixa de opções Automatic syntax checking na área Preferences.
  • A verificação de sintaxe também é executada pelos tipos de arquivo SQLRPGLE e SQLCBLLE com instruções SQL incorporadas. Este tipo de verificação de sintaxe, entretanto, requer uma conexão ativa a um servidor iSeries remoto, porque as instruções SQL têm a sintaxe verificada no host. Para desativar a verificação automática de sintaxe de instruções SQL, clique no menu drop-down na visualização Remote Systems e selecione Preferences > iSeries LPEX Editor Parsers. Na janela Preferences, expanda iSeries LPEX Editor Parsers e anote as entradas para COBOL e ILE RPG. Clique em uma dessas entradas e limpe a caixa de opções para Automatic syntax checking of SQL statements (performed on the server).


Comandos de prefixo: Para utilizar comandos de prefixo como P, I5, DD/DD e outros, clique dentro da coluna à esquerda que exibe números como "000014", digite o comando e pressione Enter. Consulte o links relacionados e documentos de referência à linguagem para obter uma lista de comandos de prefixo para cada linguagem. Consulte também Perfil base SEU para obter informações adicionais de comandos de prefixo SEU.


Colocação automática de maiúsculas: Para que o editor LPEX do Remote Systems converta automaticamente a origem de minúsculas em maiúsculas durante a edição, será necessário alterar uma preferência do editor. Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Na janela Preferences, do lado esquerdo, há duas entradas para CL, COBOL, DDS, ILE RPG e RPG/400. Para cada tipo de membro de origem, é possível especificar se você deseja ou não ativar a colocação automática de maiúsculas. Por exemplo, clique em CL do lado esquerdo da janela e selecione a caixa de opções Automatic uppercasing na área preferences.


Recuo automático: Para que o editor LPEX do Remote Systems recue automaticamente a origem durante a edição, será necessário alterar uma preferência do editor. Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Na janela Preferences, do lado esquerdo, há duas entradas para CL, COBOL, DDS, ILE RPG e RPG/400. Para o ILE RPG e o CL, é possível especificar se você deseja ou não ativar o recuo automático e quantos espaços deseja que a origem seja recuada (ao pressionar Enter). Por exemplo, clique em ILE RPG do lado esquerdo da janela e selecione a caixa de opções Automatic indent do lado direito da janela.Em seguida, especifique também o número de espaços a serem recuados no campo Blanks (1-20).


Tabulação definida pelo usuário: Você pode ajustar a tabulação da origem durante a edição, customizando a tabulação definida pelo usuário. Essa opção está disponível como uma preferência do analisador do editor LPEX do iSeries. Para customizar a tabulação definida pelo usuário:
  1. Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Na janela Preferences, do lado esquerdo, há entradas para CL, COBOL, DDS, ILE RPG e RPG/400. É possível especificar a tabulação definida pelo usuário para todos esses tipos de origem, exceto para o DDS.
  2. Selecione um dos tipos de origem aplicáveis e selecione a caixa de opções User defined tabs.
  3. Se aplicável, altere o esquema de tabulação na caixa drop-down.
  4. Posicione o mouse na área de tabulação (com as marcas ^) e clique duas vezes para incluir ou remover uma tabulação. No campo And every, também é possível especificar a freqüência de inclusão de tabulações depois da última seleção.


Customizando a tecla Enter: Ao editar a origem ILE ou não-ILE (OPM) RPG, você pode controlar o comportamento da tecla Enter, em que se pode alterar a ação que resultará ao pressionar Enter. Por padrão, o pressionamento de Enter repete o tipo de especificação anterior na origem. No entanto, esse comportamento pode ser alterado para repetir o código de operação anterior, se uma especificação C estiver sendo editada ou para mover o cursor para uma coluna específica, etc. Para controlar esse comportamento, será necessário acessar as preferências do editor. Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Selecione ILE RPG e modifique uma das entradas do lado direito da janela abaixo de Enter key behavior.


Especificando uma linha de formato para a origem: Durante a edição da origem ILE ou não-ILE (OPM) RPG, é possível selecionar uma linha de formato específica para as linhas de sua origem. A linha de formato, que aparece no início do editor, indica onde as colunas de instrução devem ficar. Para selecionar um formato de linha:
  • Clique com o botão direito do mouse com o cursor na linha especificada e selecione Select line.
  • No menu do workbench, selecione Source > Select format lineSource > Select format line.
  • Selecione uma linha de formato na lista drop-down na caixa de diálogo e clique em OK.


Abrindo os membros /COPY e copy book: Sua origem pode conter as instruções /copy ou copy book, que indica que o código de outro membro de origem deve ser incluído quando o membro atual é compilado. Por exemplo, uma instrução /copy poderia apontar para um procedimento existente em outro membro de origem. Esses membros /copy permitem o compartilhamento de código entre os membros de origem. No editor LPEX do Remote Systems, você pode abrir o membro /copy ou copy book para navegação ou edição.
  • Para a origem RPG, com o membro de origem aberto no editor, coloque o cursor no local da instrução /copy. No menu do workbench, selecione Source > /COPY member > Edit, para editar o membro de origem (e travá-lo no servidor iSeries) ou Source > /COPY member > Browse apenas para abrir o membro de origem para visualização.
  • Para a origem COBOL, coloque o cursor no local da instrução copy book. No menu do workbench, selecione Source > Copy Book > Edit, para editar o membro de origem (e travá-lo no servidor iSeries) ou Source > Copy Book > Browse apenas para abrir o membro de origem para visualização.


Filtrando por tipos de linhas: Sua origem pode conter vários tipos diferentes de tipos de linhas, como linhas de erro, linhas de procedimento, etc. É possível subdividir em conjuntos por esses tipos de linhas, ou seja, você remove do filtro os outros tipos de linhas, exceto o selecionado. No exemplo da origem ILE RPG, para subdividir em conjuntos por tipo de linha, clique com o botão direito do mouse enquanto o cursor está dentro da origem, selecione Filter view > e selecione entre um dos seguintes:
  • Por data
  • Válido
  • Comentários
  • Controle
  • Procedimentos
  • Instruções SQL
  • Sub-rotinas
  • Erros
(Para tipos diferentes de origem, como CL ou DDS, essas opções são diferentes). Sua origem mostrará agora apenas as linhas do tipo selecionado. Para exibir toda a origem novamente, é só expandir o sinal de adição para a esquerda da origem filtrada. Para exibir toda a origem novamente, selecione Show all no menu pop-up ou pressione Ctrl+W. Também é possível utilizar os sinais de adição à esquerda da origem filtrada para reexpandir a origem que foi removida da filtragem.


Mostrando as informações de dados descritas externamente: Se você tiver um arquivo descrito externamente em sua origem, poderá exibir os campos para esse arquivo. Coloque o cursor no local do arquivo descrito externamente. No menu do workbench, clique em Source > Show fields. Também é possível clicar com o botão direito do mouse dentro da origem e selecionar Show fields. A visualização da tabela iSeries Field é aberta em seguida e exibe os campos do arquivo descrito externamente.
Dica: É possível arrastar e soltar um banco de dados do iSeries ou campo de arquivo de visualização, a partir da visualização de tabela do Campo iSeries do Remote System Explorer em um arquivo HTML ou JSP no Page Designer, para criar um campo de Entrada de Texto do Componente da Web do iSeries. O novo nome do campo de Entrada de Texto e os atributos de dados serão herdados do campo selecionado.


Edição sensível à coluna: Você pode ativar a edição sensível à coluna para todas as origens RPG e DDS. Isto significa que as suas guias estão configuradas para movê-lo até as colunas definidas, e conforme você digita na coluna, os dados nas outras colunas não são deslocados. Para ativar essa preferência, na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers. Na janela Preferences, selecione a caixa de opções Column sensitive editing.


Suporte ao ponto de interrupção: Você pode definir pontos de interrupção em uma seção de código executável. Para definir um ponto de interrupção, clique com o botão direito do mouse e selecione Add breakpoint. Quando o código for depurado, o depurador parará nos pontos de interrupção e deixará avançar ou atravessar o código nesse ponto, se houver erros. Consulte Pontos de interrupção para obter informações adicionais.


Re-seqüenciamento de arquivo: É uma preferência que pode ser definida para o editor LPEX do Remote Systems. Os membros de origem contêm números de seqüência semelhantes aos números das linhas. Se você tiver incluído ou excluído linhas de código durante a edição, poderá querer que os arquivos sejam re-seqüenciados mediante Salvamento, para que não haja intervalo nos números de seqüência. Para definir essa preferência:
  • Na visualização Remote Systems, clique no menu drop-down e selecione Preferences > iSeries LPEX editor parsers.
  • Na janela Preferences, selecione a caixa de opções para Resequence lines at save.
  • Se aplicável, altere o campo para Resequence start em (1-9999) para especificar com qual número de seqüência iniciar e IResequence increment em (1-9999) para especificar o incremento dos números de seqüência linha a linha, por exemplo, se você digitar 10 neste campo, os números de seqüência poderão ser os seguintes: 100, 110, 120, etc.
Para acessar a página de preferências do editor LPEX, na visualização Remote Systems, clique no menu drop-down e selecione Preferences > LPEX editor. Consulte Perfis do Editor para obter informações adicionais.


A seguinte tabela indica os recursos suportados no editor com um asterisco (*):
  ILE RPG e não-ILE RPG ILE COBOL e não-ILE COBOL CL, CMD, CLP e CLLE DDS C e C++
Suporte a múltiplas visualizações * * * * *
Filtrar por tipos de linhas * * * * *
Localização de marcadores no código fonte * * * * *
Ativando a Ajuda Sensível ao Contexto (Pressionando F1) e a SEU help * * * * *
Re-seqüenciamento de arquivo * * * * *
Comandos de prefixo * * * * *
Comportamento da tecla SEU * * * * *
Assistência ao conteúdo * *      
Formatador de origem automática     *    
Seleção de linha * * * *  
Edição sensível de coluna *     *  
Suporte ao ponto do interrupção * * *   *
Compilando * * * *  
Prompt de Origem * * * *  
Verificação da sintaxe * * * *  
Colocação automática de maiúsculas * * * *  
Visualização Contorno * *   *  
Mostrar informações de dados descritos externamente * * *    
Abrir os membros /COPY e COPYBOOK * *      
Tabulações definidas pelo usuário * * *    
Tecla Enter customizável *        
Formatar linhas *        
Suporte ao gabarito * (apenas para ILE RPG) * (apenas para ILE COBOL)     * (apenas para C++)
Verificação do programa * (apenas para ILE RPG) * * * (exceto para ICFF)  
Alinhamento automático * (apenas para ILE RPG)   *    
Conversão de código de formato fixo em código de formato livre * (apenas para ILE RPG)        
Criando um procedimento RPG * (apenas para ILE RPG)        
Criando uma chamada de método Java RPG * (apenas para ILE RPG)        
Criando uma especificação D de RPG * (apenas para ILE RPG)        
Abrindo uma Declaração de Sub-rotina ou de Procedimento com F3 * (apenas para ILE RPG)        
Conceitos relacionados
Edição
Assistência ao Conteúdo
Editando Origem com Ajuda da Visualização Outline
Tarefas relacionadas
Criando um Procedimento RPG no Editor LPEX do Remote Systems
Criando uma Especificação de Definição de RPG no Editor LPEX do Remote Systems
Criando uma Chamada de Método Java de RPG no Editor LPEX do Remote Systems
Convertendo o Código ILE RPG do Formato Fixo para o Formato Livre
Customizando o Formatador Automático CL
Editando a Origem em Múltiplas Visualizações
Compilando seus Programas
Concluindo Código com a Assistência ao Conteúdo
Utilizando Editores Diferentes no Remote System Explorer
Customizando o Formatador Automático CL
Referências relacionadas
Verificadores de Programas iSeries
Analisadores do Editor LPEX do iSeries