Configuration de la passerelle ISPF pour prise en charge de génération, de déploiement et de promotion

Vous pouvez configurer la passerelle ISPF pour la prise en charge des composants de génération, de déploiement et de promotion disponibles avec une licence d'accès client Developer pour IBM® Enterprise Platforms.

ISPF fournit une interface, dénommée passerelle ISPF, permettant aux applications client de se connecter à un hôte z/OS et d'exécuter des commandes TSO et ISPF. Cette interface est installée avec l'utilitaire ISPF sous forme de fichiers et de modules de chargement dans le système hiérarchique de fichiers. En général, ces fichiers sont installés dans /usr/lpp/ispf/bin. Les composants de génération, déploiement et promotion sont installés au cours de l'installation SMP/E. Selon votre configuration, des modifications supplémentaires des scripts et des composants fournis par la passerelle ISPF peuvent être requises. Les paramètres par défaut et leur procédure de modification sont décrits plus loin.

Les composants suivants sont inclus :

Fichier d'environnement de la passerelle ISPF : ISPZXENV
Fichier d'environnement de la passerelle ISPF contenant des paramètres personnalisables pour la passerelle ISPF.
Le fichier ISPZXENV est mis à disposition avec z/OS. Par défaut, ce fichier est installé dans /usr/lpp/ispf/bin. Toutefois, ce répertoire est généralement accessible en lecture seule après l'installation. Ce fichier d'environnement est exécuté par la passerelle ISPF pour obtenir la valeur de certaines variables d'environnement nécessaires à son exécution. Par défaut, il s'agit des variables suivantes :
STEPLIB
Définie par défaut à STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD'
CGI_ISPCONF
Définie par défaut à CGI_ISPCONF = '/etc/ispf'
CGI_ISPWORK
Définie par défaut à CGI_ISPWORK = '/var/ispf'

Pour associer les variables à des valeurs autres que les valeurs par défaut, copiez ISPZXENV dans un répertoire de configuration accessible en écriture, tel que /etc/ispf et définissez les variables avec les valeurs de votre choix. Vous devez ensuite modifier votre variable d'environnement PATH dans le fichier startispf.sh, décrit plus loin, pour que cet emplacement soit lu avant le chemin d'accès au répertoire bin par défaut de l'utilitaire ISPF.

Par exemple :
export PATH=/etc/ispf:$PATH  

Dans le répertoire de travail de la passerelle ISPF, par défaut /var/ispf, vous devez disposer d'un répertoire existant intitulé WORKAREA, sur lequel des droits d'accès en lecture et écriture ont été accordés à tous les utilisateurs. Des répertoires temporaires suivant le format /var/ispf/WORKAREA/<ID_utilisateur>/* sont créés lorsque la passerelle ISPF est utilisée. Si vous utilisez l'installation de passerelle ISPF par défaut fournie par ISPF, ce répertoire est généralement dans /var/ispf/WORKAREA. Si ce répertoire n'existe pas, suivez les instructions du chapitre (en anglais), Installing and customizing the gateway dans le manuel ISPF Planning and Customizing (GC34-4814).

Script de démarrage de la passerelle ISPF : startispf.sh
Script de shell de démarrage de la passerelle ISPF pour déploiement et promotion.
Pour démarrer la passerelle ISPF, Rational Team Concert met à disposition un script de shell appelé à partir des tâches Ant de déploiement et de promotion. Ce script est installé dans le répertoire /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway. Dans le cadre d'une personnalisation standard, ce script est copié vers le répertoire de configuration de Rational Team Concert, généralement /etc/jazz40/ccm par le travail BLZCPBTK. Selon votre configuration, il se peut que vous deviez modifier ce script de shell pour définir certaines variables d'environnement.
PATH
La variable PATH doit désigner le répertoire de base de la passerelle ISPF :
export PATH=$PATH:/usr/lpp/ispf/bin             
Si vous avez modifié ISPZXENV, il peut être nécessaire d'associer la variable PATH à :
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

Si vous devez utiliser des concaténations de bibliothèque différentes dansISPF.conf, configurez votre installation pour prendre en charge plusieurs projets et flux en créant plusieurs copies du script startispf.sh, et des fichiers ISPF.conf et ISPZXENV. Dans chaque copie du fichier ISPZXENV, définissez la variable CGI_ISPFCONF pour pointer vers l'emplacement du fichier associé ISPF.conf. Puis, dans chaque copie du script startispf.sh, définissez la variable PATH pour pointer vers la copie appropriée du ISPF.conf. Utilisez ensuite le script startispf.sh qui correspond à l'environnement nécessaire à un projet particulier.

Script de démarrage de génération Enterprise Extensions : startbfa.sh
Script de shell de démarrage de Rational Build Agent à l'aide d'une génération Enterprise Extensions.
Les générations Enterprise Extensions fournissent un mécanisme pour démarrer une génération qui démarre à son tour un programme ; une commande ISPF ou un fichier exécutable ; ou bien une commande TSO ou un fichier exécutable. Si l'objet démarré par la génération est une bibliothèque allouée par IPSF, vous devez configurer la génération afin qu'elle permette un accès à l'objet requis. Dans startbfa.sh, vous devez répertorier l'emplacement des fichiers fournis par ISPF afin que Rational Build Agent puisse démarrer la passerelle ISPF. Par défaut, ces fichiers sont situés sous /usr/lpp/ispf et sont spécifiés dans startbfa.sh à l'aide de la variable _CMDSERV_BASE_HOME. Si les fichiers binaires de la passerelle ISPF résident dans un autre emplacement, vous devez modifier cette variable. Par exemple :
#                                                  
# Spécifiez le répertoire principal des programmes ISPF.
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

Les programmes et fichiers exécutables ISPF doivent être alloués dans le fichier de configuration de la passerelle ISPF (ISPF.conf) comme décrit plus loin. Rational Build Agent requiert également un accès à ISPF.conf. L'accès est défini dans le fichier d'environnement de la passerelle ISPF (ISPZXENV). Si vous compter utiliser les fonctionnalités ISPF dans les générations et que vous n'utilisez pas l'emplacement par défaut /usr/lpp/ispf/bin, vous devez créer une copie de ISPZXENV sous un répertoire de configuration accessible en écriture et diriger Rational Build Agent vers cet emplacement. Définissez la propriété de génération teamz.build.ant.myISPFBinPath d'après l'emplacement du répertoire contenant le fichier ISPZXENV. Vous pouvez ajouter cette propriété ou modifier sa valeur depuis l'onglet Propriétés dans votre définition de génération. Pour plus d'informations, voir Managing z/OS builds

Fichier de configuration de la passerelle ISPF : ISPF.conf
Fichier de configuration de la passerelle ISPF contenant des paramètres personnalisables pour la passerelle ISPF.
Le fichier ISPF.conf est mis à disposition avec z/OS. Le fichier de configuration de la passerelle ISPF fournit les allocations requises pour démarrer une session ISPF dans une tâche créée. Pour permettre aux fonctions de génération, déploiement et promotion de démarrer des packages afin d'exécuter des tâches spécifiques, ces packages doivent être disponibles dans les concaténations ISPF. Par défaut, ces allocations sont configurées comme suit :
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
Pour que le déploiement et la promotion fonctionnent, ajoutez la bibliothèque de chargement du produit Rational Team Concert (hlq.SBLZLOAD) et la bibliothèque de messages du produit (hlq.SBLZMENU) à la concaténation ISPLLIB et ISPMLIB. Les allocations modifiées ressemblent à cet exemple :
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Exécution de modules de déploiement interprétatifs

Si vous désirez ajouter vos propres processus de déploiement ou vos propres fonctions, vous pouvez exécuter des versions interprétatives des modules de déploiement. Le modulede déploiement exécute les programmes suivants :
Tableau 1. Programmes exécutés par le composant de déploiement
Programme Fonction Description
BLZPKGZP Assemblage du déploiement A l'aide du fichier manifeste, créez un fichier .zip avec le contenu spécifié.
BLZBKPZP Sauvegarde du déploiement A l'aide du fichier de package, effectuez des copies de sauvegarde des modules que le déploiement écrase.
BLZDEPZP déploiement A l'aide du fichier de manifeste de déploiement, déployez le contenu du fichier .zip spécifié.
Les tâches de déploiement de Rational Team Concert appellent ces programmes afin d'exécuter la fonction décrite. Si vous désirez modifier ces programmes, vous pouvez modifier les exemples fournis dans la bibliothèque hlq.SBLZSAMP, puis pointer dans ISPF.conf vers la version modifiée. Si vous avez appliqué les modifications directement dans hlq.SBLZSAMP, vos allocations ISPF.conf devraient être similaires à l'exemple suivant :
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
ISPF vérifie d'abord la concaténation ISPLLIB, sauf si la commande comporte en préfixe le signe de pourcentage % ; par conséquent, vous devez supprimer ou renommer les packages que vous avez modifiés dans le fichier hlq.SBLZLOAD.

Ajout de vos propres bibliothèques EXEC au fichier de configuration de la passerelle ISPF

Pour les générations Enterprise Extensions, si vous utilisez la méthode d'appel ISPF, vous devez également ajouter votre propre bibliothèque EXEC aux concaténations SYSEXEC ou SYSPROC dans le fichier ISPF.conf. Si vous avez spécifié un nom EXEC ou une commande SELECT CMD(exec), ISPF requiert un accès à l'EXEC requis dans la concaténation appropriée. Vous devez modifier le fichier ISPF.conf afin d'inclure toutes les bibliothèques EXEC requises. Par exemple ainsi :
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Pour plus d'informations sur la passerelle ISPF, consultez le chapitre (en anglais) intitulé TSO/ISPF client gateway in ISPF Planning and Customizing dans le manuel ISPF Planning and Customizing (GC34-4814).

Identification et résolution des incidents liés à la configuration de la passerelle ISPF

Vérifiez que la passerelle ISPF est correctement configurée. Les ID utilisateur qui exécutent des fonctions de serveur Rational Team Concert utilisant la passerelle ISPF doivent détenir les droit d'accès requis qui sont décrits dans le manuel ISPF Planning and Customizing (GC34-4814) à l'adresse http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf.

Le script Rational Team Concert startispf.sh utilise des commandes de services du système UNIX qui requièrent l'accès au répertoire /tmp. L'ID utilisateur de génération qui démarre le script startispf.sh doit avoir accès au répertoire /tmp. Vous pouvez redéfinir l'utilisation de /tmp comme répertoire temporaire en ajoutant la ligne suivante à /etc/jazz40/ccm/startispf.sh :
export TMPDIR=/votreRépTemporaire
où votreRépTemporaire est un répertoire avec accès en écriture pour les utilisateurs de génération.

Commentaires