Procédures cataloguées JCL z/OS

Le serveur WebSphere Application Server for z/OS utilise les procédures cataloguées JCL pour les serveurs d'applications autonomes et les cellules Network Deployment. Prenez connaissance des conventions de dénomination et d'informations sur l'attribution d'ID utilisateur aux espaces adresse WebSphere Application Server for z/OS.

Remarque : Au cours de la personnalisation de WebSphere Application Server sur les systèmes d'exploitation z/OS, l'outil de gestion de profils (z/OS uniquement) ou la commande zpmt.sh crée un travail de personnalisation, BBOxPROC, pour copier les procédures cataloguées vers la bibliothèque des procédures système. Exécutez le travail BBOxPROC pour que le serveur dispose des procédures cataloguées à jour. Si vous exécutez le code WebSphere Application Server for z/OS Version 9.0 avec les procédures cataloguées des versions antérieures, le serveur ne démarre pas.

Chaque serveur WebSphere Application Server for z/OS utilise une procédure cataloguée JCL. Ces procédures sont toutes très similaires et sont constituées d'une procédure cataloguée principale et d'un membre INCLUDE renfermant des instructions DD. Voici quelques exemples de membres de la bibliothèque de procédures cataloguées pour un contrôleur, tel que généré par le gestionnaire de profils ou la commande zpmt :

Membre de la bibliothèque de procédures BBO8ACR :
//BBO8ACR  PROC ENV=,PARMS=' ',REC=N,AMODE=00                   
// SET ROOT='/wasv9config/bbobase/bbonode'                      
// SET FOUT='properties/service/logs/applyPTF.out'              
// SET WSDIR='AppServer'                                        
//************************************************************* 
//* Test that OMVS can successfully launch a shell and return * 
//************************************************************* 
//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)   
//*********************************************************     
//* If the shell RC code is as expected (13) - proceed    *     
//*********************************************************     
//IFTST   IF (RC = 13) THEN                                     
//*********************************************************     
//* Start the Multi-Product PTF Post-Installer            *     
//*********************************************************     
//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                                
//*********************************************************          
//* If the RC from the Post-Installer is LE 4 then start  *          
//* the 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'                      
//*                                                                  
//* Output DDs                                                       
//*                                                                  
//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 
Membre de la bibliothèque de procédures 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'                            
//*                                                                 
//* Output DDs                                                      
//*                                                                 
//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 
La procédure cataloguée indique l'endroit où la procédure est traitée :
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbooctlm ...' (contrôleur)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboosrmr ...' (serviteur)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboocram ...' (processus auxiliaire)
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbodmnm ...' (démon de service de localisation)
Le paramètre PARM= de l'instruction EXEC PGM renferme les paramètres qui sont transmis au programme identifié par le paramètre PGM=.
Remarque : L'interface adaptée pour modifier les paramètres de LE (language environment) est le fichier was.env. Toutefois, ne modifiez aucun paramètre LE sans avoir consulté l'équipe d'assistance logicielle IBM® au préalable. Les paramètres LE sont définis en interne afin de garantir les meilleures performances possibles de WebSphere Application Server qui est la principale application LE en cours d'exécution dans l'espace adresse. Si vous devez ajouter ou changer les paramètres LE, assurez-vous de travailler avec le service d'assistance logicielle IBM pour être certain que les paramètres établis en interne ne sont pas compromis.

L'instruction STDENV DD pointe vers le fichier was.env (paramètre de démarrage) du serveur. Le chemin vers ce fichier est constitué du nom de répertoire du système hiérarchique de fichiers de (défini dans le code en utilisant la variable ROOT JCL) et du lien symbolique vers ce serveur particulier, qui est défini au démarrage grâce au paramètre ENV=.

La procédure cataloguée du contrôleur inclut des instructions supplémentaires avant l'instructionEXEC qui invoque BPXBATA2. Ces dernières sont utilisées pour invoquer le programme post-installation qui applique toute opération de maintenance nécessaire au système hiérarchique de fichiers de configuration et à son répertoire de base lorsque le service est appliqué au système hiérarchique de fichiers du produit et aux modules de chargement.

Les sections suivantes décrivent les procédures cataloguées requises pour chaque configuration, fournissent une convention de dénomination recommandée et expliquent comment l'ID utilisateur SAF de chaque serveur est déterminé.

Procédures cataloguées pour les serveurs d'applications autonomes

Un serveur d'applications autonome utilise les procédures cataloguées suivantes :
  • Procédure cataloguée de contrôleur
  • Procédure cataloguée de serviteur
  • Procédure cataloguée de processus auxiliaire
  • Procédure cataloguée de démon de service de localisation

Vous pouvez utiliser les mêmes procédures cataloguées pour différents serveurs autonomes SI le système hiérarchique de fichiers de la configuration et le niveau de code produit (y compris STEPLIB) sont identiques pour les deux serveurs.

Procédures cataloguées pour les cellules de déploiement réseau

Une cellule Network Deployment comprend procédures cataloguées suivantes :

Pour le gestionnaire de déploiement :
  • Procédure cataloguée du contrôleur du gestionnaire de déploiement
  • Procédure cataloguée du serviteur du gestionnaire de déploiement
Pour chaque noeud de serveur d'applications :
  • Procédure cataloguée du contrôleur de serveur d'applications (également utilisée pour l'agent de noeud)
  • Procédure cataloguée du serviteur du serveur d'applications
  • Procédure cataloguée de processus auxiliaire
Pour le démon de service de localisation (un par système z/OS) :
  • Procédure cataloguée de démon de service de localisation

La procédure cataloguée du serviteur du serveur d'applications est la seule qui est susceptible de nécessiter des modifications, afin de placer les bibliothèques CICS, DB2, etc) dans la concaténation STEPLIB.

Vous pouvez utiliser les mêmes procédures cataloguées pour différents noeuds dans une cellule Network Deployment, ou même dans plusieurs cellules, si le système HFS de la configuration est le même pour tous.

Une convention de dénomination de procédure cataloguée recommandée

Utilisez une convention de dénomination cohérente pour vos procédures cataloguées WebSphere Application Server for z/OS. Le nom de procédure doit faire la distinction entre la version de WebSphere Application Server for z/OS et le système HFS.

La convention suivante fonctionne tant pour un serveur d'applications que pour une cellule Network Deployment, où cc est un identificateur de cellule à deux caractères :
Procédure Nom recommandé
Contrôleur du gestionnaire de déploiement cc8DCR
Serviteur de gestionnaire de déploiement cc8DSR
Contrôleur du démon de service de localisation cc8DMN
Contrôleur du serveur d'applications cc8ACR
Serviteur de serveur d'applications cc8ASR
Auxiliaire à la région de contrôle cc8AAR
Si vous avez besoin de procédures cataloguées distinctes pour les noeuds de différents systèmes d'un sysplex (s'ils exigent des instructions STEPLIB réglables indépendamment pour permettre un redémarrage non perturbateur, par exemple), placez le démon de service de localisation et les procédures du serveur d'applications dans les proclibs spécifiques au système, ou ajoutez un identificateur système à un caractère aux noms des procédures cataloguées du démon de service de localisation et des serveurs d'applications.

Attribution d'ID utilisateur aux espaces adresse WebSphere Application Server for z/OS

Si vous utilisez z/OS Security Server (fonction de contrôle d'accès aux données) en tant que système de sécurité compatible SAF sur z/OS, les classes STARTED sont alors utilisées pour attribuer les ID utilisateur de tâche démarrée à chaque serveur WebSphere Application Server for z/OS. Ces profils STARTED sont définis par les travaux par lots créés par le gestionnaire de profils ou la commande zpmt. Au besoin, mettez ces profils STARTED à jour pour placer les serveurs que vous avez créés dans les ID utilisateur appropriés.

Les contrôleurs (contrôleur de gestionnaire de déploiement, de démon de service de localisation, d'agent de noeud ou de serveur d'applications) sont démarrés à l'aide de la commande console START que vous envoyez soit à partir de la console MVS, soit en interne. Pour ces serveurs, le nom de profil STARTED qui est vérifié est de type procname.jobname.

Dès qu'il crée un contrôleur ou une procédure cataloguée de démon, le gestionnaire de profils ou la commande zpmt crée également un profil STARTED qui associe tous les contrôleurs en utilisant cette procédure cataloguée avec l'ID utilisateur du contrôleur correspondant et le groupe de configuration. Par conséquent, si vous définissez un serveur d'applications autonome avec les noms par défaut, le gestionnaire de profils ou la commande zpmt créera les profils suivants pour les contrôleurs :
  • RDEFINE STARTED BBO8ACR.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBO8DMN.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Remarque : TRACE(YES) écrit le message IRR812I dans la console MVS dès lors que le profil est utilisé.

Les régions serviteur (serviteurs de serveur d'applications et processus auxiliaires) sont démarrées à l'aide de Workload Manager (WLM). Pour ces serveurs, le nom de profil STARTED qui est vérifié est de type jobname.jobname.

Malheureusement, il n'existe aucun moyen d'affecter tous les serveurs à un ID utilisateur serviteur à l'aide d'une procédure cataloguée de serviteur donnée. Le gestionnaire de profils ou la commande zpmt crée un profil STARTED pour chaque serviteur et un pour chaque région auxiliaire de contrôle. Si des noms par défaut sont choisis, les profils STARTED de serviteur suivants sont créés pour un serveur d'applications autonome :
  • RDEFINE STARTED BBOS001S.* STDATA(USER(WSSRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBOS001A.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
Lorsque vous choisissez des noms de procédures cataloguées, assurez-vous que le profil STARTED approprié est en place pour mapper le serveur vers on ID utilisateur SAF approprié. Utilisez les écrans ISPF RACF ISPF ou la commande RLIST STARTED pour afficher les profils STARTED.

Si vous utilisez un autre système de sécurité compatible SAF, contactez le vendeur du serveur de sécurité pour obtenir des informations au sujet de l'installation de WebSphere Application Server for z/OS.


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=was-nd-zos&topic=cins_plancatzos
Nom du fichier : cins_plancatzos.html