Intruduction à ENDEVOR

Introduction à ENDEVOR
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 1 sur 22
Introduction à ENDEVOR
Sommaire
I Présentation
II Le modèle de fonctionnement
II 1 L’organisation des stages ENDEVOR
II 2 Les circuits de transfert
III Les fonctions ENDEVOR courantes
III 1 La fonction RETRIEVE
III 1 La fonction ADD
III 1 La fonction MOVE
IV La gestion du package
V Synthèse
page 3
page 4
page 4
page 5
page 9
page 9
page 11
page 14
page 18
page 22
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 2 sur 22
Introduction à ENDEVOR
I. Présentation
L’objet de ce document est d’aider toute personne devant utiliser ENDEVOR en tant que développeur.
Il décrit le fonctionnement de base de cet outil ainsi que les fonctions les plus utiles.
ENDEVOR est une application système mainframe sous TSO/ISPF de gestion des environnements. Il
permet de gérer les différentes phases de développement et de maintenir les objets d’une application.
Il permet de passer son objet source, par exemple son programme cobol, de sa bibliothèque utilisateur
vers les tables de load des différents environnements (TEST, INTEGRATION, RECETTE, PROD).
Le document se décompose en 3 chapitres principaux :
•
Le modèle de fonctionnement où sont détaillés l’organisation des stages et des environnements
Endevor, ainsi que les circuits de transfert d’un objet d’un environnement vers un autre.
•
Les fonctions ENDEVOR courantes, ADD, MOVE et RETRIEVE, qui seront détaillées dans ce
chapitre illustré d’exemples écrans.
•
La gestion du Package qui permet de migrer et de distribuer les objets créés vers les tables de
production.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 3 sur 22
Introduction à ENDEVOR
II. Le modèle de fonctionnement
II.1 L’organisation des stages ENDEVOR
ENDEVOR est constitué de 2 environnements dont chacun va contenir 2 stages.
L’environnement peut être défini comme un domaine d’endevor, le stage comme une aire de
développement.
En général un cycle de développement contient 3 ou 4 stages permettant ainsi de couvrir tous les cas de
figure (nouvelle application, gestion des versions, correction de bugs, …)
STAGE1 :Tests
STAGE2 : Intégration
STAGE3 : Recette (Pre-Production)
STAGE4 : Production
Environnement
DEV1STEP
Environnement
DEV2STEP
Stage
DEV1PRD
Stage
USR1PRD
Stage
DEV2PRD
Stage
PROD
Développement
Intégration
Recette
Production
‘1’
‘2’
Stage number
1
2
3
4
Environment
‘3’
Stage Code
DEV1STEP
DEV1STEP
DEV2STEP
DEV2STEP
1
2
3
4
‘4’
Stage
DEV1PRD
USR1PRD
DEV2PRD
PROD
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 4 sur 22
Introduction à ENDEVOR
II.2 Les circuits de transfert
La fonction ADD permet de compiler et de transférer son objet (programme, copy, écran…) de la
bibliothèque utilisateur à l’environnement de test.
SOURCES
SOURCES
ADD
Bib utilisateur
TEST
INTEG
RECETTE
PROD
LOAD
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 5 sur 22
Introduction à ENDEVOR
La fonction MOVE permet de transférer l’objet de la bibliothèque de test vers la bibliothèque d’intégration.
SOURCES
SOURCES
MOVE
Bib utilisateur
TEST
INTEG
RECETTE
PROD
LOAD
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 6 sur 22
Introduction à ENDEVOR
Le MOVE PACKAGE permet de passer son objet (et autres objets liés) en environnement de RECETTE.
Suivant la configuration client, il peut être nécessaire dès ce niveau de faire un SHIPMENT PACKAGE, ce
qui consiste à distribuer le package dans le domaine concerné (mise a jour des tables et fichiers).
SOURCES
SOURCES
MOVE
PACKAGE
E
Bib utilisateur
TEST
INTEG
RECETTE
PROD
LOAD
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 7 sur 22
Introduction à ENDEVOR
La montée en PROD nécessite obligatoirement de faire un SHIPMENT PACKAGE, ce qui correspond à la
distribution des objets dans les tables de production.
SOURCES
PROD
SOURCES
Distribution
PACKAGE
Bib utilisateur
TEST
INTEG
RECETTE
Installation
SHIPMENT
PACKAGE
LOAD
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 8 sur 22
Introduction à ENDEVOR
III. Les fonctions ENDEVOR courantes
Menu principal ENDEVOR
Ce menu est lancé à partir de l’écran TSO, il suffit d’entrer ‘E’ sur la ligne de commande.
----------------- ENDEVOR
OPTION ===>
0
1
2
3
4
U
T
C
DEFAULTS
DISPLAY
FOREGROUND
BATCH
PACKAGE
USER MENU
TUTORIAL
CHANGES
-
PRIMARY OPTION MENU ----------------------------------
Specify
Perform
Execute
Perform
Perform
Display
Display
Display
Endevor ISPF default parameters
Display functions
Foreground Actions
Batch Action processing
Foreground Package processing
user option menu
information about Endevor
summary of changes for this release of Endevor
III. 1 La fonction RETRIEVE
Cette fonction permet de récupérer dans sa bibliothèque utilisateur un objet déjà existant dans un Stage
pour modifier son code source.
Sur le menu général ENDEVOR < Primary option Menu >, il faut sélectionner l’option 2 FOREGROUND
Sur le menu < Foreground Options Menu >, il faut sélectionner l’option 2 RETRIEVE
L’écran suivant permet de spécifier les détails de récupération de l’objet.
Dans la ligne option il faut taper ‘R’ mais je préfère laisser la zone à blanc et travailler directement sur la
liste des éléments retournés.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 9 sur 22
Introduction à ENDEVOR
On doit saisir le nom de l’objet recherché sur cet écran dans la zone < ELEMENT >. Les informations
ENVIRONMENT/SYSTEM/SUBSYSTEM/TYPE/STAGE doivent être saisies également. Une fois saisies
elles seront affichées par défaut à chaque fois qu’on reviendra sur l’écran.
EXPAND INCLUDES à ‘Y’ permet de rechercher les éléments y compris dans les autres stages que celui
spécifié.
SIGNOUT ELEMENT à "Y" permet de marquer l’élément comme attaché à l’utilisateur.
OVERRIDE SIGNOUT à ‘Y’ permet de récupérer l’élément dans sa bibliothèque même s’il est déjà utilisé
par un autre développeur. Par défaut et dans la pratique, on laisse la valeur à ‘Y’ si on est sur un nouveau
projet, dans le cas contraire la sécurité prévaut de le laisser à ‘N’ pour voir quels autres utilisateurs
potentiels travaillent déjà sur l’élément en question, ceci pour éviter des problèmes de version d’objet.
REPLACE MEMBER à ‘Y’ si l’objet existe déjà dans la bibliothèque source de l’utilisateur.
DISPLAY LIST à ‘Y’ par défaut permet de récupérer la liste des éléments trouvés.
TO LIBRARY spécifie la bibliothèque utilisateur qui doit récupérer l’élément.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 10 sur 22
Introduction à ENDEVOR
La liste des éléments ramenés par le RETRIEVE permet de récupérer directement celui qui nous intéresse
en tapant ‘R’ devant l’élément.
Le résultat d’exécution de la commande apparaît immédiatement à l’écran, indiquant si l’opération s’est
bien déroulée ou s’il y a un élément bloquant.
III.2 La fonction ADD
Cette fonction permet de compiler l’objet source et de le transférer dans l’environnement de Test.
L’usage courant que je détaille ici veut que cette opération soit lancée par un batch, bien qu’il soit possible
la faire en direct.
Sur le menu général ENDEVOR <Primary option Menu >, il faut sélectionner l’option 3 BATCH
Sur le menu < Batch Options Menu >, il faut sélectionner l’option 1 BUILD SCL
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 11 sur 22
Introduction à ENDEVOR
L’écran suivant permet de spécifier les détails de construction du Batch qui sera créé dans un membre PDS
(Partitioned Data Set).
Vous devez saisir la section JOB STATEMENT INFORMATION, cela se fait la première fois elle
réapparaît ensuite automatiquement.
La validation de l’écran appelle l’écran < SCL generation >
Dans l’exemple ci-dessous le développeur veut faire un Retrieve de type Batch en sélectionnant l’option 3.
Dans notre cas la manipulation est totalement identique si ce n’est qu’on sélectionne l’option 2 pour créer
notre ADD.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 12 sur 22
Introduction à ENDEVOR
Après sélection de cet écran, L’écran < ADD/UPDATE elements > apparaît :
Il n’est pas nécessaire de taper ‘A’ dans la ligne OPTION, on va récupérer ainsi la liste de tous les objets.
Il faut saisir le nom de l’objet dans ELEMENT.
OVERRIDE SIGNOUT à ‘Y’ permet de récupérer l’élément dans sa bibliothèque même s’il est déjà utilisé
par un autre développeur.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 13 sur 22
Introduction à ENDEVOR
L’écran suivant permet de faire le ADD sur l’élément qu’on veut sélectionner. Ici l’exemple concerne un
RETRIEVE, dans notre cas il faut taper ‘A’ devant le ou les éléments qui nous intéressent, et non pas ‘R’.
Après avoir fait ENTREE les éléments sélectionnés seront marqués ‘WRITTEN’.
Vous devez alors activer PF3 pour retourner sur le menu BATCH OPTIONS MENU.
Vous pouvez alors lancer le batch par l’option 3 SUBMIT.
Pour les compilations suivantes pour d’autres éléments vous avez aussi la possibilité de faire un EDIT sur le
membre que vous venez de créer, qu’on peut appeler ADD par exemple, il vous suffira de modifier le nom
de l’élément, de taper SAVE dans la ligne d’option, de ressortir et de soumettre par l’option 3.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 14 sur 22
Introduction à ENDEVOR
Ce membre que vous venez de créer est donc réutilisable.
III. 3 La fonction MOVE.
Cette fonction permet de transférer l’objet compilé d’un environnement vers un autre.
Cette option est disponible à partir de l’environnement d’INTEGRATION.
L’usage courant que je détaille ici veut que cette opération soit lancée par un batch, bien qu’il soit possible
la faire en direct.
Je détaille ici la procédure bien qu’elle soit similaire à la fonction ADD excepté pour l’option de
récupération de l’élément.
Sur le menu général ENDEVOR < Primary option Menu >, il faut sélectionner l’option 3 BATCH
Sur le menu < Batch Options Menu >, il faut sélectionner l’option 1 BUILD SCL
L’écran suivant permet de spécifier les détails de construction du Batch qui sera créé dans un membre PDS
(Partitioned Data Set).
Vous devez saisir la section JOB STATEMENT INFORMATION, cela se fait la première fois, elle
réapparaît ensuite automatiquement.
La validation de l’écran appelle l’écran < SCL generation >.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 15 sur 22
Introduction à ENDEVOR
Dans l’exemple ci-dessous le développeur veut faire un Retrieve de type Batch en sélectionnant l’option 3.
Dans notre cas la manipulation est totalement identique si ce n’est qu’on sélectionne l’option 5 pour créer
notre MOVE.
L’écran < MOVE elements > apparaît :
Il n’est pas nécessaire de taper ‘O’ dans la ligne OPTION, on va récupérer ainsi la liste de tous les objets.
Il faut saisir le nom de l’objet dans ELEMENT.
Cet écran permet de faire le MOVE sur l’élément qu’on veut sélectionner. Ici il faut taper ‘O’ devant le ou
les éléments qui nous intéressent.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 16 sur 22
Introduction à ENDEVOR
Après avoir fait ENTREE les éléments sélectionnés seront marqués ‘WRITTEN’.
Vous devez alors activer PF3 pour retourner sur le menu BATCH OPTIONS MENU.
Vous pouvez alors lancer le batch par l’option 3 SUBMIT.
Pour les compilations suivantes de nouveaux objets, vous avez aussi la possibilité de faire un EDIT sur le
membre que vous venez de créer, appelé MOVE par exemple, il vous suffira de modifier le nom de
l’élément, de taper SAVE dans la ligne d’option, de ressortir et de soumettre par l’option 3.
Ce membre que vous venez de créer est donc réutilisable.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 17 sur 22
Introduction à ENDEVOR
IV. La gestion du PACKAGE
Le package correspond a une ‘capsule’ qui va contenir tous les éléments à monter en environnement de recette
ou de production.
Il est constitué d’une première étape de CREATION de cette ‘capsule’, d’une étape de MOVE des éléments à
monter, d’une étape appelé CAST qui permet de valider les composants, d’une étape EXECUTE qui rend
effective la mise a jour des bibliothèques du stage Recette (ou Production).
L’étape finale est le SHIPMENT qui consiste à distribuer vers les tables de production.
Sur le menu général ENDEVOR < Primary option Menu >, il faut sélectionner l’option 4 PACKAGE.
Sur le menu < Package Options Menu >, il faut sélectionner l’option 2 CREATE/MODIFY.
Il faut saisir ‘B’ sur la ligne OPTION et indiquer le nom du package au niveau du PACKAGE ID.
La codification du nom est normé dans chaque entreprise il faut donc suivre la règle de codification exigée.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 18 sur 22
Introduction à ENDEVOR
Les autres rubriques peuvent rester avec les valeurs par défaut sauf besoin particulier :
SHARABLE PACKAGE à ‘Y’ si on veut permet qu’une autre personne puisse exécuter le package.
EXECUTION WINDOW si on veut exécuter la package à un moment précis.
La validation de l’écran par <ENTER> provoque l’affichage du < SCL Generation screen > :
L’option 5 MOVE doit être sélectionnée, dans l’exemple les éléments seront déplacés du stage 2 au stage 3.
Sélectionner par ‘O’ les éléments que vous voulez déplacer.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 19 sur 22
Introduction à ENDEVOR
Cet écran indique par WRITTEN que le ou les éléments ont bien été sélectionnés.
L’opération suivante consiste à faire un CAST sur le PACKAGE ce qui permet de valider tous les éléments.
Dans de nombreuses entreprises le CAST génère automatiquement l’approbation pour le développeur, ceci
dit il peut rester des endroits ou l’opération manuelle s’avère être nécessaire car sécurisé, seul un utilisateur
autorisé peut la faire.
Dans ce cas une approbation manuelle est nécessaire par l’option ‘A’.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 20 sur 22
Introduction à ENDEVOR
L’opération suivante consiste à exécuter le package en saisissant ‘E’ dans OPTION:
Le DISPLAY (option 1) du menu < Package Options Menu > permet de vérifier la bonne exécution du
traitement.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 21 sur 22
Introduction à ENDEVOR
L’option 6 permet d’effectuer le SHIPMENT PACKAGE.
V. Synthèse
Nous avons vu que les fonctions courantes d’ENDEVOR sont facilement assimilables, les ADD et MOVE
sont utilisés principalement en lançant un batch ‘type’ réutilisable à partir d’un membre PDS qu’on créé une
seule fois.
La gestion du Package est différente selon le niveau de sécurité de l’entreprise, la plupart des clients
n’autorisent pas l’exécution du package et du shipment vers le stage production, seule une personne habilitée,
un responsable en général, est autorisé à effectuer ces opérations.
Rédacteur : Olivier Grymann
© Copyright 2011 - tous droits réservés à UTiGROUP.
Page 22 sur 22

Download Report