© Copyright International Business Machines Corporation 1992, 2024. Todos os Direitos Reservados.
Nota aos Usuários do Governo dos EUA -- Documentação relacionada a direitos restritos -- Uso, duplicação ou divulgação está sujeita a restrições estabelecidas em contrato GSA ADP Schedule com IBM Corp.

Índice

Figuras

Introdução

Materiais do programa

Suporte do Programa

Informações de Nível de Programa e Serviço

Requisitos de Instalação e Considerações

Instruções de instalação

Avisos

Comentários do Leitor

Figuras

Introdução

Esse diretório do programa é direcionado a programadores de sistema que são responsáveis pela instalação e manutenção de programas. Contém informações sobre o material e procedimentos associados à instalação do IBM z/OS Debugger. Esta publicação se refere ao IBM z/OS Debugger como z/OS Debugger.

z/OS Debugger está disponível como um componente de diversos produtos. Dependendo de qual produto você adquiriu, diferentes funções do z/OS Debugger serão ativadas ou desativadas.

• IBM Developer for z/OS Enterprise Edition 17.0.0, número do programa 5755-AB5 (Shopz orderable)
• IBM Developer for z/OS 17.0.0, número do programa 5724-T07 ( Passport Advantage orderable)
• IBM Debug for z/OS 17.0.0, número do programa 5755-AB6 (Shopz orderable)

O Diretório do Programa contém as seguintes seções:

• "Materiais de programa" identifica os materiais do programa básico e documentação para o z/OS Debugger.

• "Suporte ao programa" descreve o suporte IBM disponível para o z/OS Debugger.

• "Informações de nível de serviço e programa" lista os APARs (nível do programa) e PTFs (nível de serviço) que foram incorporados ao z/OS Debugger.

• "Requisitos de instalação e considerações" identifica os recursos e considerações que são necessários para instalação e uso do z/OS Debugger.

• "Instruções de instalação" fornece instruções detalhadas de instalação para o z/OS Debugger. Também descreve os procedimentos para ativação das funções do z/OS Debugger ou refere-se a publicações apropriadas.

O restante desta seção só se aplica quando o pedido do z/OS Debugger é feito via Shopz. Não se aplica quando transferido por download.
Selecione este link acessar a próxima seção: "Descrição do z/OS Debugger"

Antes de instalar o z/OS Debugger, leia o Memorando CBPDO para usuários e a Extensão do memorando CBPDO para usuários que são fornecidos com este programa em formato eletrônico e este diretório do programa, após o qual, mantenha os documentos para sua referência. A seção "Planejamento preventivo de serviços" informa como localizar quaisquer atualizações nas informações e procedimentos nesse diretório do programa.

O z/OS Debugger é fornecido em uma CBPDO (Custom-Built Product Delivery Offering) (CBPDO, 5751-CS3). O diretório do programa fornecido em formato eletrônico na CBPDO será idêntico ao formato de cópia impressa, se ele tiver sido incluído com o pedido. Todos os serviços e HOLDDATA para o z/OS Debugger estão incluídos na CBPDO.

Não use esse diretório de programa se você instalar o z/OS Debugger com uma instância de software portátil z/OSMF ( ServerPac ). Ao utilizar uma dessas ofertas use as tarefas e documentação fornecidas com as ofertas. A oferta irá apontar para você seções específicas deste diretório do programa conforme necessário.

Descrição do z/OS Debugger

IBM z/OS Debugger ajuda os desenvolvedores de aplicativos de z/OS a depurar programas em execução em uma variedade de ambientes, como batch, TSO, CICS, IMS, Db2, Db2 Stored Procedures e z/OS UNIX System Services.

FMIDs do z/OS Debugger

O z/OS Debugger consiste nos FMIDs a seguir:

HADRH00

JADRH0J

O restante desta seção só se aplica quando o pedido do z/OS Debugger é feito via Shopz. Não se aplica quando transferido por download.
Selecione este link para acessar a próxima seção: "Materiais de programa"

Você receberá os materiais a seguir:

• Se você fizer o pedido apenas o recurso de base, receberá os materiais a seguir:

  • z/OS Base do depurador (FMID HADRH00 )

• Se você fizer o pedido de ambos os recursos base e japonês, receberá os materiais a seguir:

  • z/OS Base do depurador (FMID HADRH00 )

  • z/OS Depurador japonês (FMID JADRH0J )

Materiais do programa

Um programa IBM é identificado por um número de programa.

z/OS Debugger está disponível como um componente de diversos produtos. Dependendo de qual produto você adquiriu, diferentes funções do z/OS Debugger serão ativadas ou desativadas.

• IBM Developer for z/OS Enterprise Edition 17.0.0, número do programa 5755-AB5 (Shopz orderable)
• IBM Developer for z/OS 17.0.0, número do programa 5724-T07 ( Passport Advantage orderable)
• IBM Debug for z/OS 17.0.0, número do programa 5755-AB6 (Shopz orderable)

Materiais Básicos Legíveis por Máquina são materiais que são fornecidos sob a licença base e são necessários para o uso do produto.

O material de lançamento do programa descreve os recursos suportados pelo z/OS Debugger. Solicite ao seu representante IBM por essas informações se ainda não tiver recebido uma cópia.

Material básico legível por máquina

O meio de distribuição deste programa é mídia física ou arquivos que podem ser transferidos por download. Este programa está em formato SMP/E RELFILE e é instalado usando SMP/E. Consulte "Instruções de instalação" para obter informações adicionais sobre como instalar o programa.

O restante desta seção só se aplica quando o pedido do z/OS Debugger é feito via Shopz. Não se aplica quando transferido por download.
Selecione este link para acessar a próxima seção: "Publicações do programa"

É possível localizar informações sobre a mídia física para os materiais básicos legíveis por máquina para o z/OS Debugger na Extensão do memorando CBPDO para usuários.

A Tabela 1 descreve o conteúdo de arquivo do programa para o z/OS Debugger. É possível consultar o Extensão do memorando da CBPDO para usuários para ver onde os arquivos residem na imagem.

Notas:

1. Os atributos do conjunto de dados nesta tabela devem ser usados na JCL de tarefas que leem os conjuntos de dados. No entanto, como os conjuntos de dados estão no formato descarregado IEBCOPY, seus atributos reais podem ser diferentes.

2. Se algum RELFILE for identificado como PDSE, certifique-se de que os conjuntos de dados SMPTLIB sejam alocados como PDSE.

Tabela 1. Conteúdo do arquivo de programa -- Base

Tabela 2. Conteúdo do arquivo do programa -- Japonês

Publicações do programa

As seções a seguir identificam as publicações básicas para o z/OS Debugger.

A Tabela 3 identifica as publicações básicas de programas não licenciados para o z/OS Debugger.

Tabela 3. Material básico: publicações não licenciadas

Observação: essas publicações básicas não licenciadas podem ser encontradas em IBM Documentação de produtos https://www.ibm.com/docs/en/products e pelo link direto listado na tabela.

Observação: As informações necessárias podem ser obtidas criando um relatório para o z/OS Debugger em https://www.ibm.com/software/reports/compatibility/clarity/index.html.

Materiais fonte do programa

Nenhum material de origem do programa ou listagens de programas visualizáveis são fornecidos para o z/OS Debugger.

Publicações úteis durante a instalação

Talvez você queira usar as publicações listadas na Tabela 4 durante a instalação do z/OS Debugger, que podem ser encontradas em IBM Products documentation, https://www.ibm.com/docs/en/products.

Tabela 4. Publicações úteis durante a instalação

Suporte ao programa

Esta seção descreve o suporte IBM disponível para o z/OS Debugger.

Serviços de Programa

Entre em contato com o seu representante IBM para obter informações específicas sobre os serviços de programas disponíveis.

Planejamento de Serviço Preventivo

Antes de instalar o z/OS Debugger, certifique-se de revisar as informações sobre o bucket PSP para os produtos IBM Z no documento https://www.ibm.com/support/pages/node/7127792. Ele contém as informações mais recentes sobre a instalação dos produtos IBM, incluindo as recomendações de serviço mais recentes e as dependências entre produtos. Essas informações estavam disponíveis anteriormente nos baldes PSP tradicionais, que não são mais publicados para os produtos do site IBM Z.

Para obter suporte, acesse o site de suporte do software em https://www.ibm.com/mysupport/

Instrução de procedimentos de suporte

Relate quaisquer problemas que achar ser um erro nos materiais do produto para o seu Centro de Suporte IBM. Você pode ser solicitado a reunir e enviar diagnósticos adicionais para ajudar o Centro de Suporte IBM em sua análise.

A Tabela 5 identifica as IDs de componentes (COMPID) para o depurador z/OS.

Tabela 5. IDs de Componentes

Informações do nível de serviço e do programa

Esta seção identifica o programa e os níveis de serviço relevantes do z/OS Debugger. O nível do programa refere-se às correções APAR que foram incorporadas ao programa. O nível do serviço refere-se aos PTFs que foram incorporados ao programa.

Informações de nível do programa

Todos os APARs resolvidos de liberações anteriores do z/OS Debugger foram incorporados ao z/OS Debugger.

Informações de nível de serviço

Nenhum PTFs foi incorporado ao pacote do produto em relação a esta liberação do z/OS Debugger.

Consulte frequentemente https://www.ibm.com/support/pages//fix-list-ibm-zos-debugger para obter a lista completa de PTFs disponíveis para este produto.

Observação: A aplicação de um PTF pode aumentar o nível de modificação relatado pelo z/OS Debugger, causando uma incompatibilidade entre a versão solicitada ( 17.0.0 ) e a versão relatada ( 17.0.x ).

Requisitos e considerações de instalação

As seções a seguir identificam os requisitos do sistema para instalação e ativação do z/OS Debugger. A seguinte terminologia é utilizada:

• Sistema de direcionamento: o sistema no qual o SMP/E para z/OS é executado para instalar o programa.

  O programa pode ter requisitos específicos de sistema operacional ou nível de produto para o uso de processos, como utilitários de ligação e montagem, durante a instalação.

• Sistema de destino: o sistema no qual o programa é configurado e executado.

  O programa pode ter requisitos específicos de níveis de produto, como a necessidade de acesso à biblioteca de outro produto para edição de links. Estes requisitos, obrigatórios ou opcionais, podem afetar diretamente o elemento durante a instalação na sua operação básica ou aprimorada.

Em muitos casos, é possível utilizar um sistema como ambos, um sistema de direcionamento e um sistema destino. Entretanto, é possível fazer um clone separado capacitado para IPL do sistema em execução para ser usado como um sistema destino. O clone deve incluir cópias de todas as bibliotecas do sistema que atualiza o SMP/E, cópias dos conjuntos de dados SMP/E CSI que descrevem as bibliotecas do sistema, e seu PARMLIB e PROCLIB.

Use sistemas de direcionamento e destino separados nas seguintes situações:

• Quando instalar um novo nível de um produto que já está instalado, o novo nível do produto irá substituir o antigo. Instalando o novo nível em sistemas destino separados, é possível testar o novo nível e manter o antigo em produção ao mesmo tempo.

• Quando instalar um produto que compartilha bibliotecas e módulos de carregamento com outros produtos, a instalação pode prejudicar os outros produtos. Instalando o produto em sistemas destino separados, é possível avaliar esses impactos sem prejudicar sue sistema de produção.

Requisitos do sistema de direcionamento

Esta seção descreve o ambiente do sistema de direcionamento necessário para instalar o z/OS Debugger.

Requisitos da máquina

O sistema de direcionamento pode ser executado em qualquer ambiente de hardware que suporte os softwares necessários.

Requisitos de programação

Tabela 6. Conduzindo requisitos de software do sistema de

Nota: SMP/E é um requisito para Instalação e é um elemento do z/OS.

Observação: a instalação pode requerer a migração para novas liberações do z/OS para que haja suporte de serviço. Consulte https://www.ibm.com/support/lifecycle/

z/OS O depurador é instalado em um sistema de arquivos. Antes de instalar o z/OS Debugger, você deve garantir que os conjuntos de dados do sistema de arquivos do sistema de destino estejam disponíveis para processamento no sistema de condução. O OMVS deve estar ativo no sistema de direcionamento e os conjuntos de dados de arquivos do sistema de destino devem ser montados no sistema de direcionamento.

zFS deve estar ativo no sistema de direção. Informações sobre a ativação e o uso do site zFS podem ser encontradas em z/OS Distributed File Service zSeries File System Administration ( SC24-5989 ).

Requisitos do sistema de destino

Esta seção descreve o ambiente do sistema de destino necessário para instalar e utilizar o z/OS Debugger.

Instala-se o z/OS Debugger no z/OS (Z038) SREL.

Requisitos da máquina

O sistema de destino pode ser executado em qualquer ambiente de hardware que suporte os softwares necessários.

Requisitos de programação

Requisitos de instalação

Os Requisitos de instalação identificam os produtos que são necessários e que devem estar presentes no sistema ou produtos que não são necessários mas deveriam estar presentes no sistema para que a instalação deste produto seja bem sucedida.

Os requisitos obrigatórios de instalação identificam os produtos que são necessários no sistema para que a instalação deste produto seja bem sucedida. Estes produtos são especificados como PREs ou REQs.

O z/OS Debugger não possui requisitos de instalação obrigatórios.

Os requisitos de instalação condicionais identificam os produtos que não são necessários para a instalação bem sucedida deste produto porém podem resolver algumas coisas, como certas mensagens de aviso durante a instalação. Estes produtos são especificados como IF REQs.

O z/OS Debugger não possui requisitos de instalação condicionais.

Requisitos operacionais

Os requisitos operacionais são produtos que são necessários e devem estar presentes no sistema ou produtos que não são necessários mas deveriam estar presentes no sistema para que este produto opere todas ou parte de suas funções.

Os requisitos operacionais obrigatórios identificam produtos que são necessários para que este produto opere suas funções básicas.

Tabela 7. Requisitos operacionais obrigatórios no sistema de destino

Nota: A instalação pode exigir a migração para novas liberações para obter suporte. Consulte https://www.ibm.com/support/lifecycle/

Os requisitos operacionais condicionais identificam os produtos que não são necessários para que este produto opere suas funções básicas porém são necessários em tempo de execução para que este produto opere funções específicas. Estes produtos são especificados como IF REQs.

A Tabela 8 lista o serviço necessário para os requisitos operacionais do site z/OS. Instale os PTFs apropriados de acordo com o nível do seu sistema operacional.

Tabela 8. Serviço para os requisitos operacionais do z/OS

A Tabela 9 lista os requisitos operacionais condicionais.

Tabela 9. Requisites operacionais condicionais do sistema de destino

Nota: A instalação pode exigir a migração para novas liberações para obter suporte. Consulte https://www.ibm.com/support/lifecycle/

A Tabela 10 lista o serviço necessário para os requisitos operacionais condicionais. Instale os PTFs apropriados de acordo com o nível do seu produto.

Tabela 10. Serviço para requisitos operacionais condicionais

A Tabela 11 lista versões antigas de produtos de requisitos operacionais condicionais que não estão mais em serviço.

IBM se comprometerá a corrigir qualquer problema com o z/OS Debugger que puder encontrar ao executar o z/OS Debugger com esses níveis não suportados. No entanto, a IBM deve ser capaz de reproduzir o problema usando um nível suportado do mesmo produto.

Se o problema puder ser reproduzido e corrigido, a correção para o z/OS Debugger será desenvolvida e testada usando os níveis suportados do produto. Se uma correção for disponibilizada, é provável que funcione no nível de produto não suportado. No entanto, a IBM não pode garantir que a correção funcionará neste caso.

Tabela 11. Requisitos operacionais condicionais fora de suporte

A Tabela 12 lista o serviço necessário para as versões antigas dos produtos de requisitos operacionais condicionais da Tabela 11. Instale os PTFs apropriados de acordo com o nível do seu produto.

Tabela 12. Serviço para requisitos operacionais condicionais fora de suporte

Requisitos de tolerância/coexistência

Os requisitos de tolerância/coexixtência identificam os produtos que devem ser apresentados nos sistemas de compartilhamento. Esses sistemas podem ser outros sistemas em um ambiente de multissistema (não necessariamente o sysplex), um ambiente DASD compartilhado (como teste e produção) ou sistemas que reutilizam o mesmo ambiente DASD em diferentes intervalos de tempo.

z/OS Debugger não possui requisitos de tolerância / coexistência.

Requisitos (negativos) de incompatibilidade

Os requisitos negativos identificam produtos que não devem estar instalados no mesmo sistema que este produto.

z/OS Debugger não tem requisitos negativos.

Requisitos de armazenamento de DASD

As bibliotecas do z/OS Debugger podem residir em todos os tipos DASD suportados.

A Tabela 13 lista o espaço total necessário para cada tipo de biblioteca.

Tabela 13. Espaço DASD total necessário por z/OS Depurador -- Base

Tabela 14. Espaço DASD total necessário por z/OS Debugger -- Japonês

Notas:

1. Para conjuntos de dados não RECFM U, a IBM recomenda o uso de tamanhos de bloco determinados pelo sistema para uma utilização eficiente do DASD. Para conjuntos de dados RECFM U, a IBM recomenda o uso de um tamanho de bloco de 32760, que é mais eficiente na perspectiva de performance e de utilização do DASD.

2. Abreviações usadas para tipos de conjuntos de dados são mostradas como segue.

   U	Conjunto de dados único, alocado por este produto e usado apenas por este produto. Esta tabela fornece todas as informações necessárias para se determinar o armazenamento correto para este conjunto de dados. Não é preciso referir-se a outras tabelas ou diretórios de programa para obter o tamanho do conjunto de dados.
   S	Conjunto de dados compartilhado, alocado por este produto e usado por este e outros produtos. Para determinar o correto armazenamento necessário para este conjunto de dados, some o tamanho do armazenamento fornecido nesta tabela a aqueles fornecidos em outras tabelas (talvez em outros diretórios de programa). Se o conjunto de dados já existir, ele deve ter espaço livre o suficiente para acomodar o tamanho de armazenamento fornecido nesta tabela.
   E	Conjunto de dados compartilhado existente, usado por este produto e outros produtos. Este conjunto de dados não é alocado por este produto. Para determinar o correto armazenamento para este conjunto de dados, some o tamanho do armazenamento fornecido nesta tabela aqueles fornecidos em outras tabelas (talvez em outros diretórios de programa). Se o conjunto de dados já existir, ele deve ter espaço livre o suficiente para acomodar o tamanho de armazenamento fornecido nesta tabela.

   Se atualmente tiver uma liberação anterior deste produto instalada nestas bibliotecas, a instalação desta liberação irá excluir as liberações antigas e recuperar o espaço que estava sendo usado pela liberação antiga e qualquer serviço que tivesse sido instalado. É possível determinar se essas bibliotecas têm espaço suficiente excluindo a liberação antiga com uma função simulada, comprimindo as bibliotecas, e comparando os requisitos de espaço com o espaço livre nas bibliotecas.

   Para obter mais informações sobre os nomes e tamanhos dos conjuntos de dados necessários, consulte "Alocar bibliotecas de destino e distribuição do SMP/E para z/OS".

3. Todas as bibliotecas de destino e distribuição listadas têm os seguintes atributos:
   • O nome padrão do conjunto de dados pode ser mudados.
   • O tamanho de bloco padrão do conjunto de dados pode ser mudado.
   • O conjunto de dados pode ser mesclado com outro conjunto de dados que tenha características equivalentes.
   • O conjunto de dados pode ser um PDS ou um PDSE, com algumas exceções. Se o valor na coluna "ORG" especificar "PDS", o conjunto de dados deverá ser um PDS. Se o valor na coluna "DIR Blks" especificar "N/A", o conjunto de dados deverá ser um PDSE.

4. Todas as bibliotecas listadas têm os seguintes atributos:
   • Estes conjuntos de dados podem ser gerenciados por SMS, mas eles não precisam ser gerenciados por SMS.
   • Estes conjuntos de dados não precisam residir no volume IPL.
   • Os valores na coluna "Tipo de Membro" não são necessariamente os tipos reais de elemento SMP/E que são identificados no SMPMCS.

5. Todas as bibliotecas de destino que estão listadas e contém módulos de carregamento têm os seguintes atributos:
   • Esses conjuntos de dados não podem estar no LPA, com algumas exceções. Se o valor na coluna "Tipo de membro" especificar "LPA", será aconselhado colocar o conjunto de dados no LPA.
   • Estes conjuntos de dados podem estar no LNKLST.
   • Esses conjuntos de dados não precisam ser autorizados por APF, com algumas exceções. Se o valor na coluna "Tipo de membro" especificar "APF", o conjunto de dados deverá ser autorizado pelo APF.

As figuras a seguir descrevem as bibliotecas de destino e distribuição necessárias para instalar o z/OS Debugger. Os requisitos de armazenamento do z/OS Debugger devem ser incluídos ao armazenamento necessário por outros programas que possuam dados na mesma biblioteca.

Observação: use os dados nessas tabelas para determinar quais bibliotecas podem ser mescladas em conjuntos de dados comuns. Além disso, uma vez que alguns nomes da ALIAS podem não ser exclusivos, certifique-se de que nenhum conflito de nomenclatura será introduzido antes de mesclar bibliotecas.

Tabela 15. Requisitos de armazenamento para as bibliotecas de destino do z/OS Debugger -- Base

• O SEQALPA deve ser um PDS.

• SEQAAUTH, SEQAMOD, e SEQABMOD deve ser um PDS/E.

• SEQAMENU, SEQAPENU, e SEQASENU são bibliotecas ISPF em Inglês com letras maiúsculas e minúsculas combinadas.

• SEQAMENP, SEQAPENP e SEQASENP são bibliotecas ISPF em Inglês com letras maiúsculas.

• Consulte a seção "Choosing a method to start z/OS Debugger Utilities" no capítulo "Customizing z/OS Debugger Utilities" no IBM z/OS Debugger Customization Guide para obter considerações adicionais se quiser mesclar essas bibliotecas ISPF nas bibliotecas comuns do sistema.

Tabela 16. Requisitos de armazenamento para as bibliotecas de destino do z/OS Debugger -- Japonês

• SEQAMOD, e SEQABMOD deve ser um PDS/E.

• SEQAMJPN, SEQAPJPN, e SEQASJPN são bibliotecas ISPF em Japonês.

• Consulte a seção "Choosing a method to start z/OS Debugger Utilities" no capítulo "Customizing z/OS Debugger Utilities" no IBM z/OS Debugger Customization Guide para obter considerações adicionais se quiser mesclar essas bibliotecas ISPF nas bibliotecas comuns do sistema.

Tabela 17. z/OS Caminhos do sistema de arquivos do depurador

Tabela 18. Requisitos de armazenamento para as bibliotecas de distribuição do z/OS Debugger -- Base

Tabela 19. Requisitos de armazenamento para as bibliotecas de distribuição do z/OS Debugger -- Japonês

O restante desta seção só se aplica quando o z/OS Debugger é transferido por download da web. Não se aplica quando pedido pelo Shopz.
Selecione este link para acessar a próxima seção: "FMIDs excluídos"

Os números a seguir listam conjuntos de dados que não são usados pelo z/OS Debugger, mas são necessários como entrada para SMP/E.

Tabela 20. Requisitos de armazenamento para conjuntos de dados obtidos por download da web do z/OS Debugger -- Base

Tabela 21. Requisitos de armazenamento para conjuntos de dados obtidos por download da web do z/OS Debugger -- Japonês

FMIDs excluídos

Instalando o z/OS Debugger pode resultar na exclusão de outros FMIDs. Para ver quais FMIDs serão excluídos, examine a instrução ++VER no SMPMCS do produto.

Se você não quiser excluir esses FMIDs neste momento, instale o z/OS Debugger em zonas de destino e distribuição de SMP/E separadas.

Observação: esses FMIDs não são excluídos automaticamente da zona global. Se você desejar excluir esses FMIDs da zona global, use o comando SMP/E REJECT NOFMID DELETEFMID. Consulte o livro Comandos do SMP/E para z/OS para obter detalhes.

Considerações Especiais

Bibliotecas de destino que contêm módulos de carregamento possuem algumas considerações especiais. Depois de ter instalado com sucesso o produto, execute as etapas a seguir:

• Coloque o SEQALPA na lista LPA incluindo-o a um membro LPALSTxx de parmlib que será usado para o IPL.

• Coloque SEQABMOD na lista de links incluindo-o a uma instrução LNKLST ADD para ele a um membro PROGxx de parmlib que será usado para o IPL.

• Autorize SEQAAUTH por APF, e SEQABMOD, incluindo instruções APF ADD para eles a um membro PROGxx de parmlib que será usado para o IPL. Os outros conjuntos de dados do módulo de carregamento podem ser autorizados por APF, mas ele não é necessário.

• Certifique-se de que os conjuntos de dados LPA, e autorizados por APF, têm acessos controlados. Isso para evitar a execução não autorizada dos programas dentro, e para evitar que programas sejam incluídos aos conjuntos de dados.

• Para facilitar o acesso pelos usuários, pode-se colocar SEQAMOD na lista de links incluindo uma instrução LNKLST ADD para ele a um membro PROGxx de parmlib que será usado para o IPL.

Instruções de instalação

Este capítulo descreve o método de instalação e os procedimentos passo a passo para instalar e ativar as funções de z/OS Debugger.

Observe o seguinte:

• Se você deseja instalar o z/OS Debugger em seu próprio ambiente SMP/E, consulte os manuais SMP/E para obter instruções sobre a criação e a inicialização do SMPCSI e os conjuntos de dados de controle SMP/E.

• É possível utilizar as tarefas de amostra fornecidas para executar parte ou todas as tarefas de instalação. As tarefas SMP/E assumem que todas as entradas DDDEF que são necessárias para a execução do SMP/E foram definidas nas zonas apropriadas.

• É possível utilizar os diálogos do SMP/E ao invés das tarefas de amostra para executar as etapas de instalação do SMP/E.

Instalando o z/OS Debugger

Considerações SMP/E para instalaçã do z/OS Debugger

Utilize os comandos SMP/E RECEIVE, APPLY e ACCEPT para instalar esta liberação do z/OS Debugger.

Valores de subentrada de opções do SMP/E para z/OS

Os valores recomendados para determinadas subentradas do SMP/E CSI são mostrados na Tabela 22. Usando valores menores que os valores recomendados pode resultar em falhas na instalação. A DSSPACE é uma subentrada na entrada de opções GLOBAL. A PEMAX é uma subentrada da entrada GENERAL na entrada de opções GLOBAL. Consulte os manuais do SMP/E para obter instruções sobre a atualização da zona global.

Tabela 22. Valores de subentrada de opções SMP/E

Processamento SMP/E CALLLIBS

O z/OS Debugger usa a função CALLLIBS fornecida no SMP/E para resolver referências externas durante a instalação. Quando o z/OS Debugger estiver instalado, certifique-se de que DDDEFs existem para as bibliotecas a seguir:

• SCEELKED
• CSSLIB
• SEZATCP

Nota: CALLLIBS usa os DDDEFs anteriores apenas para resolver o link-edit para z/OS Debugger. Esses conjuntos de dados não são atualizados durante a instalação do z/OS Debugger.

Visão geral das etapas de instalação

Visão geral de etapas necessárias para instalar o IBM z/OS Debugger.

1. "Alocar sistema de arquivos para suspender pacote de download da web"
   (só aplicável para download da web, não pedidos feitos via Shopz)

2. "Fazer upload do pacote de download da web para o host"
   (só aplicável para download da web, não pedidos feitos via Shopz)

3. "Extrair e expandir o SMPMCS e RELFILEs compactados"
   (só aplicável para download da web, não pedidos feitos via Shopz)

   Selecione este link para pular as etapas específicas da transferência por download da web: "Tarefas de amostra"

4. "Tarefas de amostra"

5. "Executar REPORT MISSINGFIX (opcional)"

6. "Configurar macro do ISPF Editor (opcional)"

7. "Criar ambiente SMP/E (opcional)"

8. "Executar SMP/E RECEIVE"

9. "Alocar bibliotecas SMP/E de distribuição e de destino"

10. "Alocar, criar e montar arquivos ZFS (Opcional)"

11. "Alocar caminhos do sistema de arquivos"

12. "Criar entradas DDDEF"

13. "Executar SMP/E APPLY"

14. "Ativar / registrar o z/OS Debugger"

15. "Executar os IVPs (Installation Verification Programs)"

16. "Verificar o z/OS Debugger Utilities Setup Utility Function"

17. "Executar SMP/E ACCEPT"

18. "Executar REPORT CROSSZONE"

19. "Limpando conjuntos de dados obsoletos, caminhos e DDDEFs"

Alocar o sistema de arquivos para conter o pacote de download da web

Esta seção só se aplica ao transferir o z/OS Debugger por download da web. Não se aplica quando pedido pelo Shopz.
Selecione este link para ignorar as etapas específicas de download da web: "Tarefas de amostra"

Os conjuntos de dados de entrada do SMP/E para instalar o IBM z/OS Debugger são fornecidos como arquivos compactados nos arquivos HADRH00.pax.Z e JADRH0J.pax.Z, que devem ser carregados para z/OS como um arquivo z/OS UNIX. É possível criar um novo sistema de arquivos z/OS UNIX (zFS) ou criar um novo diretório em um sistema de arquivos existente para colocar o pacote de download.

É possível usar a JCL de amostra a seguir para criar um novo sistema de arquivos e um diretório para o pacote de download. A amostra pressupõe que você fará o upload apenas do recurso básico (FMID HADRH00 ). O tamanho do sistema de arquivos deve ser aumentado se você também incluir outros recursos:

• recurso básico, fornecido em HADRH00.pax.Z: 11820 tracks

• Recurso japonês, fornecido em JADRH0J.pax.Z: 120 faixas

//FILESYS  JOB <job information>
//*
//* - Provide valid job card information
//*   - Change:
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*                  - To the absolute z/OS UNIX path for the
//*                    download package (starting with /)
//*                  - Maximum length is 50 characters
//*              - Do not include a trailing /
//*   @zfs_dsn@
//*              - To your file system data set name
//*
//* Your userid MUST be defined as a SUPERUSER to successfully
//* run this job
//*
//CREATE   EXEC PGM=IDCAMS,REGION=0M,COND=(0,LT)
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
  DEFINE CLUSTER ( -
         NAME(@zfs_dsn@) -
         TRK(11820 10) -
         LINEAR -
         SHAREOPTIONS(3) -
         )
//*
//         SET ZFSDSN='@zfs_dsn@'
//FORMAT   EXEC PGM=IOEAGFMT,REGION=0M,COND=(0,LT),
//            PARM='-aggregate &ZFSDSN -compat'
//*STEPLIB  DD DISP=SHR,DSN=IOE.SIOELMOD        before z/OS 1.13
//*STEPLIB  DD DISP=SHR,DSN=SYS1.SIEALNKE       from z/OS 1.13
//SYSPRINT DD SYSOUT=*
//*
//MOUNT    EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC  DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
  PROFILE MSGID WTPMSG
  oshell umask 0022; +
    mkdir -p @zfs_path@
  MOUNT +
    FILESYSTEM('@zfs_dsn@') +
    MOUNTPOINT('@zfs_path@') +
    MODE(RDWR) TYPE(ZFS) PARM('AGGRGROW')
//*

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Fazer upload do pacote de download da web para o host

Esta seção só se aplica ao transferir o z/OS Debugger por download da web. Não se aplica quando pedido pelo Shopz.
Selecione este link para ignorar as etapas específicas de download da web: "Tarefas de amostra"

Faça upload do arquivo HADRH00.readme.txt e, se necessário, do JADRH0J.readme.txt, em formato de texto, e do arquivo HADRH00.pax.Z e, se necessário, do JADRH0J.pax.Z, em formato binário, de sua estação de trabalho para o sistema de arquivos z/OS do UNIX.

No diálogo de amostra a seguir, usamos o FTP de uma linha de comandos do Microsoft Windows para fazer a transferência. Os comandos ou outras informações inseridos pelo usuário estão em negrito, e os valores a seguir serão assumidos:

Tabela 23. Valores inseridos pelo usuário

Emita estes comandos para fazer o upload do z/OS Debugger Base:

C:\>ftp mvsaddr
Conectado a mvsaddr.
220-FTPD1 IBM FTP CS %version% em mvsaddr, %time% em %date%.
220 A conexão será fechada se ficar inativa por mais de 5 minutos.
Usuário (mvsaddr:(none)): tsouid
331 Enviar senha.
Senha: tsopw
230 tsouid está logado.  Diretório de trabalho é "tsouid.".
ftp> cd @zfs_path@
250 Diretório HFS @zfs_path@ é o diretório de trabalho atualftp> ascii
200 Representation type is Ascii NonPrintftp> coloque d:\HADRH00.readme.txt
200 Solicitação de porta OK.
125 Armazenamento do conjunto de dados @zfs_path@/HADRH00.readme.txt
250 Transfer completed successfully.
ftp: 20898 bytes enviados em 0.01 seg. (1366.67 Kb/s)ftp> binary
200 Representation type is Imageftp> coloque d:\HADRH00.pax.Z
200 Solicitação de porta OK.
125 Armazenamento do conjunto de dados @zfs_path@/HADRH00.pax.Z
250 Transfer completed successfully.
ftp: 160344576 bytes enviados em 1.26 segundos. (1040.52 Kb/s)ftp> quit
221 Comando Quit recebido. Adeus.

Emita estes comandos para fazer o upload do recurso z/OS Debugger japonês:

C:\>ftp mvsaddr
Conectado a mvsaddr.
220-FTPD1 IBM FTP CS %version% em mvsaddr, %time% em %date%.
220 A conexão será fechada se ficar inativa por mais de 5 minutos.
Usuário (mvsaddr:(none)): tsouid
331 Enviar senha.
Senha: tsopw
230 tsouid está logado.  Diretório de trabalho é "tsouid.".
ftp> cd @zfs_path@
250 Diretório HFS @zfs_path@ é o diretório de trabalho atualftp> ascii
200 Representation type is Ascii NonPrintftp> coloque d:\JADRH0J.readme.txt
200 Solicitação de porta OK.
125 Armazenamento do conjunto de dados @zfs_path@/JADRH0J.readme.txt
250 Transfer completed successfully.
ftp: 20088 bytes enviados em 0.01 seg. (1323.80 Kb/s)ftp> binary
200 Representation type is Imageftp> coloque d:\JADRH0J.pax.Z
200 Solicitação de porta OK.
125 Armazenamento do conjunto de dados @zfs_path@/JADRH0J.pax.Z
250 Transfer completed successfully.
ftp: 806400 bytes enviados em 1.26 seg. (1115.22 Kb/s)ftp> quit
221 Comando Quit recebido. Adeus.

Extrair e expandir SMPMCS e RELFILEs compactados

Esta seção só se aplica ao transferir o z/OS Debugger por download da web. Não se aplica quando pedido pelo Shopz.
Selecione este link para ignorar as etapas específicas de download da web: "Tarefas de amostra"

Os arquivos HADRH00.readme.txt e JADRH0J.readme.txt carregados na etapa anterior contêm, cada um, um exemplo de JCL para expandir os SMPMCS e RELFILEs compactados dos arquivos HADRH00.pax.Z e JADRH0J.pax.Z carregados em conjuntos de dados para uso pelo trabalho SMP/E RECEIVE. Os JCLs são repetidos aqui para a sua conveniência.

• @zfs_path@ corresponde à variável que você especificou na etapa anterior.

• Se o comando 'oshell' obter um RC=256 e a mensagem "pax: erro de soma de verificação na fita (obteve-se ee2e; esperava-se 0)", o archive não terá sido transferido por upload para o host em formato binário.

• GIMUNZIP aloca conjuntos de dados para corresponder às definições dos conjuntos de dados originais. Erros poderão ocorrer se as rotinas de seu SMS ACS alterarem os atributos usados pelo GIMUNZIP. Se isso ocorrer, especifique um volume gerenciado não SMS para a alocação de conjuntos de dados pelo GIMUNZIP . Por exemplo:
  <ARCHDEF archid="..."
  storclas="storage_class" volume="data_set_volume"
  newname="..."/>

Customize e envie esta JCL para expandir o z/OS Debugger Base:

//EXTRACT  JOB <job information>
//*
//* - Provide valid job card information
//*   - Change:
//*       @PREFIX@
//*       ----+----1----+----2----+
//*                  - To your desired data set name prefix
//*                  - Maximum length is 25 characters
//*                  - This value is used for the names of the
//*                    data sets extracted from the download-package
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*                  - To the absolute z/OS UNIX path for the
//*                    download-package (starting with /)
//*                  - Maximum length is 50 characters
//*              - Do not include a trailing /
//*
//UNPAX    EXEC PGM=BPXBATCH,REGION=0M,COND=(0,LT)
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//STDPARM  DD *
SH cd @zfs_path@/
; pax -rvf HADRH00.pax.Z
//*
//GIMUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,LT)
//*STEPLIB  DD DISP=SHR,DSN=SYS1.MIGLIB
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATHDISP=KEEP,
// PATH='@zfs_path@/'
//SYSIN    DD *

<GIMUNZIP>
<ARCHDEF archid=" IBM.HADRH00.SMPMCS "
         newname=" @PREFIX@.IBM.HADRH00.SMPMCS "/>
<ARCHDEF archid=" IBM.HADRH00.F1 "
         newname=" @PREFIX@.IBM.HADRH00.F1 "/>
<ARCHDEF archid=" IBM.HADRH00.F2 "
         newname=" @PREFIX@.IBM.HADRH00.F2 "/>
<ARCHDEF archid=" IBM.HADRH00.F3 "
         newname=" @PREFIX@.IBM.HADRH00.F3 "/>
<ARCHDEF archid=" IBM.HADRH00.F4 "
         newname=" @PREFIX@.IBM.HADRH00.F4 "/>
<ARCHDEF archid=" IBM.HADRH00.F5 "
         newname=" @PREFIX@.IBM.HADRH00.F5 "/>
<ARCHDEF archid=" IBM.HADRH00.F6 "
         newname=" @PREFIX@.IBM.HADRH00.F6 "/>
<ARCHDEF archid=" IBM.HADRH00.F7 "
         newname=" @PREFIX@.IBM.HADRH00.F7 "/>
<ARCHDEF archid=" IBM.HADRH00.F8 "
         newname=" @PREFIX@.IBM.HADRH00.F8 "/>
<ARCHDEF archid=" IBM.HADRH00.F9 "
         newname=" @PREFIX@.IBM.HADRH00.F9 "/>
<ARCHDEF archid=" IBM.HADRH00.F10 "
         newname=" @PREFIX@.IBM.HADRH00.F10 "/>
<ARCHDEF archid=" IBM.HADRH00.F11 "
         newname=" @PREFIX@.IBM.HADRH00.F11 "/>
</GIMUNZIP>
//*

Customize e envie esta JCL para expandir o recurso z/OS Debugger japonês:

//EXTRACT  JOB <job information>
//*
//* - Provide valid job card information
//*   - Change:
//*       @PREFIX@
//*       ----+----1----+----2----+
//*                  - To your desired data set name prefix
//*                  - Maximum length is 25 characters
//*                  - This value is used for the names of the
//*                    data sets extracted from the download-package
//*   @zfs_path@
//*   ----+----1----+----2----+----3----+----4----+----5
//*                  - To the absolute z/OS UNIX path for the
//*                    download package (starting with /)
//*                  - Maximum length is 50 characters
//*              - Do not include a trailing /
//*
//UNPAX    EXEC PGM=BPXBATCH,REGION=0M,COND=(0,LT)
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//STDPARM  DD *
SH cd @zfs_path@/
; pax -rvf JADRH0J.pax.Z
//*
//GIMUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,LT)
//*STEPLIB  DD DISP=SHR,DSN=SYS1.MIGLIB
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATHDISP=KEEP,
// PATH='@zfs_path@/'
//SYSIN    DD *

<GIMUNZIP>
<ARCHDEF archid="IBM.JADRH0J.SMPMCS"
         newname="@PREFIX@.IBM.JADRH0J.SMPMCS"/>
<ARCHDEF archid="IBM.JADRH0J.F1 "
         newname="@PREFIX@.IBM.JADRH0J.F1"/>
<ARCHDEF archid="IBM.JADRH0J.F2 "
         newname="@PREFIX@.IBM.JADRH0J.F2"/>
<ARCHDEF archid="IBM.JADRH0J.F3 "
         newname="@PREFIX@.IBM.JADRH0J.F3"/>
<ARCHDEF archid="IBM.JADRH0J.F4 "
         newname="@PREFIX@.IBM.JADRH0J.F4"/>
<ARCHDEF archid="IBM.JADRH0J.F5 "
         newname="@PREFIX@.IBM.JADRH0J.F5"/>
<ARCHDEF archid="IBM.JADRH0J.F6 "
         newname="@PREFIX@.IBM.JADRH0J.F6"/>
</GIMUNZIP>
//*

Tarefas de amostra

Os trabalhos de instalação de amostra a seguir são fornecidos como parte do produto para ajudá-lo a instalar o z/OS Depurador:

Tabela 24. Tarefas de instalação de amostra -- BASE

Tabela 25. Tarefas de instalação de amostra -- Japonês

O restante desta seção só se aplica quando o pedido do z/OS Debugger é feito via Shopz. Não se aplica quando transferido por download.
Selecione este link para acessar a próxima seção: "Executar REPORT MISSINGFIX (opcional)"

É possível acessar as tarefas de instalação de amostra executando um SMP/E RECEIVE (consulte a "Executar SMP/E RECEIVE") em seguida, copie as tarefas dos conjuntos de dados SMPTLIB para um conjunto de dados de trabalho para edição e envio. Consulte a Tabela 24 para encontrar o conjunto de dados apropriado.

Também é possível copiar as tarefas de instalação de amostra dos arquivos do produto, enviando a tarefa a seguir. Antes de enviar a tarefa, inclua um cartão de tarefa e mude os parâmetros em letra minúscula para valores em letra maiúscula para atender os requisitos do seu site.

Para copiar as tarefas de amostra parao z/OS Debugger Base, use esta JCL:

//STEP1    EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//IN DD DSN=IBM.HADRH00.F1,
//            DISP=SHR,
//*           VOL=SER=filevol,
//            UNIT=SYSALLDA
//OUT      DD DSNAME=jcl-library-name,
//            DISP=(NEW,CATLG,DELETE),
//            SPACE=(TRK,(15,5,5)),
//            DSNTYPE=LIBRARY,
//*           VOL=SER=dasdvol,
//            UNIT=SYSALLDA
//SYSUT3   DD  UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN    DD *
    COPY INDD=IN,OUTDD=OUT
    SELECT MEMBER=(EQAWEDIT,EQAWSMPE,EQAWRECV,EQAWALOC)
    SELECT MEMBER=(EQAWDDEF,EQAWAPLY,EQAWACPT,EQAWRPXZ)
    SELECT MEMBER=(EQAWZFS,EQAWMKD,EQAWMNT,EQAWMKDR)
//*

Para copiar as tarefas de amostra para o recurso z/OS Debugger japonês, use esta JCL:

//STEP1    EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//IN DD DSN=IBM.JADRH0J.F1,
//            DISP=SHR,
//*           VOL=SER=filevol,
//            UNIT=SYSALLDA
//OUT      DD DSNAME=jcl-library-name,
//            DISP=(NEW,CATLG,DELETE),
//            SPACE=(TRK,(15,5,5)),
//            DSNTYPE=LIBRARY,
//*           VOL=SER=dasdvol,
//            UNIT=SYSALLDA
//SYSUT3   DD  UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN    DD *
    COPY INDD=IN,OUTDD=OUT
    SELECT MEMBER=(EQAWEDIJ,EQAWRECJ,EQAWALOJ)
    SELECT MEMBER=(EQAWDEFJ,EQAWAPLJ,EQAWACPJ)
//*

IN:

filevol é o serial de volume do dispositivo DASD no qual os arquivos transferidos por download residem.

OUT:

jcl-library-name é o nome do conjunto de dados de saída onde as tarefas de amostra são armazenadas.

dasdvol é o número de série do volume do dispositivo DASD onde o conjunto de dados de saída reside. Remova o comentário da instrução se for necessário fornecer um serial de volume.

Executar REPORT MISSINGFIX (opcional)

O comando SMP/E REPORT MISSINGFIX ajuda você a determinar se algum PTF FIXCAT existe que são aplicáveis e ainda não foram instalados. Se você descobrir que existem PTFs que precisam ser instalados, recomendamos que você os instale, antes de instalar o z/OS Debugger.

Antes de instalar o z/OS Debugger, é recomendável que você execute REPORT MISSINGFIX. Isso requer uma zona global com entradas ZONEINDEX que descrevem todas as bibliotecas de destino e distribuição a serem relatadas, e o comando SET BOUNDARY deve especificar a zona global.

Aqui está um comando REPORT MISSINGFIX de amostra para executar em relação ao seu z/OS CSI:

SET BDY(globalzone).
REPORT MISSINGFIX ZONES(targetzone) FIXCAT(IBM.z/OS.Debugger).

Para obter informações adicinais sobre REPORT MISSINGFIX, consulte os manuais do SMP/E.

Configurar macro do ISPF Editor (opcional)

Uma macro do editor do ISPF é fornecida para ajudá-lo na realização de mudanças nas tarefas de instalação do z/OS Debugger SMP/E. A macro permite substituir valores adequados para todas as variáveis necessárias nessas tarefas em vez de ter de fazer as mudanças repetidamente à mão.

• O EQAWEDIT, fornecido com as tarefas SMP/E para o produto base, atualiza as tarefas do SMP/E para o produto base:
  EQAWSMPE, EQAWRECV, EQAWALOC, EQAWZFS, EQAWMKD, EQAWDDEF, EQAWAPLY, EQAWACPT

• EQAWEDIJ, fornecido com as tarefas do SMP/E para o recurso japonês, atualiza as tarefas do SMP/E para o produto base e o recurso japonês:
  EQAWSMPE, EQAWRECV, EQAWALOC, EQAWZFS, EQAWMKD, EQAWDDEF, EQAWAPLY, EQAWACPT,
  EQAWRECJ, EQAWALOJ, EQAWDEFJ, EQAWAPLJ, EQAWACPJ

Edite a macro e forneça os valores adequados. Consulte as instruções na macro para obter informações adicionais.

Depois de fazer as mudanças, copie a macro para qualquer conjunto de dados em seu procedimento de logon do TSO de concatenação SYSEXEC, ou emita os comandos abaixo para tornar a macro imediatamente acessível à sua sessão ISPF atual:

A partir da opção ISPF 6, emita:

ALLOCATE FI(SYSUEXEC) DA('dsn') SHR REU
  onde dsn é o conjunto de dados que mantém a macro
ALTLIB ACTIVATE USER(EXEC)

Consulte as instruções na macro sobre como invocá-la.

Criar ambiente SMP/E (opcional)

Se você estiver usando um CSI existente, não execute a tarefa de amostra EQAWSMPE.

Se você escolher criar um novo ambiente do SMP/E para z/OS para esta instalação, uma tarefa de amostra será fornecida ou você poderá escolher usar seu próprio JCL. Se você optar por utilizar a tarefa de amostra fornecida, edite e envie EQAWSMPE. Consulte as instruções na tarefa de amostra para obter mais informações.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Executar um SMP/E RECEIVE

Se você obteve o z/OS Debugger como parte de uma CBPDO, utilize a tarefa RCVPDO no conjunto de dados CBPDO RIMLIB para receber os FMIDs do z/OS Debugger, serviço e HOLDDATA que estarão incluídos no pacote CBPDO. Para obter mais informações, consulte a documentação que está inclusa no CBPDO.

Também pode-se optar por editar e enviar a tarefa de amostra EQAWRECV para executar o SMP/E RECEIVE para o z/OS Debugger. Consulte as instruções na tarefa de amostra para obter mais informações.

Se o seu pedido contém o recurso japonês, edite e envie a tarefa de amostra EQAWRECJ para executar o SMP/E RECEBA para esse recurso. Consulte as instruções na tarefa de amostra para obter mais informações.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Alocar bibliotecas de distribuição e destino SMP/E

Editar e enviar tarefa de amostra EQAWANGER para alocar as bibliotecas de destino e distribuição do SMP/E para o z/OS Debugger. Consulte as instruções na tarefa de amostra para obter mais informações.

Se o seu pedido contém o recurso japonês, edite e envie a tarefa de amostra EQAWALJO para alocar as bibliotecas de destino e distribuição do SMP/E para esse recurso. Consulte as instruções na tarefa de amostra para obter mais informações.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Alocar, criar e montar arquivos ZFS (opcional)

Esta tarefa aloca, cria um ponto de montagem e monta conjuntos de dados zFS.

Se você planeja instalar oz/OS Debugger em um novo sistema de arquivos do z/OS UNIX, pode-se editar e enviar a tarefa EQAWZFS opcional para executar as tarefas a seguir:

• Crie o sistema de arquivos UNIX do z/OS
• Crie um ponto de montagem
• Monte o sistema de arquivos UNIX do z/OS no ponto de montagem

O sistema de arquivos UNIX do z/OS recomendado é o zFS. O ponto de montagem recomendado é /usr/lpp/IBM/debug.

Antes de executar a tarefa de amostra para criar o sistema de arquivos UNIX do z/OS, deve-se assegurar-se de que OMVS esteja ativo no sistema de direcionamento. O zFS deve estar ativo no sistema de condução se estiver instalando o z/OS Debugger em um sistema de arquivos que é zFS.

Se você criar um novo sistema de arquivos para este produto, considere atualizar o membro BPXPRMxx PARMLIB para montar o novo sistema de arquivos no tempo do IPL. Essa ação poderá ser útil se ocorrer um IPL antes da conclusão da instalação.

MOUNT FILESYSTEM('#dsn')
 MOUNTPOINT( '/usr/lpp/ IBM /debug')
 MODE(RDWR)        /* pode ser MODE(READ) */
 TYPE(ZFS) PARM('AGGRGROW') /* zFS, com extensões */

Consulte as informações a seguir para atualizar as instruções da amostra anterior:

#dsn é o nome do conjunto de dados que contém o sistema de arquivos UNIX do z/OS.

/usr/lpp/IBM/debug é o nome do ponto de montagem em que o sistema de arquivos z/OS UNIX será montado.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Alocar caminhos do sistema de arquivos

O conjunto de dados do sistema de arquivos de destino deve ser montado no sistema de direção ao executar o trabalho de amostra EQAWMKD, pois o trabalho criará caminhos no sistema de arquivos.

Antes de executar o trabalho de amostra para criar os caminhos no sistema de arquivos, é necessário garantir que o OMVS esteja ativo no sistema de condução e que o sistema de arquivos do sistema de destino esteja montado no sistema de condução. zFS deve estar ativo no sistema de direção.

Se você planeja instalar o z/OS Debugger em um novo sistema de arquivos, deve criar o ponto de montagem e montar o novo sistema de arquivos no sistema de condução do z/OS Debugger.

O ponto de montagem recomendado é /usr/lpp/IBM/debug.

Edite e envie o trabalho de amostra EQAWMKD para alocar os caminhos do sistema de arquivos para o depurador z/OS. Consulte as instruções na tarefa de amostra para obter mais informações.

Se você criar um novo sistema de arquivos para este produto, considere atualizar o membro BPXPRMxx PARMLIB para montar o novo sistema de arquivos no tempo do IPL. Essa ação poderá ser útil se ocorrer um IPL antes da conclusão da instalação.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Criar entradas DDDEF

Edite e envie a tarefa EQAWDDEF de amostra para criar entradas DDDEF para as bibliotecas de destino e distribuição do SMP/E para o z/OS Debugger. Consulte as instruções na tarefa de amostra para obter mais informações.

Se o seu pedido contém o recurso japonês, edite e envie a tarefa EQAWDEFJ de amostra para criar entradas DDDEF para as bibliotecas de destino e distribuição do SMP/E para esse recurso. Consulte as instruções na tarefa de amostra para obter mais informações.

Códigos de retorno e mensagens esperados: você receberá um código de retorno 0 se esta tarefa for executada corretamente.

Executar um SMP/E APPLY

1. Certifique-se de que você tem o HOLDDATA mais recente e, em seguida, edite e envie a tarefa EQAWAPLY de amostra para executar um SMP/E APPLY CHECK para o z/OS Debugger. Consulte as instruções na tarefa de amostra para obter mais informações.

   Se o seu pedido contém o recurso japonês, edite e envie a tarefa EQAWAPLJ de amostra para executar um SMP/E APPLY CHECK para esse recurso. Consulte as instruções na tarefa de amostra para obter mais informações.

   O HOLDDATA mais recente está disponível em vários portais diferentes, incluindo https://public.dhe.ibm.com/s390/assigns/ ou https://www.ibm.com/support/pages/enhanced-holddata-zos para obter instruções de uso. O HOLDDATA mais recente pode identificar os APARs HIPER e FIXCAT para os FMIDs que você instalará. Um APPLY CHECK ajudará a determinar se algum APAR HIPER ou FIXCAT se aplica aos FMIDs que você está instalando. Se houver algum APAR HIPER ou FIXCAT aplicável, o APPLY CHECK também identificará as PTFs que resolverão os APARs, caso haja uma PTF de correção disponível.

   É necessário instalar os FMIDs independentemente do status dos APARs HIPER ou FIXCAT não resolvidos. No entanto, não implemente o software até que os APARs HIPER e FIXCAT não resolvidos tenham sido analisados para determinar suas aplicabilidades. Ou seja, antes de implementar o software assegure-se de as PTFs sejam aplicadas para resolver todos os APARs HIPER ou FIXCAT, ou assegure-se de que os problemas relatados por todos os APARs HIPER ou FIXCAT não se apliquem ao seu ambiente.

   Para receber os benefícios integrais do Relatório de resumo de SYSMOD (modificação do sistema) do causador do SMP/E para z/OS, não efetue bypass de PRE, ID, REQ e IFREQ no APPLY CHECK. A análise de causa raiz do SMP/E para z/OS somente identifica a causa dos erros e não dos avisos (o SMP/E para z/OS trata as condições PRE, ID, REQ e IFREQ que sofreram bypass como avisos, ao invés de erros).

   Aqui estão os comandos APPLY de amostra:

   1. Para assegurar que todo serviço recomendado e crítico esteja instalado com os FMIDs, receba o HOLDDATA mais recente e use o comando APPLY CHECK conforme mostrado a seguir

      APPLY S(fmid,fmid,...) CHECK
      FORFMID(fmid,fmid,...)
      SOURCEID(RSU*)
      FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE)
      FIXCAT(IBM.z/OS.Debugger)
      GROUPEXTEND  .
      

      
      

      Alguns APARs HIPER podem ainda não ter PTFs de correção disponíveis. Deve-se analisar as sinalizações de sintomas para os APARs HIPER não resolvidos para determinar se o problema relatado é aplicável ao seu ambiente e se há a necessidade de efetuar bypass nos ERROR HOLDs específicos, para poder continuar com a instalação dos FMIDs.

      Este método exige uma pesquisa inicial maior, mas pode fornecer a resolução para todos os HIPERs que possuem PTFs de correção disponíveis e não estão em uma cadeia PE. PEs ou HIPERs não resolvidos podem ainda existir e precisar do uso do BYPASS.

   2. Para instalar os FMIDs sem levar em consideração os APARs HIPER não resolvidos, é possível incluir o operando BYPASS(HOLDCLASS(HIPER)) para o comando APPLY CHECK. Isso permitirá a instalação dos FMIDs, mesmo que um ou mais APARs HIPER não resolvidos existam. Após os FMIDs serem instalados, use o comando SMP/E REPORT ERRSYSMODS para identificar APARs HIPER não resolvidos e quaisquer PTFs de correção.

      Também pode-se incluir BYPASS (HOLDFIXCAT) para indicar que os APARs mantidos associados com os IDs de razão da categoria de correção especificados, como o IBM.z/OS.Debugger, não deve ser mantido. Se uma lista de IDs de razão da categoria de correção não for incluída, todos os IDs de razão da categoria de correção serão ignorados.

      APPLY S(fmid,fmid,...) CHECK
      FORFMID(fmid,fmid,...)
      SOURCEID(RSU*)
      FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE)
      FIXCAT(IBM.z/OS.Debugger)
      GROUPEXTEND
      BYPASS(HOLDCLASS(HIPER),HOLDFIXCAT) .
       ..quaisquer outros parâmetros documentados no diretório do programa
      

      Este método é mais rápido, porém exige revisão subsequente do relatório SYSMOD de exceção produzido pelo comando REPORT ERRSYSMODS para investigar quaisquer HIPERs não resolvidos. Se você tiver recebido o HOLDDATA mais recente, também será possível optar por usar o comando REPORT MISSINGFIX e especificar a categoria de correção IBM.PRODUCTINSTALL-REQUIREDSERVICE para investigar o serviço recomendado ausente.

      Se você efetuou bypass dos HOLDs durante a instalação dos FMIDs, porque os PTFs de correção ainda não estavam disponíveis, será possível ser notificado quando os PTFs de correção estarão disponíveis usando a função APAR Status Tracking (AST) do ServiceLink ou a função Rastreio do APAR do ResourceLink.

2. Após tomar ações que as indicadas pelo APPLY CHECK, remova o operando CHECK e execute a tarefa novamente para executar o APPLY.

   Observação: o operando GROUPEXTEND indica que o SMP/E para z/OS aplica todos os SYSMODs de requisito. As SYSMODS requisitadas podem ser aplicáveis a outras funções.

   Códigos de retorno e mensagens esperados de APPLY CHECK: você receberá um código de retorno 0 se essa tarefa for executada corretamente.

   Códigos de retorno e mensagens esperados de APPLY: você receberá um código de retorno 0 se essa tarefa for executada corretamente.

Ativar / registrar z/OS Debugger

Executar os IVPs (Installation Verification Programs)

z/OS Debugger está disponível como um componente de diversos produtos. Dependendo de qual produto foi adquirido, o z/OS Debugger pode oferecer apenas acesso via interface gráfica com o usuário, que faz parte do cliente da estação de trabalho. Isso implica que nessa situação, não é possível executar os IVPs com base em 3270 listados aqui, exceto o EQAWIVPB. O EQAWIVPB possui instruções descrevendo como executá-lo no modo remoto (em vez de tela cheia usando o Terminal Interface Manager).

• IBM Developer for z/OS Enterprise Edition 17.0.0, número do programa 5755-AB5, pode executar todos os IVPs
• IBM Developer for z/OS 17.0.0, número do programa 5724-T07, só pode ser executado EQAWIVPB
• IBM Debug for z/OS 17.0.0, número do programa 5755-AB6, pode executar todos os IVPs

Alguns IVPs requerem que certos PTFs sejam aplicados antes que se possa executá-los com sucesso. Para localizar os PTFs requisitados, execute a tarefa REPORT CROSSZONE, como mostrado na seção "Executar REPORT CROSSZONE".

Alguns IVPs também requerem certa customização para o produto antes que se possa executá-los com sucesso. Consulte as informações específicas em cada tabela abaixo.

Dependendo das linguagens do compilador (COBOL, C, PL/I ou Assembler) que o seu site usa, pode-se executar um ou todos os IVPs. Consulte as instruções em cada IVP para o código de retorno esperado e saída. Todos os IVPs estão na biblioteca SEQASAMP.

A Tabela 26 lista os IVPs para o modo de lote.

Tabela 26. z/OS IVPs do depurador para o modo de lote

A Tabela 27 lista os IVPs para o modo de tela cheia usando o Terminal Interface Manager.

Tabela 27. z/OS IVPs do depurador para o modo de tela cheia usando o Gerenciador de interface de terminal

A Tabela 28 lista os IVPs para execução em CICS no modo de tela cheia.

Tabela 28. z/OS IVPs do depurador para execução em CICS no modo de tela cheia

Verificar a z/OS Debugger Utilities Setup Utility Function

Você pode verificar a instalação e a personalização da função Setup Utility do z/OS Debugger Utilities seguindo um (ou mais) dos exemplos descritos no "Apêndice C". Exemplos: Preparação de programas e modificação de arquivos de configuração com z/OS Debugger Utilities" no IBM z/OS Debugger User's Guide.

Consulte "Personalização dos utilitários do depurador z/OS " no Guia de personalização do depurador IBM z/OS primeiro para obter informações sobre personalização.

Executar um SMP/E ACCEPT

Edite e envie a tarefa EQAWACPT de amostra para realizar um SMP/E ACCEPT CHECK para o z/OS Debugger. Consulte as instruções na tarefa de amostra para obter mais informações.

Se o seu pedido contém o recurso japonês, edite e envie a tarefa EQAWACPJ de amostra para executar um SMP/E ACCEPT CHECK para esse recurso. Consulte as instruções na tarefa de amostra para obter mais informações.

Para receber os benefícios integrais do Relatório de resumo do SYSMOD do causador do SMP/E para z/OS, não efetue bypass de PRE, ID, REQ e IFREQ no ACCEPT CHECK. A análise de causa raiz do SMP/E para z/OS somente identifica a causa dos erros, mas não dos avisos (o SMP/E para z/OS trata as condições PRE, ID, REQ e IFREQ que sofreram bypass como avisos, ao invés de erros).

Antes de usar o SMP/E para carregar novas bibliotecas de distribuição, é recomendado configurar o indicador ACCJCLIN na zona de distribuição. Desta forma, é possível salvar as entradas que são produzidas a partir do JCLIN na zona de distribuição sempre que um SYSMOD que contém JCLIN sequencial é aceito. Para obter mais informações sobre o indicador ACCJCLIN, consulte a descrição do JCLIN sequencial no livro Comandos do SMP/E para z/OS para obter detalhes.

Após tomar ações que são indicadas pelo ACCEPT CHECK, remova o operando CHECK e execute a tarefa novamente para executar o ACCEPT.

Observação: o operando GROUPEXTEND indica que o SMP/E para z/OS aceita todos os SYSMODs de requisito. As SYSMODS requisitadas podem ser aplicáveis a outras funções.

Códigos de retorno e mensagens esperados de ACCEPT CHECK: você receberá um código de retorno 0 se essa tarefa for executada corretamente.

Se PTFs contendo módulos de substituição forem aceitas, o processamento do SMP/E ACCEPT irá linkeditar ou ligar os módulos nas bibliotecas de distribuição. Durante este processamento, o Editor de ligação ou componente de ligação pode emitir mensagens indicando referências externas não resolvidas, que irão resultar em um código de retorno 4 durante a fase de ACCEPT. É possível ignorar estas mensagens, porque as bibliotecas de distribuição não são executáveis e as referências externas não resolvidas não afetam as bibliotecas do sistema executáveis.

Códigos de retorno e mensagens esperados de ACCEPT: você receberá um código de retorno 0 se essa tarefa for executada corretamente.

Executar REPORT CROSSZONE

O comando SMP/E REPORT CROSSZONE identifica requisitos para produtos que estão instalados em zonas separadas. Este comando também cria os comandos APPLY e ACCEPT no conjunto de dados SMPPUNCH. É possível usar os comandos APPLY e ACCEPT para instalar estes requisitos entre zonas que o comando SMP/E REPORT CROSSZONE identifica.

Após instalar oz/OS Debugger, é recomendável que você execute REPORT CROSSZONE em relação as zonas de destino e distribuição novas ou atualizadas. O REPORT CROSSZONE requer uma zona global com entradas ZONEINDEX que descrevem todas as bibliotecas de destino e distribuição a serem relatadas.

Para obter mais informações sobre o REPORT CROSSZONE, consulte os manuais do SMP/E para z/OS.

Limpando conjuntos de dados, caminhos e DDDEFs obsoletos

Os conjuntos de dados de download da Web listados na Tabela 20 (seção "Requisitos de armazenamento do DASD" ) são conjuntos de dados temporários. É possível excluir esses conjuntos de dados depois de concluir a instalação do SMP/E.

Os conjuntos de dados a seguir, que foram alocados e utilizados por liberações anteriores deste produto, não são mais utilizados nesta liberação. É possível excluir esses conjuntos de dados obsoletos depois de excluir a liberação anterior do seu sistema.

• AEQABIN: obsoleto desde a Debug Tool 13.1.

• SEQABIN: obsoleto desde a Debug Tool 13.1.

• O LPALIB não é mais exigido desde a Debug Tool 4.1. No entanto, se você instalar o z/OS Debugger em uma zona que atualmente contém uma liberação antiga que possui um LPALIB, certifique-se de sair do LPALIB antigo alocado para que o SMP/E possa executar a limpeza de maneira adequada. Após concluir a instalação do z/OS Debugger 17.0.0, não exclua esse conjunto de dados, pois ele pode conter módulos de outros produtos.

• O SEQALPA, que era obsoleto desde a Debug Tool 1.3, agora é necessário desde a Debug Tool 4.1.

• AEQAMLIB, AEQAPLIB, AEQASLIB: obsoleto desde a Debug Tool 3.1.

• SEQAMLIB, SEQAPLIB, SEQASLIB: obsoleto desde a Debug Tool 3.1.

• SEQACLIS, SEQADUM, SEQAIENU, SEQALPA, SEQAOS2, SEQAPROC, SEQA2ENU: obsoleto desde a Debug Tool 1.3.

• AEQACLIS, AEQAIENU, AEQAMOD2, AEQAOS2, AEQASRC2, AEQA2ENU: obsoleto desde a Debug Tool 1.3.

As seguintes entradas DDDEF, que foram criadas e utilizadas pelas liberações anteriores deste produto, não são mais usadas nesta liberação. É possível excluir essas entradas DDDEF obsoletas após excluir a liberação anterior do seu sistema.

• AEQABIN: obsoleto desde a Debug Tool 13.1.

• SEQABIN: obsoleto desde a Debug Tool 13.1.

• O LPALIB não é mais exigido desde a Debug Tool 4.1. No entanto, se você instalar o z/OS Debugger em uma zona que atualmente contém uma liberação antiga que possui um LPALIB, certifique-se de sair do LPALIB antigo alocado para que o SMP/E possa executar a limpeza de maneira adequada. Após concluir a instalação do z/OS Debugger 17.0.0, não exclua esse conjunto de dados, pois ele pode conter módulos de outros produtos.

• O SEQALPA, que era obsoleto desde a Debug Tool 1.3, agora é necessário desde a Debug Tool 4.1.

• AEQAMLIB, AEQAPLIB, AEQASLIB: obsoleto desde a Debug Tool 3.1.

• SEQAMLIB, SEQAPLIB, SEQASLIB: obsoleto desde a Debug Tool 3.1.

• SEQACLIS, SEQADUM, SEQAIENU, SEQALPA, SEQAOS2, SEQAPROC, SEQA2ENU: obsoleto desde a Debug Tool 1.3.

• AEQACLIS, AEQAIENU, AEQAMOD2, AEQAOS2, AEQASRC2, AEQA2ENU: obsoleto desde a Debug Tool 1.3.

Customização do produto

A publicação IBM z/OS Debugger Customization Guide contém as informações necessárias para personalizar e usar o z/OS Debugger.

A publicação IBM z/OS Debugger User's Guide contém informações sobre possíveis alterações de compilação e edição de links que talvez seja necessário fazer nos processos de compilação para depurar os programas com o z/OS Debugger.

É necessário um cliente de estação de trabalho para alguns dos produtos que incluem o z/OS Debugger. Caso contrário, o cliente da estação de trabalho é opcional. O cliente faz parte do produto que você adquiriu. Uma versão de avaliação do cliente pode ser transferida por download a partir da página de download do Mainframe DEV, https://developer.ibm.com/mainframe/products/downloads/.

• IBM Developer for z/OS Enterprise Edition 17.0.0, número do programa 5755-AB5, o cliente é opcional
• IBM Developer for z/OS 17.0.0, número do programa 5724-T07, o cliente é necessário
• IBM Debug for z/OS 17.0.0, número do programa 5755-AB6, o cliente é opcional

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. A IBM pode não oferecer os produtos, serviços ou recursos discutidos neste documento em outros países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM poderá ser usado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não IBM são de responsabilidade do Cliente.

Números de APAR são fornecidos neste documento para ajudar a localizar PTFs que podem ser necessários. O relatório de problemas vigentes pode resultar na criação de APARs adicionais. Portanto, as listas de APAR neste documento podem não estar completas. Para obter as recomendações de serviço atuais e identificar os requisitos de serviço atuais do produto, consulte sempre as instruções nas seções Resumo das recomendações de serviço e Recomendações de serviço e Dependências entre produtos das informações de balde do PSP para produtos IBM Z em https://www.ibm.com/support/pages/node/7127792, para garantir que você tenha todo o serviço necessário.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. É possível enviar consultas sobre licenças, por escito, para a

Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

Marcas comerciais

IBM, o logotipo IBM e outra marca IBM registrada na IBM Trademarks List são marcas comerciais ou marcas registradas da International Business Machines Corporation, nos Estados Unidos e / ou em outros países. Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou outras empresas. Uma lista atual de marcas registradas da IBM está disponível em ibm.com/trademark.

Comentários do leitor

Diretório de programas para IBM z/OS Debugger, outubro de 2024

Agradecemos sua contribuição nesta publicação. Fique à vontade para comentar sobre a clareza, a precisão e a integridade das informações ou fornecer algum outro feedback que você possa ter.

Envie seus comentários por e-mail para ibmdocs@us.ibm.com e inclua as seguintes informações:

1. Seu nome e endereço

2. Seu Endereço de email

3. Seu número de telefone ou fax

4. O título da publicação e o número do pedido

5. O tópico e o número da página relacionados ao seu comentário

6. O texto do seu comentário

Ao enviar informações, o Cliente concede à IBM um direito não exclusivo de usá-las e distribuí-las da maneira que achar conveniente, sem que isso implique qualquer compromisso com o Cliente.

A IBM ou qualquer outra organização somente usará as informações pessoais que você fornecer para entrar em contato com você sobre os problemas que você enviar.

Obrigado pela participação.