Application Deployment Manager - Notas sobre o Release

Quem Deve Ler Estas Informações
Customização
   Configuração e Customização da Estação de Trabalho ADM
      Preferências de ADM
      Exportar/Importar Registro de Sistemas
      Definindo Regiões de Conexão Primária do CICS
      Fornecendo o Nome CICSPlex
   Customização do Servidor z/OS
      Modificando a Definição de ADM PIPELINE
      Segurança para os Serviços da Web da API do Cliente CRD
Editor de Definição de Recurso do CICS
   Ambientes Suportados
   Restrições de Idioma da Definição de Recurso do CICS
   Escopo da Implementação de Região do CICS
   Definições de Recurso do CICS Suportado pelo Editor CRD
   Ativando o Editor CICS Resource Definition
   Utilizando o Editor CRD
   Função do Editor CRD para o Programador de Sistemas
   Função do Editor CRD para o Desenvolvedor de Aplicativos

Quem Deve Ler Estas Informações

O ADM se destina aos desenvolvedores do Rational Developer para System z que implementam o Developer para System z ou os artefatos gerados no z/OS. Destina-se também aos desenvolvedores que determinarão as definições de recursos do CICS e aos programadores do sistema z/OS que utilizarão o Developer para System z para fornecer os padrões de definição de recursos do CICS.

Customização

A customização da estação de trabalho ADM e do servidor z/OS é tratada nesta seção.

Configuração e Customização da Estação de Trabalho ADM

A ADM tem dois níveis de configuração e customização da estação de trabalho. As preferências da ADM são valores de sistema, e as definições do sistema de destino determinam e fornecem informações de conexão para sistemas de destino. Esta seção descreve a customização necessária da estação de trabalho.

Preferências da ADM

Utilize a janela de preferências da ADM para fazer o seguinte:

Figura 1. Preferências da ADM
Ilustração para imagem009

Exportar/Importar Registro de Sistemas

O registro de sistemas atuais pode ser exportado para um arquivo externo ou um arquivo de registro de sistemas externos pode ser importado e mesclado com o registro de sistemas atual. Para exportar o registro de sistemas atuais:

  1. Clique em Arquivo>Exportar->Registro de Sistemas de Exportação ADM.
  2. Clique em Avançar.
  3. Selecione o caminho de arquivo que você deseja exportar.
  4. Clique em Concluir.

Figura 2. Janela Exportar
Ilustração para imagem010

O processo de importação de um registro externo no registro de sistemas atuais é semelhante. Clique em Arquivo->Importar->Registro de Sistemas de Importação ADM, escolha um arquivo de registro existente e clique em Concluir.

Definindo Regiões de Conexão Primária CICS

O cliente CRD ADM implementa uma conexão de serviço da Web com a região de conexão primária do CICS. As regiões de conexão primária do CICS devem ser configuradas utilizando o ADM. Primeiro, ative o editor de definições de recursos CICS clicando com o botão direito do mouse na pasta-raiz de um projeto de Fluxo de Serviço (consulte Ativando o Editor CICS Resource Definition para obter informações adicionais). A guia Sistemas/Regiões é utilizada para incluir ou editar regiões de conexão primária do CICS. Um erro do usuário é indicado por um "X" vermelho próximo ao campo apropriado juntamente com uma dica de ferramenta descrevendo o erro. As informações necessárias incluem:

Figura 3. Definindo Regiões de Conexão Primária CICS

Fornecendo o Nome CICSPlex

Para fornecer o nome CICSPlex, utilize a guia CICS Interativo e faça o seguinte:

  1. Selecione CICSPlex no menu suspenso Tipo de Recurso.
  2. Selecione Fornecer Nome CICSPlex no menu suspenso Ação.
  3. Digite o nome CICSPlex no campo ResourceName.

Customização do Servidor z/OS

O componente de host ADM é constituído pelo servidor CRD, pelas definições de recurso do CICS associadas, pelos arquivos de ligação do serviço da Web e por um manipulador de mensagens de pipeline de amostra. O diretório do programa Developer para System z contém instruções para instalação do componente de host ADM. No entanto, pode ser necessária alguma customização. Esta seção descreve essa customização.

Modificando a Definição ADM PIPELINE

O diretório de ligação do serviço da Web contém um arquivo de ligação de serviço da Web (WSBind) associado a um pipeline. O arquivo WSBind é instalado automaticamente pelo mecanismo de varredura do pipeline CICS.

No tempo de execução, o CICS utiliza informações no arquivo de ligação do serviço da Web para fornecer o mapeamento entre estruturas de dados do aplicativo e mensagens SOAP.

ADM fornece arquivos WSBind para cada um de seus serviços da Web. O processo de instalação, descrito no diretório do programa Developer para System z, instala esses arquivos WSBind fornecidos no HFS de serviços do sistema UNIX em um diretório de ligação de serviço da Web (também conhecido como o diretório de recebimento).

Se os caminhos de diretório especificados na definição de pipeline ADM fornecida não estiverem de acordo com as convenções de nomenclatura das lojas, você deverá utilizar a transação CEDA CICS para modificar a definição de PIPELINE fornecida. Essa definição contém o atributo WSDIR, que especifica o nome do diretório de seleção dos Serviços da Web contendo os arquivos WSBind ADM. A figura a seguir contém uma definição de PIPELINE de amostra.

Pipeline       : ADMPIPE1                                       
Grupo          : ADMGROUP                                       
Descrição    :                                                
Status         : Ativado            Desativado | Desativado          
Arquivo de Configuração     : /u/adm/pipeline/wssecurityprovider.xml
(Caso Misto)   :                                                
               :                                                
               :                                                
               :                                                
Shelf          : /u/adm/wsshelf                          
(Caso Misto)   :                                                
               :                                                
               :                                                
               :                                                
Wsdir          : /u/adm/wspickup                         

Segurança Serviços da Web da API do Cliente CRD

Alguns, ou todos esses pedidos, devem ser protegidos. No mínimo, os comandos da API do cliente CRD de atualização (parâmetros do serviço da Web padrão de atualização, parâmetros do descritor padrão e o nome do arquivo para a ligação do nome do conjunto de dados) devem ser protegidos para impedir que todos, exceto os programadores de sistemas do CICS, emitam esses comandos utilizados para definir padrões de recurso global.

O arquivo de repositório do servidor CRD deve ser instalado com segurança no nível do recurso que necessite de autoridade de atualização. Um gerenciador de segurança externa (por exemplo, RACF) deve ser utilizado para definir os IDs de usuário do CICS que tenham o nível correto de autorização de atualização.

Quando a mensagem SOAP é recebida pelo CICS, ela é processada por um pipeline. Um pipeline é um conjunto de manipuladores de mensagens que são executados em seqüência. O CICS lê o arquivo de configuração do pipeline para determinar quais manipuladores de mensagens devem ser chamados no pipeline.

Um manipulador de mensagem é um programa no qual você pode executar processamento especial de pedidos e respostas de serviço da Web.

O ADM fornece um arquivo de configuração do pipeline de amostra que especifica a chamada de um manipulador de mensagem e um programa de processamento de cabeçalhos SOAP.

CPIH é o ID da transação padrão que um aplicativo chamado por um pipeline executará. Geralmente, o CPIH é configurado para um nível mínimo de autorização. ADNSMSGH é um manipulador de mensagem de amostra utilizado para definir um novo ID de transação do CICS, conforme a seguir:

Quando a transação é anexada, a verificação de segurança do recurso do CICS assegura que o ID do usuário tem autorização para executar o ID da transação.

A verificação de recurso é controlada pela opção RESSEC na transação que está executando o parâmetro de inicialização do sistema RESSEC e, para o servidor do CRD, o parâmetro de inicialização do sistema XPCT.

A verificação de recurso ocorre somente se o parâmetro de inicialização do sistema XPCT tiver um valor diferente de NO e a opção RESSEC na definição de TRANSACTION for YES ou se o parâmetro de inicialização do sistema RESSEC for ALWAYS.

ADNSMSGH pode ser modificado e deve ser compilado pelo cliente. A tarefa de compilação deve nomear o módulo ADNTMSGH na etapa de edição de link.

Além disso, a definição de TCPIPSERVICE pode especificar opcionalmente uma conexão HTTPS para fornecer criptografia para a mensagem SOAP inteira.

Editor CICS Resource Definition

O editor CICS Resource Definition do Developer para System z oferece suporte para a definição de recursos do CICS. É um componente do Developer para System z e um consumidor dos serviços de implementação do ADM para implementação de recursos definidos do CICS.

Tradicionalmente, a função de definição de recursos para o CICS é o domínio do programador de sistemas do CICS. Há uma relutância em permitir que o desenvolvedor de aplicativos defina recursos do CICS pelos seguintes motivos:

O editor CRD do Developer para System z trata esses problemas, permitindo que os programadores de sistema do CICS controlem padrões de definição de recurso do CICS e propriedades de exibição de um parâmetro de definição de recurso do CICS. Por exemplo, o programador de sistemas CICS pode fornecer determinados parâmetros da definição de recurso do CICS que podem não ser atualizados pelo desenvolvedor de aplicativos. Outros parâmetros de definição de recurso do CICS podem ser atualizáveis, com ou sem padrões fornecidos, ou o parâmetro de definição de recurso do CICS pode ser ocultado para evitar complexidade desnecessária.

Ambientes Suportados

O editor CRD suporta a definição de recursos do CICS em sistemas CICS TS 3.1, com ou sem o CPSM.

Quando o CPSM não está instalado, o servidor CRD utiliza o comando CICS CREATE SPI para definir e instalar (e ativar) recursos do CICS. Nesse caso, o CSD não é atualizado. Conseqüentemente, o CEDA não pode ser utilizado para visualizar as definições de recurso. No entanto, CEMT INQUIRE pode ser utilizado, embora não exiba todos os parâmetros de definição.

Quando o CPSM está instalado, a interface de BAS (Business Application Services) do CPSM é utilizada para definir e instalar recursos do CICS. Nesse caso, o CSD não é atualizado. Conseqüentemente, o CEDA não pode ser utilizado para visualizar as definições de recurso. No entanto, tanto a interface CEMT INQUIRE quanto a CPSM BAS podem ser utilizadas para visualizar recursos do CICS. A interface CPSM BAS listará todos os parâmetros de definição.

Restrições de Idioma da Definição de Recursos CICS

Geralmente, os nomes de recurso do CICS e outros atributos de recurso alfanuméricos são limitados aos caracteres comuns em todas as variantes do EBCDIC. Isso não inclui caracteres bidirecionais ou DBCS. Consulte o CICS TS Resource Definition Guide (SC34-6430) para obter informações precisas sobre os caracteres válidos para cada tipo de recurso e atributo.

Escopo de Implementação da Região CICS

O ADM do Developer para System z utiliza um serviço da Web para se conectar a uma região CICS TS 3.1 que executa o servidor CRD. Os recursos do CICS podem ser instalados na região de servidor CRD e em outras regiões de acordo com os seguintes cenários.

Definições de Recursos CICS Suportadas pelo Editor CRD

As seguintes definições de recurso do CICS são suportadas pelo editor CRD:

Ativando o Editor CICS Resource Definition

Execute as etapas a seguir para ativar o editor CICS Resource Definition. Se você já possuir um Projeto de Fluxo de Serviço, pule para a etapa 4.

  1. Abra a perspectiva Enterprise Service Tools.
  2. Clique no ícone Menu do Enterprise Service Tools e selecione Projeto de Fluxo de Serviço.
  3. No assistente Novo Projeto de Fluxo de Serviço, faça o seguinte:
  4. Clique com o botão direito do mouse na pasta-raiz do projeto e selecione Definição de Recurso CICS.

Utilizando o Editor CRD

A função do editor CRD é implementada como um componente do Developer para System z. Ela tem aplicabilidade tanto para a função de desenvolvedor de aplicativos quanto para a função de programador de sistemas.

O programador de sistemas utiliza o editor CRD para fornecer padrões de parâmetro baseados no z/OS para todas as definições de recurso do CICS suportadas pelo editor CRD, propriedades de exibição do parâmetro de definição de recurso do CICS, fornecer informações de ligação para arquivos VSAM e, quando o CPSM está instalado, para fornecer o nome CICSPlex.

O desenvolvedor de aplicativos utiliza o editor CRD para recuperar definições de recurso existentes (que podem ser utilizadas como modelos), com uma lista de IDs da região CICS (SYSID) disponíveis para implementação e para definir e implementar definições de recurso do CICS.

A Figura 4 mostra o editor CRD que está sendo utilizado para recuperar uma definição de programa existente.

Figura 4. Editor CICS Resource Definition

Função do Editor CRD para o Programador do Sistema

O editor CRD implementa as seguintes funções destinadas para uso pelo programador de sistemas do CICS:

Recuperar/Atualizar Padrões de Definição de Recursos CICS
O usuário seleciona um tipo de recurso específico do CICS. Os parâmetros padrão para esse tipo de recurso são recuperados do z/OS pelo servidor CRD. Para o fornecimento inicial de um tipo específico de recurso, o servidor CRD fornece padrões de parâmetro de recurso sugeridos.

O recurso é exibido como ele geralmente aparece ao criar uma nova definição de recurso desse tipo. As entradas dos campos de parâmetro são utilizadas para atualizar padrões do arquivo de repositório do servidor CRD no z/OS. Esses padrões são, então, utilizados para criação subseqüente de definições de recurso do mesmo tipo.

Além disso, as propriedades de exibição podem ser configuradas para a maioria dos parâmetros de recurso. As propriedades de exibição válidas são atualizável, protegido e oculto.

Cada tipo de recurso suportado terá uma configuração para indicar se o tipo de recurso pode ser definido utilizando o editor CRD.

Recuperar/Atualizar Ligação Lógica para Física do Arquivo VSAM do CICS
Um nome de arquivo lógico VSAM é fornecido pelo usuário. Se a ligação tiver sido fornecida anteriormente, o nome do conjunto de dados físico será exibido.

O nome do conjunto de dados físico pode, então, ser fornecido ou atualizado inicialmente.

As informações sobre ligação lógica para física são armazenadas no repositório do servidor CRD no z/OS.

A ligação do arquivo VSAM de lógica para física é, então, utiliza para uma criação subseqüente de uma definição de arquivo VSAM utilizando o nome do arquivo lógico.

Função do Editor CRD para o Desenvolvedor de Aplicativos

O editor CRD implementa as seguintes funções destinadas para uso pelo desenvolvedor de aplicativos do CICS:

Recuperar/Criar Definição de Recursos CICS
O usuário seleciona um tipo de recurso específico do CICS. Os parâmetros padrão para esse tipo de recurso são recuperados do z/OS pelo servidor CRD. Se os parâmetros padrão para esse tipo de recurso não forem localizados no repositório do servidor CRD, o servidor CRD fornecerá os padrões de parâmetro do recurso sugeridos.

Os parâmetros de recurso para um determinado tipo de recurso são exibidos de acordo com os valores de exibição fornecidos com os padrões de recurso do repositório do servidor CRD. Os parâmetros de recurso são exibidos como atualizáveis, protegidos ou ocultos.

Por padrão, um recurso criado está instalado na região do CICS TS 3.1 que executa o servidor CRD. No entanto, o usuário pode indicar que o recurso deve ser instalado em outra região CICS de destino. Isso é realizado de acordo com o ambiente instalado.

Se o CICSPlex SM não estiver instalado, um recurso poderá ser instalado em um destino que tenha uma conexão MRO ativa com a região de conexão primária. Isso pode ser feito de uma das duas maneiras:

Se o CICSPLex SM estiver instalado, o recurso poderá ser instalado em qualquer região do CICS no mesmo CICSPlex da região de conexão primária. Isso pode ser feito de uma das três maneiras:

  1. Fornecendo um SYSID do CICS de quatro caracteres no campo Sysid da seção DestinationInfo.
  2. Fornecendo o ID do Aplicativo VTAM (APPLID), pelo qual a região de destino é conhecida no VTAM, no campo Applid da seção DestinationInfo.
  3. Fornecendo um nome de região do CICS, pelo qual a região de destino é conhecida no CICSPlex SM, no campo Applid da seção DestinationInfo.

Há dois benefícios de adicionais em operar em um ambiente CICSPlex SM, conforme a seguir:

  1. É possível criar alguns recursos do CICS em que uma única definição de recurso possa ser utilizada para definições locais e remotas. Isso se aplica às definições de Programa, Transação, Arquivo e TDQ. Nesses tipos de definições, atributos locais e remotos são determinados na mesma definição. Quando a definição é instalada, os atributos de definição remota são instalados na região de destino, conforme descrito acima. Os atributos de definição local são instalados na região especificada pelo campo Related Applid da seção DestinationInfo. O campo Related Applid pode conter um nome de região VTAM Applid ou CICSPlex SM CICS.
  2. Grupos de recursos podem ser criados. Após a criação de um grupo de recursos, você pode especificar esse grupo de recursos ao criar outras definições de recursos fornecendo o nome do grupo de recursos no campo Grupo de Recursos da seção DestinationInfo. O grupo de recursos agora está associado com o grupo especificado.

Os valores de parâmetro de recurso do CICS são governados pelas regras conforme especificado no CICS Resource Definition Guide (SC34-6430).

(C) Copyright IBM Corporation 2006, 2007. Todos os Direitos Reservados.