Instalando e atualizando o produto R4Z no z/OS

Esta seção explica como instalar e atualizar o produto R4Z no z/OS.

Instalando o produto R4Z no z/OS

As etapas de configuração abaixo incluem o envio de trabalhos encontrados na biblioteca INSTALL (conhecida como <r4z-vnd-hlq>.INSTALL em Bibliotecas de produtos do R4Z). Cada trabalho exige a biblioteca INSTALL (ou sua cópia) como JCLLIB e deve ter um cartão de trabalho e instruções de controle JES que estejam em conformidade com os regulamentos do site.

Aplicando a instalação no ambiente de processamento

Durante o processo de instalação, você deve enviar a maioria dos membros com o prefixo "DO*" na biblioteca. Antes de enviar esses membros, você precisa editá-los da seguinte maneira:

1. Defina o nome do trabalho, os parâmetros do cartão de trabalho e as instruções de controle do JES para atender aos requisitos do sistema.
2. Defina a biblioteca especificada no parâmetro JCLLIB ORDER como a biblioteca INSTALL.

Etapa 1: Configurando os membros INCLUDE da biblioteca INSTALL

Você precisa definir os símbolos JCL abaixo antes de executar qualquer trabalho, pois os trabalhos "DO" usam esses símbolos JCL para configurar o processamento do R4Z. Para alterar seus valores, você precisará primeiro executar o trabalho "UNDO" com o valor antigo e depois o trabalho "DO" com o novo valor.

Edite esse membro para definir os símbolos JCL a serem usados pelos trabalhos nessa biblioteca e, em seguida, salve (substitua) o membro. Esses símbolos estão listados na tabela Símbolos de instalação abaixo.

Aqui está uma explicação mais detalhada de vários parâmetros:

• Parâmetros que especificam os nomes da biblioteca de produtos R4Z:
  &R4ZHLVL - Defina o qualificador de alto nível que é comum às bibliotecas R4Z INSTALL, LOAD e CONFIG, ou seja, a parte comum mais longa desses nomes de bibliotecas:
  • &R4ZVNDH - Defina o valor que você usou como qualificador de alto nível "versionado" (<r4z_vnd_HLQ>) ao receber as bibliotecas INSTALL e LOAD.
  • &R4ZBSCH - Defina o valor que você escolheu para o qualificador de alto nível “básico” (<r4z_bsc_HLQ>), que será usado ao criar a biblioteca CONFIG.
  • &R4ZINSTL, &R4ZLOADL, &R4ZCNFGL - Especifique-os somente se seu valor for diferente daquele definido no membro DFSYMLST, com base nos símbolos descritos acima.
• Parâmetros que controlam a alocação do DASD:

  • ALCSMSPM, &ALCVLSER - Use esses parâmetros para designar os volumes nos quais a biblioteca CONFIG e alguns conjuntos de dados intermediários serão alocados.

    Use &ALCSMSPM para especificar atributos de alocação de SMS em uma sequência de caracteres delimitada por vírgulas e terminada por espaço, no seguinte formato:

    '[STORCLAS=…][,MGMTCLAS=…][,DATACLAS=…] '

    Use &ALCVLSER para especificar o serial de volume.

    Se a alocação gerenciada por SMS for conduzida por rotinas ACS, você poderá omitir todos os atributos e especificar &ALCSMSPM=' '(um único espaço).

    Se você especificar &ALCSMSPM=' '(um único espaço), deverá especificar um valor para o parâmetro &ALCVLSER.

    Para alocações não gerenciadas por SMS, use &ALCVLSER para especificar o serial do volume.

• Serviço do CDC e variáveis relacionadas ao UDF:

  DFSYMPER	Defina nomes para o UDF, o ambiente de aplicativo WLM e o procedimento STC, com base no qualificador de serviço do CDC	Por instalação do R4Z
  Usos: &CDCSRV Conjuntos: &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER
  DFSYMONE	Defina nomes para o UDF, o ambiente de aplicativo WLM e o procedimento STC, supondo que um único serviço CDC seja usado	Por subsistema DB2
  Conjuntos: &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER

Dependendo do valor selecionado para DEFWLMAE, ONE ou PER, edite o membro DFSYMONE ou DFSYMPER respectivamente e selecione valores para o WLM APPLENV, o procedimento JCL WLM para a UDTF do leitor de CDC.

Etapa 2: Executando ações de configuração

1. Defina a biblioteca LOAD do R4Z como autorizada pelo APF.

   Para definir uma biblioteca como autorizada pelo APF temporariamente (até a próxima atualização do IPL ou do APF), você pode executar um dos seguintes comandos do sistema:

   • Para conjuntos de dados não gerenciados por SMS:

     setprog apf,add,dsn=<xmit-HLQ>.LOAD,volume=<volser>

   • Para conjuntos de dados gerenciados por SMS:

     setprog apf,add,dsn=(<xmit-HLQ>.LOAD,sms

     Para tornar a configuração permanente, adicione a biblioteca ao seu membro ProgXX em PARMLIB.

2. Configure um ambiente de aplicativo WLM para executar o processo de CDC.|
   

   DO2WLMAE	Definir o ambiente de aplicativo WLM	Por serviço do CDC
   Aceita: &CDCSRV Usos: &R4ZAPPNV, &R4ZWLMPR, &CEERUNL, &DB2EXITL, &DB2LOADL, &DB2RUNL
   DO2WLMPR	Criar procedimento JCL para WLM STC	por procedimento WLM
   Aceita: &CDCSRV Usos: &PROCLIB, &R4ZWLMPR, &SSID
   DO2WLMPV	Trabalho: ao definir o servidor WLM como um recurso no RACF e autorizar o subsistema APPLENV e DB2 a usá-lo	por serviço CDC e procedimento WLM
   Aceita: &CDCSRV Usos: &R4ZAPPNV, &R4ZWLMPR, &STCUSER

   
   Dependendo do valor definido para DEFALMAE, execute os seguintes trabalhos, uma vez (se ONE for selecionado) ou por cada serviço de CDC a ser definido (se PER for selecionado), depois de definir o símbolo JCL CDCSRV com o qualificador de serviço de CDC relevante.

   1. Edite o trabalho DO2WLMAE, defina o símbolo &CDCSRV como o qualificador de serviço de CDC relevante e envie. O trabalho definirá o APPLENV WLM no conjunto de dados da política WLM e o ativará.

      • Pré-requisitos:

        • &R4ZWLMPR é o nome da tarefa iniciada que o WLM usará. Você precisa associar um usuário válido à tarefa iniciada e definir &STCUSER como esse usuário.

        • O remetente precisa de acesso UPDATE a MVSADMIN.WLM.POLICY para consultar e atualizar a política WLM.

        • UPDATE na biblioteca de procedimentos especificada em DSSYMLST no símbolo &PROCLIB.

   2. Edite o trabalho DO2WLMPR; defina o símbolo &CDCSRV como o qualificador de serviço relevante do CDC e envie. O trabalho criará um procedimento JCL para o APPLENV e deverá ser encerrado com RC 0.

      • Autorizações:

        UPDATE na biblioteca PROCLIB.

   3. Edite o trabalho DO2WLMPV; defina o símbolo &CDCSRV como o qualificador de serviço relevante do CDC e envie. O trabalho definirá privilégios RACF para o APPLENV usar o servidor WLM e para o subsistema DB2 chamá-lo. O trabalho deve ser encerrado com RC 0.

      • Autorizações:

        ALTER na classe SERVER

        Se você estiver usando um pacote de segurança diferente do RACF (por exemplo, como CA-TSS ou CA-ACF2), precisará executar os comandos relevantes ao seu pacote de segurança.

3. Crie a(s) UDTF(s) do leitor de CDC.
   

   DO3SRVDF	Crie a UDTF do serviço de CDC padrão	Por subsistema DB2
   Usos: &R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER
   DO3SRVTF	Crie uma UDTF a ser usada por um serviço específico de CDC	Por serviço de CDC e subsistema DB2
   Aceita: &CDCSRV Usos: &R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER

   O primeiro trabalho cria a UDTF do serviço padrão com o nome específico &R4ZIFITF (sob o nome do esquema &R4ZSCNM) e concede execução nele a &UDFUSER. Ele também instancia um serviço de CDC "fornecido", CDC1 (criando essa biblioteca CONFIG membro), definindo-o com as configurações padrão. Esse trabalho deve ser executado primeiro.

   O segundo trabalho, que é executado de acordo com cada serviço de CDC definido explicitamente, é executado exatamente como o primeiro trabalho, com a diferença de que cada UDF está associado a um serviço CDC específico, que é instanciado a partir do serviço CDC1.

   1. Execute o trabalho DO3SRVDF. Isso fará o seguinte:

      • Criará uma UDTF com um nome sem sufixo, que será associado ao serviço CDC padrão (CDC1).
      • Criará a biblioteca CONFIG e colocará um membro chamado CDCS, a ser usado quando não houver nenhum membro relacionado ao serviço do CDC.

      Os trabalhos devem terminar com RC4.

   2. Para cada serviço de CDC que você deseja definir, edite o trabalho DO3SRVTF; defina o símbolo &CDCSRV como o qualificador relevante do Serviço de CDC e envie. Isso fará o seguinte:

      • Crie uma UDTF com seu nome sufixado "__&CDCSRV", que será associado ao serviço de CDC padrão ""&CDCSRV".
      • Crie um membro chamado "&CDCSRV" na biblioteca CONFIG.
      • Defina o símbolo CDCSRV JCL com o qualificador de serviço relevante de CDC (xxxx) e envie o trabalho.

      Os trabalhos devem terminar com RC4.

      • Autorizações:

        O usuário que está enviando deve ter uma das seguintes autorizações:

        • Autoridade SYSADM ou SYSCTRL.
        • Autorização CREATEIN no esquema designado por &R4ZSCNM.

4. Habilite o ID de usuário especificado para executar tarefas de CDC.

   DO4GRANT	Conceda ao usuário do ODBC acesso às tabelas do catálogo e permissão para ler a CDC	Por subsistema DB2
   Usos: &R4ZUSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNLR

   Esse trabalho habilita o ID de usuário selecionado para interação com o ODBC. Esse é o "usuário ODBC", que está autorizado (em termos de DB2) a ler dados do CDC e algumas das tabelas do catálogo do DB2.

   Nota informativa

   Não adianta enviar o trabalho do próprio usuário do ODBC (já que um usuário não pode conceder privilégios a si mesmo) ou de um usuário que não possui os privilégios que ele tenta conceder.

   Execute o trabalho DO4GRANT. Isso fará o seguinte:

   • GRANT SELECT para o usuário ODBC nas seguintes tabelas:

     • SYSIBM.SYSTABLES
     • SYSIBM.SYSTABLESPACE
     • SYSIBM.SYSCOLUMNS
     • SYSIBM.SYSROUTINES
     • SYSIBM.SYSDUMMY1
     • ALTER SYSIBM.SYSTABLES habilitando DATA CAPTURE.

   Os trabalhos devem terminar com RC 0 ou RC 4.

   Autorizações:

   O usuário que está enviando deve ter uma das seguintes autorizações:

   • Autoridade SYSADM ou SYSCTRL.
   • TRACE/MONITOR2 com opção de concessão.
5. Forneça permissões de segurança para que a tarefa iniciada pelo WLM se cancele sozinha. No RACF, isso é feito da seguinte maneira:

1. Defina um PROFILE para a classe OPERCMDS chamada PERMIT MVS.CANCEL.STC.mbrname.*:

   RDEFINE OPERCMDS MVS.CANCEL.STC.mbrname.* UACC(NONE) SETROPTS REFRESH RACLIST(OPERCMDS)

   Em que mbrname é o nome da tarefa iniciada.

2. Conceda ao USERID atribuído à TASK iniciada pelo WLM a autoridade para cancelar a tarefa iniciada:

   PERMIT MVS.CANCEL.STC.mbrname.* CL(OPERCMDS) ACCESS(UPDATE) ID(stcuser)

   Em que stcuser é o USERID associado à tarefa iniciada pelo WLM.

6. Considerações de desempenho:

   1. Carregamento total – Os processos de carregamento total utilizarão qualquer processador ZIIP disponível. A prática recomendada é definir a meta de desempenho para que os processos sejam classificados como cargas de trabalho inferiores a online. Em um sistema muito ocupado, talvez você queira considerar definir Respeitar Prioridade para NO para a classe de serviço atribuída ao Carregamento total. Isso requer o z/OS 2.1 + OA50845 ou z/OS 2.2 e superior.

   2. CDC – A prática recomendada é definir a meta de desempenho para os processos de CDC igual a qualquer carga de trabalho online e superior à meta de carregamento total. Esses processos podem ser classificados usando qualquer um dos seguintes:

      - O nome da tarefa iniciada pelo ambiente do aplicativo WLM

      - A classificação DDF com "Nome do Procedimento"

Migrando o produto R4Z no z/OS

Se você quiser atualizar sua instalação do R4Z e substituir a instalação atual, ou se quiser atualizar sua instalação do R4Z sem substituir a versão atualmente instalada, você precisará executar as etapas relevantes descritas abaixo.

Para atualizar sua instalação do R4Z e substituir a versão atualmente instalada, suspenda todos os serviços de CDC usando o R4Z da seguinte forma:

1. Use o seguinte comando do operador para desativar o ambiente de aplicativos WLM e impedir que os clientes ativem automaticamente o serviço CDC antes que ele esteja pronto:

   VARY WLM,APPLENV=<applic.env-name>,Q

   Repita isso para todos os ambientes de aplicativos usando os procedimentos de JCL que especificam a biblioteca LOAD da versão que está sendo substituída. Se o host for um Parallel Sysplex, preceda o comando com ROUT *ALL, roteando-o para todos os sistemas no Plex.

2. Use o verbo R4ZUTIL TERMINATE para liberar todos os recursos do sistema usados atualmente pelo serviço de CDC.

   Repita isso em todos os LPARs em que ele possa estar em execução (se o DB2 de origem tiver membros de compartilhamento de dados nesses sistemas).