Procedimentos Catalogados de z/OS JCL

O servidor WebSphere Application Server for z/OS usa os procedimentos catalogados JCL para servidores de aplicativos independentes e células de Implementação de Rede. Aprenda sobre as convenções de nomenclatura recomendadas e a designação de IDs do usuário para os espaços de endereço do WebSphere Application Server for z/OS.

Nota: Durante o processo de customização do WebSphere Application Server nos sistemas operacionais z/OS, o Profile Management Tool (z/OS apenas) ou o comando zpmt.sh cria uma tarefa de customização, BBOxPROC, para copiar procedimentos catalogados para a biblioteca de procedimentos de sistemas. Execute a tarefa BBOxPROC para que o servidor tenha procedimentos catalogados atuais. Se você executar o código Versão 9.0 do WebSphere Application Server for z/OS com procedimentos catalogados de versões anteriores, poderá resultar em falhas de inicialização do servidor.

Cada servidor WebSphere Application Server para z/OS utiliza um procedimento catalogado de JCL. Esses procedimentos são todos muito semelhantes e consistem em um procedimento catalogado principal e em um membro INCLUDE que contém instruções DD. A seguir, membros da biblioteca de procedimentos catalogados de amostra para um controlador, como gerados pela Ferramenta de Gerenciamento de Perfil ou pelo comando zpmt:

Membro BBO8ACR da biblioteca de procedimentos:
//BBO8ACR  PROC ENV=,PARMS=' ',REC=N,AMODE=00                   
// SET ROOT='/wasv9config/bbobase/bbonode'                      
// SET FOUT='properties/service/logs/applyPTF.out'              
// SET WSDIR='AppServer'                                        
//************************************************************* 
//* O teste desse OMVS pode ativar com êxito um shell e retornar * 
//************************************************************* 
//TOMVS   EXEC PGM=BPXBATCH,REGION=0M,                          
// PARM='SH exit 13'                                            
//SYSOUT   DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//*********************************************************     
//* Se o código RC do shell estiver conforme esperado (13) - continue    *     
//*********************************************************     
//IFTST   IF (RC = 13) THEN                                     
//*********************************************************     
//* Inicie o Pós-instalador de PTFs para vários produtos       *     
//*********************************************************     
//APPLY   EXEC PGM=BPXBATCH,REGION=0M,                          
// PARM='SH &ROOT./&ENV..HOME/bin/applyPTF.sh inline'           
//SYSOUT   DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//       IF (APPLY.RC <= 4) THEN                                
//*********************************************************          
//* Se o RC do pós-instalador for LE 4, inicie  *          
//* o WebSphere Application Server                      *          
//*********************************************************          
//STEP1    EXEC PGM=BPXBATA2,REGION=0M,TIME=MAXIMUM,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bbooctlm &AMODE. &PARMS. 
//REC=&REC' STDENV DD PATH='&ROOT/&ENV/was.env'                      
//*                                                                  
//* DDs de saída                                                       
//*                                                                  
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                      
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                      
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                      
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                      
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                      
//          ENDIF                                                    
//IFTSTEND ENDIF 
Membro BBO8ASR da biblioteca de procedimentos:
//BBO8ASR  PROC ENV=,AMODE=00                                       
//  SET ROOT='/wasv9config/bbobase/bbonode'                         
// SET WSDIR='AppServer'                                           
//STEP1   EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bboosrmr &AMODE.'       
//STDENV    DD PATH='&ROOT/&ENV/was.env'                            
//*                                                                 
//* DDs de saída                                                      
//*                                                                 
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                     
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                     
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                     
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE                     
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE 
O procedimento catalogado especifica o local em que o procedimento é processado:
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbooctlm ...' (controlador)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboosrmr ...' (servidor)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboocram ...' (processo auxiliar)
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbodmnm ...' (daemon do serviço de localização)
O parâmetro PARM= na instrução EXEC PGM contém os parâmetros transmitidos ao programa identificado pelo parâmetro PGM=.
Nota: A interface adequada para fazer alterações nos parâmetros do ambiente de linguagem (LE) é através do arquivo was.env, no entanto, não modifique nenhum parâmetro do LE sem consultar primeiro a equipe de suporte a software da IBM®. Os parâmetros LE são definidos internamente para assegurar o melhor desempenho possível do WebSphere Application Server, que é o principal aplicativo LE em execução no espaço de endereçamento. Se for necessário incluir ou alterar parâmetros do LE, certifique-se de trabalhar com a equipe de suporte a software da IBM para garantir que os parâmetros configurados internamente não sejam englobados.

Os pontos de instrução STDENV DD para o arquivo was.env (parâmetro de inicialização) do servidor. O caminho para esse arquivo consiste no nome do diretório do HFS de configuração (com hardcode atribuído utilizando a variável ROOT JCL) e no link simbólico para esse servidor específico, que é especificado na inicialização utilizando o parâmetro ENV=.

O procedimento catalogado do controlador inclui algumas instruções adicionais antes da instrução EXEC que chama BPXBATA2. Essas são utilizadas para chamar o programa de pós-instalação que aplica qualquer manutenção necessária ao HFS de configuração e aos seus diretórios home quando o serviço é aplicado ao HFS do produto e aos módulos de carregamento.

As seções a seguir descrevem os procedimentos catalogados requeridos para cada configuração, fornecem uma convenção de nomenclatura recomendada e explicam como o ID do usuário do SAF para cada servidor é determinado.

Procedimentos Catalogados para Servidores de Aplicativos Independentes

Um servidor de aplicativos independente usa os seguintes procedimentos catalogados:
  • Procedimento catalogado do controlador
  • Procedimento catalogado do servant
  • Procedimento catalogado do processo adjunto
  • Procedimento catalogado do daemon do serviço de localização

É possível usar os procedimentos catalogados para servidores independentes diferentes, se o HFS de configuração e o nível de código do produto (incluindo STEPLIB) forem iguais para os dois servidores.

Procedimentos Catalogados para Células do Network Deployment

Uma célula do Network Deployment usa os seguintes procedimentos catalogados:

Para o gerenciador de implementação:
  • Procedimento catalogado do controlador do gerenciador de implementação
  • Procedimento catalogado do servant do gerenciador de implementação
Para cada nó do servidor de aplicativos:
  • Procedimento catalogado do controlador de servidor de aplicativos (também utilizado para o agente do nó)
  • Procedimento catalogado do servant do servidor de aplicativos
  • Procedimento catalogado do processo adjunto
Para o daemon do serviço de localização (um por sistema z/OS):
  • Procedimento catalogado do daemon do serviço de localização

O procedimento catalogado do servant do servidor de aplicativos é o único que provavelmente requer modificação para colocar bibliotecas (CICS, DB2 e outras) na concatenação de STEPLIB.

É possível usar os mesmos procedimentos catalogados para vários nós em uma célula do Network Deployment, ou mesmo para várias células, se o HFS de configuração for igual para todas elas.

Uma Convenção de Nomenclatura Recomendada do Procedimento Catalogado

Utilize uma convenção de nomenclatura consistente para seus procedimentos catalogados do WebSphere Application Server para z/OS. O nome do procedimento deve ser distinto para o HFS de configuração e versão do WebSphere Application Server para z/OS

A seguinte convenção funciona para um servidor de aplicativos independente ou uma célula do Network Deployment, por exemplo, em que cc é um identificador de célula com dois caracteres:
Procedimento Nome Recomendado
Controlador do gerenciador de implementação cc8DCR
Servant do gerenciador de implementação cc8DSR
Controlador do daemon do serviço de localização cc8DMN
Controlador do servidor de aplicativos cc8ACR
Servant do servidor de aplicativos cc8ASR
Control region adjunct cc8AAR
Se procedimentos catalogados separados forem necessários para nós em sistemas diferentes em um sysplex (se eles precisarem de instruções STEPLIB configuráveis independentemente para permitir um reinício ininterrupto, por exemplo), coloque os procedimentos do daemon de serviço de localização e do servidor de aplicativos em proclibs específicas do sistema ou anexe um identificador de sistema com um caractere aos nomes de procedimentos catalogados para o daemon de serviço de localização e servidores de aplicativos.

Designando IDs de Usuários para Espaços de Endereçamento do WebSphere Application Server for z/OS

Se você usar o z/OS Security Server (RACF) como seu sistema de segurança compatível com SAF no z/OS, os perfis de classe STARTED serão usados para atribuir os IDs de usuário de tarefa iniciada para cada servidor do WebSphere Application Server for z/OS. Esses perfis STARTED são configurados pelas tarefas em lote criadas pela Ferramenta de Gerenciamento de Perfil ou pelo comando zpmt. Atualize esses perfis STARTED, conforme necessário, para colocar os servidores que você mesmo cria nos IDs de usuários adequados.

Controladores (gerenciador de implementação, daemon do serviço de localização, agente do nó ou controlador do servidor de aplicativos) são iniciados utilizando um comando START do console que é emitido a partir do console do MVS ou internamente. Para esses servidores, o nome do perfil STARTED que é verificado está no formato procname.jobname.

Sempre que ele cria um controlador ou procedimento catalogado do daemon, a Ferramenta de Gerenciamento de Perfil ou o comando zpmt também cria um perfil STARTED que associa todos os controladores usando esse procedimento catalogado com o ID de usuário do controlador adequado e grupo de configuração. Se você configurasse um servidor de aplicativos independente com nomes padrão, a Ferramenta de Gerenciamento de Perfil ou o comando zpmt criariam então os seguintes perfis STARTED para controladores:
  • RDEFINE STARTED BBO8ACR.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBO8DMN.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Nota: TRACE(YES) grava a mensagem IRR812I no console do MVS sempre que o perfil é utilizado.

Regiões servant (servants do servidor de aplicativos e processos auxiliares) são iniciados utilizando o WLM (Workload Manager). Para esses servidores, o nome do perfil STARTED que é verificado está no formato jobname.jobname.

Infelizmente, não existe uma maneira de designar todos os servidores utilizando um procedimento catalogado de servant específico em um ID de usuário do servant. Assim, a Ferramenta de Gerenciamento de Perfil ou o comando zpmt cria um perfil STARTED para cada servente e um para cada adjunto da região de controle. Se nomes padrão forem escolhidos, os seguintes perfis STARTED serventes serão criados para um servidor de aplicativos independente:
  • RDEFINE STARTED BBOS001S.* STDATA(USER(WSSRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBOS001A.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Ao escolher nomes de procedimentos catalogados, verifique se o perfil STARTED apropriado é adequado para mapear o servidor para seu ID de usuário do SAF apropriado. Utilize os painéis ISPF do RACF ou o comando RLIST STARTED para exibir os perfis STARTED.

Se você utilizar outro sistema de segurança compatível com SAF, entre em contato com o fornecedor do servidor de segurança para obter informações de configuração do WebSphere Application Server for z/OS.


Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cins_plancatzos
Nome do arquivo: cins_plancatzos.html