Utilización de procedimientos JCL para iniciar IBM HTTP Server en z/OS

Puede preparar procedimientos JCL para iniciar y detener IBM® HTTP Server desde la consola del sistema MVS.

Si se utiliza un procedimiento catalogado JCL para emitir los mandatos de inicio y detención de apachectl, puede iniciar y detener una instancia de IBM HTTP Server desde la consola del sistema MVS. Otros mandatos de apachectl pueden emitirse desde la consola del sistema MVS utilizando el mismo procedimiento.

Copie el siguiente procedimiento JCL de ejemplo desde SHAPJCL(HAPAPROC) a la biblioteca de procedimientos del sistema:

//*---------------------------------------------------------
//IHSAPACH PROC ACTION='start',
//          DIR='/path/to/IHS/runtime/directory',
//          CONF='conf/httpd.conf'
//*---------------------------------------------------------
//IHS      EXEC PGM=BPXBATCH,
// PARM='SH &DIR/bin/apachectl -k &ACTION -f &CONF -DNO_DETACH',
// MEMLIMIT=512M
//STDOUT   DD  PATH='&DIR/logs/proc.output',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//STDERR   DD  PATH='&DIR/logs/proc.errors',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//         PEND
Aviso: El valor PARM tiene un límite de 100 caracteres. Dado que el valor PARM contiene el directorio de instalación (&DIR), la longitud total no podría superar el límite de 100 caracteres si la vía de acceso del directorio es demasiado larga. Debe tenerse en cuenta la longitud del nombre de vía de acceso cuando se elige el directorio de instalación. Si el nombre de vía de acceso del directorio de instalación es demasiado largo, se puede utilizar un nombre abreviado de vía de acceso en el JCL que esté simbólicamente enlazado con el nombre de vía de acceso del directorio de instalación original.
Si necesita un valor PARM con más de 100 caracteres, puede utilizar la tarjeta JCL /PARMIN DD *,SYMBOLS=JCLONLY como se muestra en el ejemplo siguiente:
/*------------------------------------------------------
//WEBFTNEI JOB (KOMA-Y98),'Apache NZX2      ',MSGCLASS=T,
//  TIME=NOLIMIT                                        
//         EXPORT SYMLIST=*                             
//*-------------------------------------                
//  SET  ACTION='start'                                 
//  SET  DIR='/home/ihsa/install/webft'                 
//  SET  CONF='../../httpd/webftnei.conf'               
//*-----------------------------------------------------
//IHS EXEC PGM=BPXBATCH,PARMDD=PARMIN,                  
// MEMLIMIT=512M
//PARMIN   DD *,SYMBOLS=JCLONLY                         
PGM &DIR/bin/apachectl                                  
   -k &ACTION
   -f &CONF
   -DNO_DETACH
//*-------------------------------------------------------
//STDOUT   DD SYSOUT=T                                    
//*                                                        
//STDERR   DD SYSOUT=T                                     
//*                                                       
//                                                        
//STDOUT   DD  PATH='&DIR/logs/proc.output',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//*                                                      
//STDERR   DD  PATH='&DIR/logs/proc.errors',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//                                                        
/*---------------------------------------------------------- 

Una descripción del mandato apachectl utilizada en el JCL de ejemplo puede encontrarse en el sitio web de la Interfaz de control de servidor HTTP de Apache.

El nombre de trabajo por omisión para la instancia de IBM HTTP Server será el mismo que el nombre de miembro del procedimiento catalogado. El servidor web es un servidor de varios procesos y para cada proceso adicional que se cree se generará un nombre de trabajo basado en el nombre de trabajo original. Si el nombre de trabajo original tiene una longitud de 8 caracteres, todos los procesos adicionales tendrán el mismo nombre de trabajo. Si el nombre del trabajo original tiene menos de 8 caracteres, los procesos adicionales tendrán nombres de trabajo formados por el nombre de trabajo original con un dígito añadido como sufijo. Si el servidor web se inicia desde el entorno UNIX utilizando el mandato bin/apachectl, el nombre de trabajo predeterminado será el ID de usuario bajo el que se ejecuta el mandato. Como sucede con el nombre de trabajo, si el ID de usuario tiene 8 caracteres, todos los procesos adicionales tendrán el mismo nombre de trabajo. Si el ID de usuario tiene menos de 8 caracteres, los procesos tendrán nombres de trabajo formados por el ID de usuario con un dígito añadido como sufijo.

En los siguientes ejemplos, se utiliza el nombre de procedimiento WEBSRV1. Edite el nuevo procedimiento catalogado sustituyendo /path/to/IHS/runtime/directory por el directorio de instalación correspondiente a esta instancia de IBM HTTP Server. Cree un perfil SAF STARTED para asociar el ID de usuario de servidor y el grupo con la tarea iniciada del servidor web:
RDEFINE STARTED WEBSRV1.* STDATA(USER(WWWSERV) GROUP(WWWGROUP) TRACE(YES))
SETROPTS RACLIST(STARTED) GENERIC(STARTED) REFRESH
  • Para iniciar el servidor desde la consola del sistema MVS, especifique:
    S WEBSRV1
    Nota: El nombre de trabajo del servidor web puede cambiarse añadiendo jobname al mandato de inicio, por ejemplo:
    S WEBSRV1,JOBNAME=HTTPDWS1
    Procedimiento recomendado 1: Utilice un nombre de trabajo de ocho caracteres. La utilización de un nombre de trabajo de ocho caracteres garantiza que todos los procesos creados para esta instancia del servidor web tendrán el mismo nombre de trabajo.
    Para detener el servidor, especifique:
    P WEBSRV1
    Nota: Cuando utilice SDSF, debe utilizar la pantalla Extensión de mandatos del sistema (entrada de mandatos) para especificar el mandato que detendrá el servidor.
    • En el indicador de mandatos, escriba una barra inclinada (/) y pulse Intro para acceder a la ventana Extensión de mandatos del sistema.
    • En la ventana Extensión de mandatos del sistema, especifique el mandato S WEBSRV1,ACTION='stop'. Compruebe que stop se haya especificado en minúsculas.
  • Para emitir otros mandatos apachectl, especifique:
    S WEBSRV1,ACTION='<mandato>'
  • Para reiniciar el servidor, especifique lo siguiente:
    S WEBSRV1,ACTION=restart
    Puede reiniciar el servidor desde la consola de z/OS.
  • Para reiniciar el servidor ordenadamente, especifique:
    S WEBSRV1,ACTION=graceful
    Puede reiniciar el servidor ordenadamente desde la consola de z/OS.

Los archivos de salida de los mandatos start y stop se encuentran en los archivos especificados en las sentencias JCL STDOUT y STDERR DD del procedimiento

Utilización del módulo zos_cmds: Si el módulo zos_cmds está activo, puede utilizar los mandatos de consola STOP y MODIFY de z/OS.
Importante: En el archivo httpd.conf, debe añadirse la línea siguiente para activar el módulo zos_cmds:
LoadModule zos_cmds_module modules/mod_zos_cmds.so 
Nota: Si no utiliza un nombre de trabajo de ocho caracteres coherente para todos los procesos, debe determinar el nombre de trabajo del proceso que gestiona los mandatos de operador de z/OS de esta instancia del servidor web. Cuando se inicie el servidor web, emitirá un mensaje a la consola del operador que identifica el trabajo que gestiona los mandatos de operador.
BPXM023I
(WASTST1) IHS is active. Use jobname HTTPDWS1 for MVS commands.
donde WASTST1 es el ID de usuario bajo el cual se ejecuta el servidor web. Se escribirá una entrada en el registro de errores que también identifica el nombre de trabajo. Tenga en cuenta que el nombre de trabajo del daemon mod_zos_cmds es HTTPDWS1. Cuando se especifica un mandato MODIFY, se destina a cada trabajo con el nombre de trabajo especificado. Sólo uno de los procesos del servidor web aceptará el mandato. El sistema emitirá el mensaje siguiente para cada uno de los otros trabajos con el mismo nombre de trabajo.
IEE342I MODIFY   REJECTED-TASK BUSY
  • Para detener el servidor utilizando el mandato stop:
    P HTTPDWS1
  • Para reiniciar el servidor utilizando el mandato modify, especifique:
    F HTTPDWS1,appl='restart'
  • Para reiniciar ordenadamente el servidor utilizando el mandato modify, especifique:
    F HTTPDWS1,appl='graceful'
Si el servidor web se detiene con el módulo zos cmds activo, emitirá el mensaje siguiente a la consola del operador.
BPXM023I (WASTST1) IHS is stopping
donde WASTST1 es el ID de usuario bajo el cual se ejecuta el servidor web.
Procedimiento recomendado 2: Los archivos de salida se sobrescriben cada vez que se utiliza el procedimiento. Podrían contener mensajes de aviso sobre la configuración o mensajes de error para las anomalías de inicio. Si desea retener las anotaciones cronológicas de estos mensajes en diversos usos del procedimiento, modifique las dos apariciones de la opción PATHOPTS en el procedimiento de ejemplo de la manera siguiente: PATHOPTS=(OCREAT,OAPPEND,OWRONLY). Para obtener más información sobre la opción PATHOPTS, consulte la publicación de z/OS MVS JCL Reference (SA22-7597). Enlace con este documento desde la Biblioteca de internet de z/OS.
Procedimiento recomendado 3: No se recomienda la sentencia STDENV DD. Si lo desea, puede añadir valores de variable de entorno al archivo bin/envvars en el directorio de tiempo de ejecución para que las variables se activen cuando se inicie IBM HTTP Server desde JCL o desde el entorno UNIX.
Procedimiento recomendado 4: Se recomienda el parámetro SH de BPXBATCH en lugar del parámetro PGM. El proceso del parámetro PGM omite los valores predeterminados del sistema en el archivo /etc/profile, incluido el valor umask, y los archivos creados por IBM HTTP Server no tienen los permisos correctos.

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=ihs-dist&topic=cihs_startsysconz
File name: cihs_startsysconz.html