Procedimientos catalogados JCL de z/OS

El servidor WebSphere Application Server for z/OS utiliza los procedimientos catalogados JCL para células de despliegue de red y servidores de aplicaciones autónomos. Conozca sobre los convenios de denominación recomendados y la asignación de ID de usuario a espacios de direcciones de WebSphere Application Server para z/OS.

Nota: Durante el proceso de personalización de WebSphere Application Server en los sistemas operativos z/OS, la Herramienta de gestión de perfiles (sólo z/OS) o el mandato zpmt.sh crea un trabajo de personalización, BBOxPROC, para copiar procedimientos catalogados en la biblioteca de procedimientos del sistema. Ejecute el trabajo BBOxPROC para que el servidor tenga los procedimientos catalogados. Si ejecuta el código de WebSphere Application Server para z/OS Versión 9.0 con procedimientos catalogados de versiones anteriores, es posible que se produzcan anomalías de arranque del servidor.

Todos los servidores de WebSphere Application Server para z/OS utilizan un procedimiento catalogado JCL. Estos procedimientos son todos muy parecidos y constan de un procedimiento catalogado principal y un miembro INCLUDE que contiene sentencias DD. A continuación, aparecen miembros de ejemplo de la biblioteca de procedimiento catalogado para un controlador, tal como han sido generados por la Herramienta de gestión de perfiles o el mandato zpmt:

Miembro de biblioteca de procedimiento BBO8ACR:
//BBO8ACR  PROC ENV=,PARMS=' ',REC=N,AMODE=00                   
// SET ROOT='/wasv9config/bbobase/bbonode'                      
// SET FOUT='properties/service/logs/applyPTF.out'              
// SET WSDIR='AppServer'                                        
//************************************************************* 
//* Prueba que OMVS puede lanzar satisfactoriamente un shell y devolver * 
//************************************************************* 
//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)   
//*********************************************************     
//* Si el código RC del shell es el que se esperaba (13) - continuar *     
//*********************************************************     
//IFTST   IF (RC = 13) THEN                                     
//*********************************************************     
//* Iniciar el instalador posterior de PTF de varios productos *     
//*********************************************************     
//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                                
//*********************************************************          
//* Si el RC del instalador posterior es LE 4, iniciar    *          
//* 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'                      
//*                                                                  
//* Los DD de salida                                                       
//*                                                                  
//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 
Miembro de biblioteca de procedimiento BBO8ASR:
//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'                            
//*                                                                 
//* Los DD de salida                                                      
//*                                                                 
//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 
El procedimiento catalogado especifica dónde se procesa el procedimiento:
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbooctlm ...' (controlador)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboosrmr ...' (sirviente)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboocram ...' (proceso adjunto)
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbodmnm ...' (daemon de servicio de ubicación)
El parámetro PARM= de la sentencia EXEC PGM contiene los parámetros que se pasan al programa identificado por el parámetro PGM=.
Nota: La interfaz apropiada para realizar cambios en el los parámetros del entorno de lenguaje (LE) es la que se realiza a través del archivo was.env; sin embargo, no modifique ningún parámetro LE sin primero consultarlo con el equipo de Soporte técnico de software de IBM®. Los parámetros se establecen internamente para garantizar el mejor rendimiento posible de WebSphere Application Server, que es la principal aplicación LE en ejecución en el espacio de direcciones. Si debe añadir o modificar los parámetros LE, asegúrese de que trabaja con el equipo de Soporte técnico de software de IBM para garantizar que los parámetros establecidos internamente no se ven comprometidos.

La sentencia STDENV DD indica el archivo was.env (parámetro de arranque) para el servidor. La vía de acceso de este archivo está formada por el nombre de directorio del HFS de configuración (codificado utilizando la variable ROOT JCL) y el enlace simbólico de este servidor en concreto, que se especifica durante el arranque utilizando el parámetro ENV=.

El procedimiento catalogado del controlador incluye algunas sentencias antes de la sentencia EXEC que invoca BPXBATA2. Se utilizan para invocar el programa post-instalador que aplica el mantenimiento necesario al HFS de configuración y a los directorios de inicio cuando se aplica el servicio al HFS del producto y a los módulos de carga.

En los siguientes apartados se describen los procedimientos catalogados necesarios para cada configuración, se proporciona el convenio de denominación recomendado y se explica cómo se determina el ID de usuario SAF de cada servidor.

Procedimientos catalogados para los servidores de aplicaciones autónomos

Un servidor de aplicaciones autónomo utiliza los procedimientos catalogados siguientes:
  • Procedimiento catalogado de controlador
  • Procedimiento catalogado de sirviente
  • Procedimiento catalogado de proceso adjunto
  • Procedimiento catalogado de daemon de servicio de ubicación

Puede utilizar los mismos procedimientos catalogados para distintos servidores autónomos si el HFS de configuración y el nivel de código de producto (incluido STEPLIB) son los mismos para ambos servidores.

Procedimientos catalogados para células de Network Deployment

Una célula de Network Deployment utiliza los procedimientos catalogados siguientes:

Para el gestor de despliegue:
  • Procedimiento catalogado de controlador de gestor de despliegue
  • Procedimiento catalogado de sirviente de gestor de despliegue
Para cada nodo de servidor de aplicaciones:
  • Procedimiento catalogado de controlador de servidor de aplicaciones (también se utiliza para el agente de nodo)
  • Procedimiento catalogado de sirviente de servidor de aplicaciones
  • Procedimiento catalogado de proceso adjunto
Para el daemon de servicio de ubicación (uno por sistema z/OS):
  • Procedimiento catalogado de daemon de servicio de ubicación

El procedimiento catalogado de servant de servidor de aplicaciones es el único que puede necesitar alguna modificación, para colocar bibliotecas (CICS, DB2, etc.) en la concatenación STEPLIB.

Puede utilizar los mismos procedimientos catalogados para varios nodos de una célula de Network Deployment, o incluso para varias células, si el HFS de configuración es el mismo para todos ellos.

Un convenio de denominación recomendado de procedimientos catalogados

Utilice un convenio de denominación coherente para los procedimientos catalogados de WebSphere Application Server para z/OS. El nombre del procedimiento se debe distinguir entre WebSphere Application Server for z/OS versión y el HFS de configuración

El siguiente convenio trabaja para un servidor de aplicaciones autónomo, o bien para una célula de Network Deployment, por ejemplo, donde cc es un identificador de célula de dos caracteres.
Procedimiento Nombre recomendado
Controlador de gestor de despliegue cc8DCR
Sirviente de gestor de despliegue cc8DSR
Controlador de daemon de servicio de ubicación cc8DMN
Controlador del servidor de aplicaciones cc8ACR
Sirviente de servidor de aplicaciones cc8ASR
Complementos de región de control cc8AAR
Si necesita procedimientos catalogados separados para nodos en distintos sistemas de un sysplex (por ejemplo, si se necesita definir de forma independiente las sentencias STEPLIB para permitir un reinicio sin interrupciones), coloque los procedimientos del daemon de servicio de ubicación y los del servidor de aplicaciones en proclibs específicas del sistema, o anexe un identificador del sistema de un carácter a los nombres de procedimiento catalogado para el daemon de servicio de ubicación y los servidores de aplicaciones.

Asignación de ID de usuario a espacios de direcciones de WebSphere Application Server para z/OS

Si utiliza z/OS Security Server (RACF) como el sistema de seguridad compatible de SAF en z/OS, los perfiles de la clase STARTED se utilizan para asignar los ID de usuario de tareas iniciadas a cada servidor WebSphere Application Server for z/OS. Estos perfiles STARTED son configurados por los trabajos de lotes creados por la Herramienta de gestión de perfiles o el mandato zpmt. Actualice estos perfiles STARTED según sea necesario para colocar los servidores que cree con los ID de usuario apropiados.

Los controladores (de gestor de despliegue, daemon de servicio de ubicación, agente de nodo o servidor de aplicaciones) se inician utilizando un mandato START de consola, que se emite desde la consola MVS o internamente. Para estos servidores, el nombre del perfil STARTED que se comprueba tiene el formato nombreproc.nombretrabajo.

Siempre que crea un procedimiento catalogado de daemon o controlador, la Herramienta de gestión de perfiles o el mandato zpmt también crea un perfil STARTED que asocia todos los controladores utilizando ese procedimiento catalogado con el grupo de configuración y el ID de usuario de controlador correspondientes. Si configura un servidor de aplicaciones autónomo con los nombres por omisión, por lo tanto, la Herramienta de gestión de perfiles o el mandato zpmt creará los perfiles STARTED siguientes para los controladores:
  • RDEFINE STARTED BBO8ACR.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBO8DMN.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Nota: TRACE(YES) escribe el mensaje IRR812I en la consola MVS siempre que se utiliza el perfil.

Las regiones de sirviente (sirvientes de servidor de aplicaciones y procesos adjuntos) se inician utilizando Workload Manager (WLM). Para estos servidores, el nombre de perfil STARTED que se comprueba tiene el formato nombretrabajo.nombretrabajo.

Desgraciadamente, no se pueden asignar todos los servidores utilizando un determinado procedimiento catalogado de servant a un ID de usuario de servant. Por lo tanto, la Herramienta de gestión de perfiles o el mandato zpmt crea un perfil STARTED para cada sirviente y uno para cada complemento de la región de control. Si los nombres por omisión se eligen, se crean los perfiles STARTED del sirviente siguientes para un servidor de aplicaciones autónomo:
  • RDEFINE STARTED BBOS001S.* STDATA(USER(WSSRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBOS001A.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Cuando elija nombres de procedimientos catalogados, compruebe que el perfil STARTED correspondiente esté en su sitio para correlacionar el servidor con el ID de usuario SAF correspondiente. Utilice los paneles RACF ISPF o el mandato RLIST STARTED para visualizar los perfiles STARTED.

Si utiliza otro sistema de seguridad compatible con SAF, póngase en contacto con el proveedor del servidor de seguridad para obtener información sobre la configuración de WebSphere Application Server para z/OS.


Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cins_plancatzos
File name: cins_plancatzos.html