Depurando uma tarefa com prompt completo

Para depurar um job com prompt completo de parâmetros de lançamento, crie uma configuração de lançamento para a sessão de depuração.

Para criar uma configuração de lançamento, proceda da seguinte forma:

  1. Abra a caixa de diálogo de configurações de ativação Debug.Instruções para isto podem ser encontradas em Iniciando a depuração.
  2. Na área de janela esquerda da caixa de diálogo das configurações de ativação Debug, clique com o botão direito na entrada iSeries: Debug Job e selecione New no menu pop-up.
  3. No campo Name da configuração de lançamento, insira um nome exclusivo de sua escolha para a configuração que está sendo criada.
    Dica: Este nome aparecerá no menu Debug para reativação.
  4. Selecione as guias de configuração de lançamento e preencha-as de acordo com as tabelas nas seções a seguir:
  5. Quando todas as informações obrigatórias para a configuração de ativação tiverem sido fornecidas, os botões de comando Debug e Apply serão ativados. Clique em Apply para salvar a configuração de ativação para ser executada posteriormente ou clique em Debug para ativar uma sessão de depuração com as novas configurações. Será solicitado que você chame seu aplicativo no job especificado. Quando o programa for chamado, a sessão de depuração será lançada.

    Após salvar uma configuração de lançamento da depuração, será possível editá-la. Para obter mais informações sobre a edição de configurações de lançamento de depuração, consulte a tarefa relacionada a seguir.

    Dica: Se você ainda não salvou as definições de configuração de ativação e fez entradas nas definições de configuração de ativação que deseja remover ou alterar, clicar em Revert removerá todas as alterações efetuadas.
  6. Se as informações obrigatórias para a configuração de lançamento ainda não tiverem sido fornecidas ou se houver erros nas informações fornecidas, mensagens na parte superior da caixa de diálogo indicarão o que falta.
  7. Para fechar o diálogo sem iniciar uma sessão de depuração, clique em Close.

Guia What to Debug

Selecione a guia What to Debug para colocá-la em primeiro plano. A não ser que seja especificado de outra forma, todos os campos dessa guia devem ser preenchidos para que uma sessão de depuração possa ser iniciada.

Grupo Definições
Conexão Nesta seção, você seleciona o nome de uma conexão do Remote System existente a partir do menu pull down. Essa conexão deve ser para o servidor iSeries que contém o job que deseja depurar. Se a conexão ainda não tiver sido criada, clique em New para ativar um assistente que permitirá criar uma nova conexão.
Job Nesta seção, você digita informações completas sobre o job que deseja depurar:
  • Name: Digite o nome do job, como identificado para o sistema, por exemplo, QPADEV0017.
  • User: Digite o perfil do usuário no qual o job está sendo executado, por exemplo, MYUSER.
  • Number: Digite o número do job designado pelo sistema, por exemplo, 001234.

É possível utilizar curingas ('*') em qualquer um desses campos e, em seguida, selecionar Browse para recuperar um subconjunto de jobs disponíveis (ativo ou na fila) no sistema iSeries. Nessa lista, é possível selecionar o job que deseja depurar e suas informações serão utilizadas para preencher os campos acima.

Nota: É necessário especificar um job exclusivo existente no host do iSeries, caso contrário, será exibida uma mensagem de erro.
Programas ou programas de serviços a serem depurados Nesta seção, você digita informações sobre os programas e programas de serviços que serão depurados. É possível especificar vários programas. Clique em Add para incluir um programa ou programa de serviços na lista. Para depurar um aplicativo em execução e parar na próxima instrução executável, certifique-se de que nenhum programa ou programa de serviços esteja especificado nesta seção.
  1. Library: No diálogo Add a program or service program, no campo Library, digite a biblioteca que contém o programa que deseja depurar. As informações sobre a especificação do nome válido da biblioteca podem ser localizadas no tópico relacionado abaixo. Selecione Browse, se desejar procurar pela biblioteca.
  2. Selecione Program ou Service Program e digite o nome no campo apropriado. Selecione Browse, se desejar procurar por uma lista de programas ou programas de serviços disponíveis na biblioteca especificada no sistema iSeries.
  3. Clique OK.
Step Into Se essa caixa de opções não estiver selecionada, o depurador parará no primeiro ponto de interrupção encontrado. Isso poderia ser o ponto de interrupção de um perfil (um definido em uma sessão de depuração anterior) ou um ponto de interrupção de origem (um definido no editor Debugger antes de iniciar a depuração).

Se Step into estiver selecionado:

  • Se você especificou um programa inicial ou programa de serviços para depurar na tabela Programs or service programs to be debugged, o depurador irá para o objeto do programa ou programa de serviços especificado.
  • Se você não especificou nenhum programa ou programa de serviços na tabela Programas ou programas de serviços a serem depurados, o depurador parará na próxima instrução depurável no aplicativo.
Terminate debug session on program completion Se isto for selecionado e um programa válido (mas não um programa de serviços) for especificado como o programa inicial na tabelaProgramas ou programas de serviços a serem depurados, a sessão de depuração será finalizada na conclusão da execução do programa.
Atualizar arquivos de produção Se a caixa de opções Atualizar arquivos de produção for selecionada, o aplicativo que está sendo depurado poderá atualizar registros do banco de dados nas bibliotecas de produção.

Guia Source

Grupo Definições
Caminho de Consulta da Origem Por padrão, os contêineres de origem do mecanismo Default e Debug do iSeries são listados. O contêiner de origem Default do iSeries permite que o depurador procure pela origem no local a partir do qual o objeto do programa é compilado. O contêiner de origem do mecanismo Depurar fornece o texto para visualizações diferentes da visualização *SOURCE (por exemplo, visualização *LISTING ou visualização *STATEMENT). É possível especificar seu próprio caminho de consulta de origem:
  1. Clique em Add para incluir seu próprio caminho de origem do IFS.
  2. No diálogo Add Source, clique em iSeries Source File ou Remote Folder.
    • Selecione iSeries Source File, se a origem residir nos arquivos físicos de origem. Clique em OK. No diálogo "Select one or more source physical files", navegue para os arquivos físicos de origem.
    • Selecione Remote Folder se a origem residir no IFS. Clique em OK. No diálogo "Browse for a folder", navegue para a pasta remota que contém a origem.
  3. Clique em OK. A origem é incluída na lista sob o Source Lookup Path.
  4. Clique em Apply. É possível incluir vários caminhos de origem. A seqüência na qual serão listados é a seqüência na qual o depurador procura pela origem.
Procurar por arquivos de origem duplicados no caminho Se essa caixa de opções não estiver selecionada, o depurador procurará os caminhos especificados na seqüência e utilizará a primeira ocorrência. Se essa caixa de opções estiver selecionada, o depurador procurará os caminhos especificados e listará todas as ocorrências, permitindo que você selecione uma.

Guia Advanced

Grupo Definições
Endereço do nome do host da estação de trabalho
  • Automatically detect host name of your workstation: O depurador deve poder determinar o nome do host TCP/IP da estação de trabalho. Essa configuração deve funcionar na maior parte dos casos.

    Se a estação de trabalho tiver vários endereços IP em redes diferentes e você tiver dificuldade para iniciar a sessão de depuração, especifique explicitamente o endereço IP ou o nome do host da estação de trabalho.

  • Specify host name of your workstation: Se estiver selecionada, especifique o endereço IP da estação de trabalho no campo Host name of your workstation.

Guia Common

Selecione a guia Common para colocá-la em primeiro plano e fazer o seguinte:

  1. Se desejar que a configuração de lançamento seja armazenada localmente e fique disponível para apenas um usuário, assegure que o botão de opções Local esteja selecionado. Se a configuração de ativação deve ser armazenada como um arquivo no espaço de trabalho e compartilhada em um repositório para uso pela equipe, selecione o botão de rádio Shared e digite o local do projeto no qual deseja que a configuração de ativação seja armazenada, no campo Location of shared configuration.Como alternativa, é possível procurar o projeto.
  2. Para que a configuração de ativação apareça no menu de favoritos de Debug ou na lista Debug History do menu Debug, selecione a caixa de opções Debug na área "Display in favorites menu".