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
/*------------------------------------------------------
//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.
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:
Puede reiniciar el servidor desde la consola de z/OS.S WEBSRV1,ACTION=restart
- Para reiniciar el servidor ordenadamente, especifique:
Puede reiniciar el servidor ordenadamente desde la consola de z/OS.S WEBSRV1,ACTION=graceful
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
LoadModule zos_cmds_module modules/mod_zos_cmds.so
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'
BPXM023I (WASTST1) IHS is stopping
donde
WASTST1 es el ID de usuario bajo el cual se ejecuta el servidor web.