Configurando o gateway ISPF para Suporte de Construção, Implementação e Promoção.

É possível configurar o gateway ISPF para suporte a componentes de construção, implementação e promoção que estão disponíveis com uma licença de acesso do cliente do Developer for IBM® Enterprise Platforms.

ISPF fornece uma interface, chamada gateway ISPF, para aplicativos clientes para conectarem a um host z/OS e executar comandos TSO e ISPF. O gateway ISPF é instalado como parte do ISPF, como módulos de carregamento e arquivos no HFS. Esses arquivos são, geralmente, instalados em /usr/lpp/ispf/bin. A construção, implementação e componentes de promoção são criados como parte da instalação do SMP/E. Dependendo de sua configuração, modificações adicionais podem precisar dos scripts e componentes fornecidos pelo gateway ISPF. As configurações e procedimento padrão para modificar os padrões são descritos posteriormente.

Os seguinte componentes são incluídos:

Arquivo de ambiente de gateway ISPF: ISPZXENV
Arquivo do ambiente de gateway ISPF contendo configurações customizáveis para o gateway ISPF.
O arquivo ISPZXENV é fornecido como parte do z/OS. Por padrão, este arquivo é instalado em /usr/lpp/ispf/bin. Entretanto, este diretório é, geralmente, marcado como SOMENTE LEITURA após a instalação. Este arquivo de ambiente é executado pelo gateway ISPF para obter o valor de determinadas variáveis de ambiente necessárias para o gateway ISPF para execução. Por padrão, essas variáveis são:
STEPLIB
Por padrão é configurado para STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD'
CGI_ISPCONF
Por padrão é configurado para CGI_ISPCONF = '/etc/ispf'
CGI_ISPWORK
Por padrão é configurado para CGI_ISPWORK = '/var/ispf'

Para configurar variáveis para valores não padrão, copie ISPZXENV para um diretório de configuração gravável, como /etc/ispf, e configure as variáveis para seus valores necessários. Você deve alterar sua variável de ambiente de caminho no startispf.sh, que é descrita posteriormente, para ler esse local antes do caminho do compartimento ISPF padrão.

Por exemplo:
export PATH=/etc/ispf:$PATH  

No diretório de trabalho do gateway ISPF, por padrão /var/ispf, você deve ter um diretório existente criado chamado WORKAREA, que tem permissões de leitura e gravação para todos os usuários. Diretórios temporários no formato /var/ispf/WORKAREA/<userid>/* são criados quando o gateway ISPF é usado. Se você estiver usando a instalação do gateway ISPF padrão conforme fornecido pelo ISPF, esse diretório está normalmente em /var/ispf/WORKAREA. Se o diretório não existir, siga as instruções no capítulo intitulado Installing and customizing the gateway no ISPF Planning and Customizing (GC34-4814).

Script de inicialização de gateway ISPF: startispf.sh
Shell script para iniciar o gateway ISPF para implementação e promoção.
Para iniciar o gateway ISPF, o Rational Team Concert fornece um shell script que é chamado a partir das tarefas Ant de implementação e promoção. Esse script está instalado em /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway. Como parte da customização padrão, este script é copiado para o diretório de configuração Rational Team Concert, geralmente /etc/jazz40/ccm pela tarefa BLZCPBTK. Dependendo de sua configuração, pode ser necessário modificar este shell script para configurar algumas variáveis de ambiente.
PATH
A variável PATH deve apontar para o diretório inicial do gateway ISPF:
export PATH=$PATH:/usr/lpp/ispf/bin             
Se você modificou ISPZXENV, pode ser necessário configurar o PATH como:
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

Se você precisar usar concatenações de biblioteca diferentes no ISPF.conf, configure sua instalação para suportar diversos projetos e fluxos, criando diversas cópias do script startispf.sh, arquivo ISPF.conf e arquivo ISPZXENV. Em cada cópia do arquivo ISPZXENV, configure a variável CGI_ISPFCONF para apontar para o local do arquivo ISPF.conf relacionado. Depois, em cada cópia do script startispf.sh, configure a variável PATH para apontar para a cópia apropriada do arquivo ISPF.conf. Em seguida, use o script startispf.sh que corresponde ao ambiente necessário para um determinado projeto.

Script de inicialização de construção do Enterprise Extensions: startbfa.sh
O shell script para iniciar o Rational Build Agent usando uma construção do Enterprise Extensions.
As construções do Enterprise Extensions fornecem um mecanismo para iniciar uma construção que, por sua vez, inicia um programa, um comando ISPF ou arquivo executável ou um comando TSO ou arquivo executável. Se o objeto que está sendo iniciado pela construção estiver em uma biblioteca alocada ISPF, você deverá configurar a construção para fornecer acesso ao objeto necessário. No startbfa.sh, você deve listar o local dos arquivos fornecidos pelo ISPF para que o Rational Build Agent possa iniciar o gateway ISPF. Por padrão esses arquivos estão em /usr/lpp/ispf e são especificados em startbfa.sh utilizando variável _CMDSERV_BASE_HOME. Se você tiver os arquivos binários de gateway ISPF instalados em outro local, deverá alterar essa variável. Por exemplo:
#                                                  
# Especifique o diretório inicial para os programas ISPF.
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

Os programas ISPF e arquivos executáveis devem ser alocados no arquivo de configuração de gateway ISPF (ISPF.conf) conforme descrito posteriormente. O Rational Build Agent também requer acesso ao ISPF.conf. O acesso é configurado no arquivo do ambiente de gateway ISPF (ISPZXENV). Se planeja usar os recursos do ISPF nas construções e não usar o local padrão /usr/lpp/ispf/bin, você deve criar uma cópia do ISPZXENV em um diretório de configuração gravável e apontar o Rational Build Agent para o local. Configure a propriedade de construção teamz.build.ant.myISPFBinPath para o local do diretório que contém o arquivo ISPZXENV. Você pode editar o calor ou incluir a propriedade utilizando a guia Propriedades em sua definição de construção. Para obter informações adicionais, consulte Gerenciando Construções do z/OS

Arquivo de configuração de gateway ISPF: ISPF.conf
Arquivo de configuração de gateway ISPF contendo configurações customizáveis para o gateway ISPF.
O arquivo ISPF.conf é fornecido como parte do z/OS. O arquivo de configuração de gateway ISPF fornece as alocações necessárias para iniciar uma sessão ISPF em uma tarefa criada. Para que as funções de construção, implementação e promoção iniciem módulos para executar tarefas específicas, os módulos devem ser disponibilizados nas concatenações do ISPF. Por padrão, essas alocações são configuradas como a seguir:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
Para que a implementação e promoção funcione, inclua a biblioteca de carregamento do produto Rational Team Concert (hlq.SBLZLOAD) e a biblioteca de mensagens do produto (hlq.SBLZMENU) na concatenação ISPLLIB e ISPMLIB. As alocações modificadas são semelhantes a este exemplo:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Executando Módulos de Implementação Interpretativa

Se você deseja incluir seus próprios processos de implementação ou funções, pode executar versões interpretativas dos módulos de implementação. O componente de implementação executa os seguintes programas:
Tabela 1. Programas Executados pelo Componente de Implementação
Programa Função Descrição
BLZPKGZP Pacote de implementação Utilizando o arquivo de manifesto crie um arquivo .zip dos conteúdos especificados.
BLZBKPZP Backup de implementação Usando o arquivo do pacote, faça cópias de backup dos módulos que a implementação sobrescreve.
BLZDEPZP Implementação Usando o arquivo de manifesto de implementação, implemente o conteúdo do arquivo .zip especificado.
As tarefas de implementação do Rational Team Concert chamam esses programas para executar a função descrita. Se quiser modificar esses programas, é possível fazer isso modificando as amostras fornecidas que estão na biblioteca hlq.SBLZSAMP e, em seguida, apontar para a versão modificada em ISPF.conf. Assim, se você fizer as modificações diretamente em hlq.SBLZSAMP, suas alocações do ISPF.conf serão semelhantes a este exemplo:
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
O ISPF verifica primeiro a concatenação ISPLLIB, a menos que o comando tenha um prefixo de símbolo percentual %; portanto, você deve renomear ou remover os módulos que alterou do conjunto de dados hlq.SBLZLOAD.

Incluindo suas próprias bibliotecas EXEC no arquivo de configuração de gateway ISPF.

Para compilações do Enterprise Extensions, se você usar o método chamado ISPF, deve também incluir sua própria biblioteca EXEC nas concatenações SYSEXEC ou SYSPROC no ISPF.conf. Se você especificou um nome EXEC, ou especificou um SELECT CMD(exec), então, o ISPF irá requerer acesso ao EXEC obrigatório na concatenação apropriada. Você deve modificar o ISPF.conf para incluir quaisquer bibliotecas EXEC necessárias, por exemplo:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Para obter mais informações sobre o gateway ISPF, consulte o capítulo intitulado TSO/ISPF client gateway in ISPF Planning and Customizing em ISPF Planning and Customizing (GC34-4814).

Resolução de Problemas da Configuração do Gateway ISPF

Verifique se o gateway ISPF está corretamente configurado. Qualquer ID do usuário que execute funções do Rational Team Concert que usem o gateway ISPF deve ter as permissões necessárias descritas em ISPF Planning and Customizing (GC34-4814) em http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf.

O script Rational Team Concert startispf.sh usa os comandos UNIX System Services que precisam de acesso ao diretório /tmp. O ID do usuário de construção que inicia o script startispf.sh deve ter acesso ao diretório /tmp. É possível substituir o uso do /tmp como o diretório temporário, incluindo a linha a seguir em /etc/jazz40/ccm/startispf.sh:
export TMPDIR=/yourTemporaryDir
em que yourTemporaryDir é um diretório com acesso de gravação para usuários de construção.

Feedback