Utilisation de procédures JCL pour démarrer IBM HTTP Server on z/OS

Vous pouvez préparer des procédures JCL pour démarrer et arrêter IBM® HTTP Server à partir de la console système MVS.

En utilisant une procédure cataloguée JCL pour exécuter les commandes de démarrage et d'arrêt apachectl, vous pouvez démarrer et arrêter une instance d'IBM HTTP Server depuis la console système MVS. D'autres commandes apachectl peuvent être exécutées depuis la console MVS via la même procédure.

Copiez l'échantillon de procédure JCL suivant depuis SHAPJCL(HAPAPROC) dans votre bibliothèque de procédure système :

//*---------------------------------------------------------
//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
Avertissement : La valeur PARM est limitée à 100 caractères. Dans la mesure où la valeur PARM contient le répertoire d'installation (&DIR), il se peut que la longueur totale dépasse la limite fixée à 100 caractères si le chemin de répertoire est trop long. La longueur du nom de chemin doit être prise en compte lors du choix du répertoire d'installation. Si le nom de chemin du répertoire d'installation est trop long, il est possible d'utiliser un nom de chemin plus court dans le JCL qui est lié de manière symbolique au nom de chemin du répertoire d'installation d'origine.
Si vous avez besoin d'une valeur PARM supérieure à 100 caractères, vous pouvez utiliser la carte JCL /PARMIN DD *,SYMBOLS=JCLONLY comme illustré dans l'exemple ci-dessous :
/*------------------------------------------------------
//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)        
//                                                        
/*---------------------------------------------------------- 

Une description de la commande apachectl utilisée dans l'échantillon JCL est disponible sur le site Web Apache HTTP Server Control Interface.

Le nom de travail par défaut de l'instance d'IBM HTTP Server sera identique au nom de membre de la procédure cataloguée. Le serveur Web est un serveur multi-processus, et chaque processus supplémentaire créé sera associé à un nom de travail généré en fonction du nom de travail d'origine. Si le nom de travail d'origine comporte 8 caractères, tous les processus supplémentaires porteront le même nom de travail. Si le nom de travail d'origine comporte moins de 8 caractères, les processus supplémentaires porteront un nom de travail constitué du nom de travail d'origine et d'un chiffre ajouté comme suffixe. Si le serveur Web est démarré à partir de l'environnement UNIX à l'aide de la commande bin/apachectl, le nom de travail par défaut correspondra à l'ID utilisateur sous lequel la commande est exécutée. Comme pour le nom de travail, si l'ID utilisateur comporte 8 caractères, tous les processus supplémentaires porteront le même nom de travail. Si l'ID utilisateur comporte moins de 8 caractères, les processus supplémentaires porteront un nom de travail constitué de l'ID utilisateur et d'un chiffre ajouté comme suffixe.

Dans les exemples ci-après, le nom de procédure WEBSRV1 est utilisé. Modifiez la nouvelle procédure cataloguée en remplaçant /path/to/IHS/runtime/répertoire par le répertoire d'installation effectif de cette instance d'IBM HTTP Server. Créez un profil SAF STARTED pour associer l'ID utilisateur du serveur et le groupe à la tâche démarrée du serveur Web :
RDEFINE STARTED WEBSRV1.* STDATA(USER(WWWSERV) GROUP(WWWGROUP) TRACE(YES))
SETROPTS RACLIST(STARTED) GENERIC(STARTED) REFRESH
  • Pour démarrer le serveur depuis la console système MVS, entrez :
    S WEBSRV1
    Remarque : Le nom de travail du serveur Web peut être modifié en ajoutant jobname à la commande de démarrage, par exemple :
    S WEBSRV1,JOBNAME=HTTPDWS1
    Méthode recommandée 1 : Utilisez un nom de travail composé de 8 caractères. Utiliser un nom de travail composé de huit caractères garantit que tous les processus créés pour cette instance du serveur Web porteront le même nom de travail.
    Pour arrêter le serveur, entrez :
    P WEBSRV1
    Remarque : Si vous utilisez SDSF, vous devez passer par l'écran d'extension de commande système (saisie de commande) pour entrer la commande en vue d'arrêter le serveur.
    • A l'invite de commande, tapez une barre oblique (/) et appuyez sur Entrée pour accéder à la fenêtre d'extension de commande système.
    • Dans cette fenêtre, entrez la commande S WEBSRV1,ACTION='stop'. Veillez à bien taper stop en minuscules.
  • Pour exécuter d'autres commandes apachectl, tapez :
    S WEBSRV1,ACTION='<commande>'
  • Pour redémarrer le serveur, entrez :
    S WEBSRV1,ACTION=restart
    Vous pouvez redémarrer le serveur à partir de la console z/OS.
  • Pour un redémarrage automatique du serveur, entrez :
    S WEBSRV1,ACTION=graceful
    Vous pouvez redémarrer automatiquement le serveur à partir de la console z/OS.

Les fichiers de sortie des commandes de démarrage et d'arrêt se trouvent dans les fichiers spécifiés dans les instructions JCL DD STDOUT et STDERR de la procédure.

Utilisation du module zos_cmds : Si le module zos_cmds est actif, vous pouvez utiliser les commandes de console z/OS STOP et MODIFY.
Important : Dans le fichier httpd.conf, la ligne suivante doit être ajoutée pour activer le module zos_cmds :
LoadModule zos_cmds_module modules/mod_zos_cmds.so 
Remarque : Si vous n'utilisez pas un nom de travail de huit caractères cohérent pour tous les processus, vous devez déterminer le nom de travail du processus qui gère les commandes de l'opérateur z/OS dans l'instance du serveur Web. Lorsque le serveur Web est démarré, il envoie un message à la console opérateur qui identifie le travail associé à la gestion des commandes de l'opérateur.
BPXM023I (WASTST1) IHS is active. Use jobname HTTPDWS1 for MVS commands.
WASTST1 est l'ID utilisateur sous lequel le serveur Web est exécuté. Une entrée identifiant également le nom de travail est écrite dans le journal des erreurs. Notez que le nom de travail du démon mod_zos_cmds est HTTPDWS1. Lorsqu'une commande MODIFY est saisie, elle s'applique à chaque travail portant le nom de travail spécifié. Seul l'un des processus de serveur Web accepte la commande. Le système émet le message suivant pour chacun des autres travaux du même nom de travail :
IEE342I MODIFY   REJECTED-TASK BUSY
  • Pour arrêter le serveur à l'aide de la commande stop :
    P HTTPDWS1
  • Pour redémarrer le serveur à l'aide de la commande de modification, entrez :
    F HTTPDWS1,appl='restart'
  • Pour redémarrer le serveur progressivement à l'aide de la commande de modification, entrez :
    F HTTPDWS1,appl='graceful'
Lorsque le serveur Web s'arrête avec le module zos cmds actif, il envoie le message à la console de l'opérateur.
BPXM023I (WASTST1) IHS is stopping
où WASTST1 est l'ID utilisateur sous lequel le serveur Web est exécuté.
Méthode recommandée 2 : Les fichiers de sortie sont remplacés chaque fois que la procédure est utilisée. Ils peuvent contenir des messages d'avertissement relatifs à la configuration ou des messages d'erreur dus à des incidents liés au démarrage. Si vous voulez conserver un journal de ces messages au cours des diverses utilisations de la procédure, modifiez les deux occurrences de l'option PATHOPTS dans l'échantillon de procédure sur PATHOPTS=(OCREAT,OAPPEND,OWRONLY). Pour plus d'informations sur l'option PATHOPTS, voir z/OS MVS JCL Reference (SA22-7597). Ce document est accessible depuis le lien Bibliothèque Internet z/OS.
Méthode recommandée 3 : L'instruction STDENV DD est déconseillée. Vous pouvez envisager d'ajouter des paramètres de variable d'environnement au fichier bin/envvars au sein du répertoire d'exécution afin que les variables soient actives, quel que soit le mode de démarrage d'IBM HTTP Server : langage JCL ou environnement UNIX.
Méthode recommandée 4 : Le paramètre SH de BPXBATCH est recommandé à la place du paramètre PGM. La fonction de traitement pour le paramètre PGM ignore les paramètres par défaut du système dans le fichier /etc/profile. Les autorisations correctes ne sont même pas attribuées pour le paramètre umask et les fichiers créés par IBM HTTP Server.

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=ihs-dist&topic=cihs_startsysconz
Nom du fichier : cihs_startsysconz.html