DEPLOY

A ação DEPLOY implementa um ambiente de tempo de execução empacotado em um sistema remoto.

Antes de Começar

Analise as informações a seguir antes de usar a ação ' DEPLOY:
  • Você pode executar a ação DEPLOY somente depois de ter empacotado com êxito um ambiente de tempo de execução usando a ação PACKAGE ação.
  • A ação ' DEPLOY usa comandos DFSMSdss z/OS. Talvez você precise de autoridade para executar o ' ADRDSSU, que é o programa chamado ao usar o DFSMSdss. Se a autorização for necessária, o DFSMSdss emitirá uma mensagem de erro ADR707E. Para obter mais informações, consulte z/OS Guia de Administração de Armazenamento DFSMSdss : Proteção das funções do DFSMSdss com perfis de classe RACF FACILITY.
  • Se você não tiver nenhuma biblioteca de destino SMP/E no sistema em que deseja executar uma ação DEPLOY , poderá usar o utilitário TKANSAM(KFJMAINT) com a ação BLDREMDS para criar os conjuntos de dados mínimos necessários (bibliotecasTKANSAM, TKANMOD e TKANCUS ) para executar a ação. Certifique-se de transferir os conjuntos de dados criados para o sistema remoto onde o " DEPLOY deve ser executado e onde a autorização APF necessária da biblioteca " TKANMOD é feita. Essas bibliotecas de destino SMP/E são o mínimo necessário para permitir que o Configuration Manager seja executado em um ambiente de tempo de execução completo. No entanto, para um ambiente de tempo de execução compartilhado com SMP/E, será necessário copiar todo o conjunto de bibliotecas de destino de SMP/E para o sistema em que você executa a ação DEPLOY .
Importante: Quando você usar a ação " DEPLOY, os conjuntos de dados do ambiente de tempo de execução de destino serão atualizados. Verifique se esses conjuntos de dados não estão em uso antes de usar a ação ' DEPLOY.
Importante: OPACKAGE ação cria um arquivo de metadados chamadopackage_hlq.rte_name.PACKMD . A ação DEPLOY requer o arquivo de metadados PACKMD se um conjunto de dados for renomeado, o que pode ocorrer se os parâmetros KFJ_LOCAL_* (no membro KCIVARS DD e no PCK$PARM ) forem usados ao criar o pacote. Se o arquivo PACKMD não estiver disponível, a ação DEPLOY restaurará os pacotes como estão, mantendo todos os qualificadores de alto nível e propriedades de SMS, e você poderá ter resultados imprevisíveis na sua implementação. Recomenda-se que você use o arquivo de metadados PACKMD ao usar a ação DEPLOY .
Temas relacionados

Sobre essa tarefa

A lista a seguir fornece detalhes sobre a ação " DEPLOY:
  • A ação DEPLOY implanta um ambiente de tempo de execução restaurando conjuntos de dados de pacotes gerados pela ação PACKAGE em um sistema de destino. A ação DEPLOY usa o DFSMSdss para restaurar os conjuntos de dados.
  • A ação DEPLOY requer o uso do programa KCIALPHA . KCIALPHA é uma versão autorizada pelo APF do KCIOMEGA.
  • Você deve especificar valores de qualificador de alto nível que são usados para localizar conjuntos de dados existentes. Os parâmetros a seguir são usados para especificar qualificadores de alto nível:
    RTE_PLIB_HILEV
    (Obrigatório) Especifica os qualificadores de alto nível para localizar a biblioteca de definição de ambiente de tempo de execução (RTEDEF). Você deve especificar esse parâmetro e valor para a ação DEPLOY .
    KFJ_PACK_HILEV
    (Opcional) Especifica o valor do qualificador de alto nível para os conjuntos de dados do pacote. Se esse parâmetro não for especificado, será usado o valor do parâmetro RTE_PLIB_HILEV .
    Importante: você deve usar o parâmetro KFJ_PACK_HILEV com a ação DEPLOY se tiver transferido os conjuntos de dados do pacote com um qualificador de alto nível diferente de RTE_PLIB_HILEV.
    Observação: recomenda-se que você especifique o parâmetro KFJ_PACK_HILEV ao implantar o ambiente de tempo de execução.
    Observação: O parâmetro KFJ_LOCAL_PLIB_HILEV não é compatível com a ação DEPLOY .
  • Opcionalmente, é possível controlar quando executar o estágio do fluxo de trabalho do DEPLOY que implementa as partes relacionadas ao z/OS® UNIX System Services Por padrão, a ação DEPLOY implementa automaticamente os arquivos e diretórios relacionados a z/OS UNIX se eles estiverem presentes nos conjuntos de dados do ambiente de tempo de execução empacotado. No entanto, pode haver casos em que você queira pular essa etapa (por motivos como problemas de autorização) e executá-la posteriormente. É possível usar o parâmetro OPTION para especificar o valor NOUSS ou USS para controlar esse processamento, conforme a seguir:
    NOUSS

    Quando OPTION NOUSS é especificado, a ação DEPLOY não executa o estágio que implementa as partes relacionadas a z/OS UNIX.

    Com essa opção, somente os conjuntos de dados z/OS são implementados; os arquivos e diretórios relacionados a z/OS UNIX são ignorados.

    USS

    Quando OPTION USS é especificado, a ação DEPLOY executa somente o estágio que implementa as partes relacionadas a z/OS UNIX e nenhum outro processamento é realizado.

    Essa opção é útil quando você deseja atualizar arquivos e diretórios relacionados a z/OS UNIX somente.

  • A ação " DEPLOY executa uma restauração incondicional para os pacotes principais VSAM e não VSAM (substitui totalmente os conjuntos de dados) e uma restauração condicional para os pacotes de histórico (não substitui os conjuntos de dados existentes). Observe os comportamentos a seguir:
    • Se os conjuntos de dados de despejo de histórico (**.PACKHN ou **.PACKHV) não forem encontrados ou se houver falha na restauração, será gerado um código de retorno 4.
    • Se os principais conjuntos de dados de dump (**.PACKMN ou **.PACKMV) não forem localizados ou se a restauração deles falhar, será gerado um código de retorno 8.
    Observação: a ação DEPLOY substitui alguns arquivos VSAM e não VSAM do pacote principal, mas não substitui nenhum arquivo relacionado ao histórico. Portanto, é normal que os fluxos de implementação PACKHN e PACKHV terminem com RC=8. Se você deseja evitar isso, por exemplo, se você implementar a manutenção, não transfira esses pacotes para o sistema de destino. Embora normalmente um código de retorno de 8 faça com que o Configuration Manager pare, nesta situação específica (arquivos de histórico), um código de retorno de 8 é considerado aceitável e não impedirá que o Configuration Manager continue a funcionar
  • Ao restaurar (e possivelmente desinstalar) o ambiente de tempo de execução empacotado, a ação DEPLOY reutiliza os seguintes parâmetros que foram usados com a ação PACKAGE :
    • KFJ_PACK_HILEV
    • KFJ_ADRDSSU_ADMIN
    • KFJ_PACK_TERSE
    • KFJ_PACK_DATACLAS
    • KFJ_PACK_UNIT
    • KFJ_PACK_VOLUME
    Consulte PACKAGE para obter informações sobre esses parâmetros.
  • Se ' KFJ_PACK_TERSE for definido como ' Y, a ação ' DEPLOY primeiro desinstala o pacote. O qualificador de alto nível do arquivo DMP não inserido e os parâmetros SMS são usados conforme especificado nos parâmetros a seguir:
    • RTE_PLIB_HILEV
    • RTE_SMS_MGMTCLAS
    • RTE_SMS_STORCLAS
    • RTE_SMS_UNIT
    • RTE_SMS_VOLUME
  • Para que grandes pacotes sejam desempacotados, é necessário usar KFJ_PACK_DATACLAS adequadamente para permitir a alocação de conjunto de dados de vários volumes para os arquivos de pacotes extraídos.
  • Se KFJ_PACK_UNIT ou KFJ_PACK_VOLUME for especificado, ele se aplicará a todos os pacotes que estão sendo desempacotados.
  • Se RTE_SMS_VOLUME for especificado, mas RTE_SMS_MGMTCLAS não for, o padrão de RTE_SMS_MGMTCLAS será NULLMGMTCLAS. Da mesma forma, RTE_SMS_STORCLAS tem como padrão NULLSTORCLAS.

Para executar a ação " DEPLOY, conclua as etapas a seguir.

Procedimento

  1. Localize os conjuntos de dados de despejo (.DMP) e o arquivo de metadados (.PACKMD) que foram criados pela ação PACKAGE .
    A convenção de nomenclatura dos conjuntos de dados do pacote é package_hlq.rte_name.PACKMD, em que package_hlq é o valor do parâmetro KFJ_PACK_HILEV ou RTE_PLIB_HILEV.
    Observação: é possível que o valor do qualificador de alto nível tenha sido modificado durante a transferência dos conjuntos de dados do pacote para o sistema remoto.
  2. Modificar o job de amostra KFJJMCM em TKANSAM (veja exemplo abaixo) para selecionar uma ação DEPLOY .
  3. Altere o nome do programa na instrução JCL EXEC de KCIOMEGA para KCIALPHA.
  4. Especifique valores para os parâmetros necessários RTE_NAME e RTE_PLIB_HILEV.
  5. (Opcional) Especifique quaisquer parâmetros adicionais conforme necessário.
    Importante: você deve usar o parâmetro KFJ_PACK_HILEV se tiver transferido os conjuntos de dados do pacote para o sistema remoto com um qualificador de alto nível diferente do valor do parâmetro RTE_PLIB_HILEV .
  6. Executar a tarefa KFJJMCM para executar o processo de deploy e restaurar os arquivos de pacotes relacionados.
    Mensagens de tarefa para a ação DEPLOY são gravadas no conjunto de dados SYSOUT KCIPRINT e no DD $REPORT . Se o código de retorno 4 ou 8 for recebido, revise a instrução DD $REPORT na saída da tarefa JCL para assegurar que o processo de restauração tenha sido concluído com êxito Para obter mais informações, consulte Saída da ação DEPLOY.

Exemplo

Os exemplos a seguir restauram (implementam ) os conjuntos de dados de um ambiente de tempo de execução que foi empacotado pela ação PACKAGE .
Uso do qualificador padrão de alto nível com o parâmetro RTE_PLIB_HILEV

Neste exemplo, os conjuntos de dados do pacote foram nomeados usando o qualificador padrão de alto nível da biblioteca de definição de tempo de execução e foram transferidos para o sistema remoto usando os mesmos nomes de arquivo.

Os conjuntos de dados empacotados contêm o ambiente de tempo de execução denominado RTE1 e a biblioteca de definição do ambiente de tempo de execução TSOUID.MONSUITE.RTEDEF.

Os conjuntos de dados empacotados são denominados TSOUID.MONSUITE.RTE1.PACK*.

O seguinte trabalho de ação DEPLOY , executado no sistema remoto, implementa (restaura) os conjuntos de dados do pacote na LPAR de destino para conjuntos de dados com o qualificador de alto nível TSOUID.MONSUITE.

Figura 1. Exemplo de JCL para executar a ação DEPLOY usando o qualificador padrão de alto nível
//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID 
/*JOBPARM SYSAFF=ZOS1 
//S1 EXEC PGM=KCIALPHA,REGION=0M,DYNAMNBR=256 
//STEPLIB DD DISP=SHR,DSN=MONSUITE.TKANMOD 
//KCIFLOW DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA) 
//KCIVARS DD * 
ACTION            DEPLOY 
RTE_NAME          RTE1 
RTE_PLIB_HILEV    TSOUID.MONSUITE 
/*
Uso de qualificador personalizado de alto nível com parâmetro KFJ_PACK_HILEV

Você deve usar o parâmetro KFJ_PACK_HILEV com a ação DEPLOY se tiver transferido os conjuntos de dados do pacote para o sistema remoto com um qualificador de alto nível que seja diferente do valor do parâmetro RTE_PLIB_HILEV .

Neste exemplo, os conjuntos de dados do pacote contêm o ambiente de tempo de execução denominado RTE1 e a biblioteca de definição do ambiente de tempo de execução TSOUID.MONSUITE.RTEDEF. No entanto, os arquivos foram transferidos para o sistema remoto usando o qualificador de alto nível TESTSYS.

Como resultado, os conjuntos de dados do pacote no sistema remoto são nomeados TESTSYS.MONSUITE.RTE1.PACK*, exigindo o uso do parâmetro KFJ_PACK_HILEV.

Figura 2 Exemplo de JCL para executar a ação DEPLOY usando o qualificador personalizado de alto nível
//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID 
/*JOBPARM SYSAFF=ZOS1 
//S1 EXEC PGM=KCIALPHA,REGION=0M,DYNAMNBR=256 
//STEPLIB DD DISP=SHR,DSN=MONSUITE.TKANMOD 
//KCIFLOW DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA) 
//KCIVARS DD * 
ACTION            DEPLOY 
RTE_NAME          RTE1 
RTE_PLIB_HILEV    TSOUID.MONSUITE
KFJ_PACK_HILEV    TESTSYS.MONSUITE
/*