Ce tutoriel présente certaines fonctionnalités de Rational Developer for System z dans le cadre de l'exécution d'une application COBOL sur un système distant. Il explique comment affecter un fichier partitionné, créer un projet z/OS, créer un code exécutable à partir d'une source
COBOL, exécuter une application sur le système distant et déboguer une application sur le
système distant.
Avant de commencer
Avant de commencer ce tutoriel, vérifiez que l'administrateur système
z/OS a configuré et démarré le serveur de construction
z/OS et le serveur de l'Explorateur de systèmes distants. Consultez le
Guide de configuration de l'hôte du CD 1 d'installation pour
plus d'informations sur l'installation et la configuration de ces composants obligatoires.
Procédure
- Accédez à la perspective Projets z/OS :
- Dans le plan de travail, sélectionnez Fenêtre > Ouvrir la perspective > Autre. L'assistant Sélection de la perspective s'affiche.
- Cliquez sur Projets z/OS.
- Cliquez sur OK. La perspective Projets z/OS s'affiche.
- Créez une connexion à un système distant :
- Dans la vue Systèmes distants, développez Nouvelle connexion et
sélectionnez z/OS.
- Cliquez avec le bouton droit de la souris et choisissez Nouvelle connexion. La fenêtre Nouvelle connexion s'ouvre.
- Sélectionnez un nom de profil dans la liste déroulante.
- Entrez les valeurs suivantes dans les zones de cette fenêtre.
- Nom de l'hôte
- Entrez l'adresse TCP/IP du système auquel vous vous connectez.
- Nom de la connexion
- Entrez le nom abrégé que vous souhaitez attribuer au système. Exemple : MONSYSTEME.
- Description
- Saisissez la description de votre choix.
- Vérifier le nom d'hôte
- Sélectionnez cette case à cocher pour vérifier la validité du nom d'hôte avant la tentative
de connexion.
- Pour définir la connexion en utilisant les valeurs par défaut des sous-systèmes Fichiers
MVS, Fichiers z/OS UNIX et Shells z/OS UNIX, cliquez sur
Terminer. Pour définir les propriétés pour ces sous-systèmes, cliquez sur Suivant. L'assistant ouvre une fenêtre de propriétés pour chaque sous-système.
Ces pages affichent les propriétés des services sous-jacents utilisées par chaque sous-système.
- Sur la page Fichiers MVS, vous pouvez sélectionner l'un des programmes de lancement
de serveur suivants. Si vous ne savez pas quelle option choisir, contactez votre administrateur système.
- Démon disant : Établit une connexion en utilisant le démon distant pour démarrer
le serveur. Pour utiliser cette option, le démon distant doit être exécuté sur le système distant. Si vous
choisissez cette option, précisez les options supplémentaires suivantes :
- Port du serveur : indiquez un numéro de port valide.
- Méthode d'authentification : choisissez une méthode
d'authentification avec le système distant. Sélectionnez ID utilisateur/Mot de passe
si vous vous connectez au système distant à l'aide d'un ID utilisateur et d'un mot de passe. Sélectionnez
certificat si vous utilisez l'authentification par certificat client. L'authentification par certificat client est destinée aux utilisateurs qui doivent se connecter à un système distant à l'aide d'un périphérique tel qu'une carte à circuit intégré (comme une carte à puce). Pour plus d'informations, voir
Création d'une connexion à l'aide de l'authentification par certificat client
Si vous choisissez cette option, vous devez
démarrer le démon du serveur à l'aide d'un ID utilisateur doté des privilèges appropriés.
- REXEC : Établit une connexion en utilisant le service REXEC pour démarrer
le serveur. Pour utiliser cette option, le service REXEC doit être exécuté sur le système distant. Si vous
choisissez cette option, précisez les options supplémentaires suivantes :
- Chemin d'accès au serveur installé sur l'hôte : spécifiez une commande de chemin
d'accès valide indiquant l'emplacement du serveur sur le système distant. Vous pouvez spécifier un chemin relatif au répertoire dans lequel vous exécutez la commande REXEC, ou le chemin d'accès complet de l'emplacement dans lequel est installé le serveur. Par exemple,
dstore ou /usr/bin/dstore.
- Commande Lancer le serveur : pour zSeries,
la commande est server.zseries.
- Port : spécifiez un numéro de port valide.
- Détecter automatiquement SSL : détecte automatiquement si SSL fonctionne sur le
serveur et si la connexion utilise SSL.
- Utiliser SSL pour les communications réseau : permet d'assurer la connexion à
l'aide de SSL.
- Se connecter au serveur en cours d'exécution : Établit une connexion à un
serveur qui fonctionne déjà sur un port connu.
Pour utiliser cette option, le serveur doit être démarré pour pouvoir définir une connexion dans l'Explorateur de systèmes distants. Vous devez définir le port dans la page des propriétés du sous-système avant de vous connecter au serveur. Si vous choisissez cette option, vous devez également spécifier l'option
Utiliser SSL pour les communications réseau, qui permet d'assurer la connexion à
l'aide de SSL
- SSH : Etablit une connexion à l'aide de la fonction d'interpréteur de commandes sécurisé. Pour utiliser cette option, le service SSH doit être en cours de fonctionnement sur le système distant. Si vous choisissez cette option, spécifiez une commande de chemin d'accès valide indiquant où le serveur est installé sur le système distant. Vous devez également
spécifier une commande de lancement de serveur. Pour zSeries, la commande est server.zseries. Sélectionnez
Authentification de mot de passe si vous vous connectez au serveur à l'aide d'un mot
de passe ou l'authentification par clé si vous vous connectez à l'aide d'une paire
de clés privée/publique pour vous authentifier auprès du serveur.
Si vous choisissez l'authentification par clé et que la paire de clés n'existe pas, la paire de clés nécessaire est automatiquement générée et échangée avec le serveur SSH distant en prévision des demandes ultérieures. Pour activer cet échange, vous êtes invité à transmettre un mot de passe au système distant. Toute demande ultérieure auprès du système distant par SSH via une authentification par clé ne nécessitera pas de mot de passe.
- Cliquez sur Terminer. La vue Systèmes distants affiche le nom abrégé de la nouvelle connexion
ainsi que cinq noeuds sous le nom de la connexion :
- Fichiers z/OS UNIX est le sous-système de fichiers
z/OS UNIX. Ce noeud
contient deux dossiers : Mon dossier personnel et Racine. Vous pouvez créer d'autres dossiers de fichiers z/OS UNIX en ajoutant de nouveaux filtres à ce noeud.
- Interpréteurs de commandes z/OS UNIX désigne un
sous-système de commandes.
Lorsque vous ouvrez un shell de commandes z/OS
UNIX, son nom apparaît sous ce noeud.
- Fichiers MVS désigne le sous-système de fichiers MVS. Ce noeud contient trois dossiers : Mes fichiers affiche les fichiers MVS qui correspondent au filtre idutilisateur.* dans lequel idutilisateur est l'ID utilisateur avec lequel vous vous êtes connecté au système distant. Vous pouvez créer d'autres dossiers de fichiers MVS en ajoutant de nouveaux filtres à ce noeud. Vous pouvez modifier l'ordre de tri des fichiers à l'aide de la page de préférences Fichiers MVS. Fichiers extraits affiche les noms de fichiers recherchés et ajoutés à l'aide de l'action Extraire un fichier. Mes requêtes de recherche affiche les requêtes de recherche que vous avez effectuées et enregistrées dans la vue Recherche z/OS distante.
- Commandes TSO désigne un sous-système de commandes. Lorsque vous ouvrez un shell de commandes TSO, son nom apparaît sous ce noeud.
- JES désigne le sous-système JES. Ce noeud contient deux dossiers : Mes travaux affiche les travaux soumis sous l'ID d'utilisateur avec lequel vous vous êtes connecté au système distant. Vous pouvez créer des dossiers de travaux supplémentaires en ajoutant de nouveaux filtres à ce noeud. Retrieved Jobs affiche les travaux recherchés et ajoutés à l'aide de l'action Récupérer le travail.
- Connectez-vous au système distant :
- Sélectionnez la connexion au système distant dans la vue
Systèmes distants et cliquez sur Se connecter.
- Dans la fenêtre de saisie du mot de passe, entrez votre ID utilisateur
et votre mot de passe puis cliquez sur OK.
- Attribuez des fichiers partitionnés sur le système distant. Suivez la procédure décrite sous la liste de noms de fichier pour attribuer
chaque fichier partitionné en utilisant ces caractéristiques. Pour les noms de fichier
partitionné, <HLQ> est l'ID utilisateur employé pour la connexion
au système distant :
Tableau 1. | Nom du fichier |
Catégorie |
Type |
| <HLQ>.REMOTE.COBOL |
SOURCE |
COBOL |
| <HLQ>.COBOL.OUTPUT* |
LISTING |
COBOL |
| <HLQ>.COBOL.SYSDEBUG* |
LISTING |
COBOL |
| <HLQ>.COBOBJS.OBJ* |
SOURCE |
COBOL |
| <HLQ>.COBOL.COPYLIB* |
SOURCE |
COBOL |
Remarque : Les fichiers marqués avec le caractère * sont des fichiers requis par l'étape
COBOL de la procédure ELAXFCOC décrite à l'étape
7. Ces noms
de fichier doivent correspondre aux noms de fichier indiqués dans les options d'étape COBOL.
Pour chaque fichier, procédez comme suit :- Sélectionnez le sous-système Fichiers MVS dans la vue Système distant
puis cliquez sur Nouveau > Affecter un fichier partitionné.
- Dans la page Affecter un fichier partitionné,
effectuez les tâches suivantes :
- Acceptez le nom proposé dans la zone Nom abrégé de l'hôte.
- Dans la liste déroulante, sélectionnez le qualificatif de haut niveau du fichier.
- Dans la zone Nom de fichier, spécifiez le nom qui suit le qualificatif de haut niveau et
le point.
Par exemple, si le qualifiant de haut niveau est
MESFICHIERS et que vous souhaitez affecter le fichier
MESFICHIERS.REMOTE.COBOL, entrez la chaîne
REMOTE.COBOL dans la zone Nom de fichier.
- Cliquez sur Suivant.
- Sur la page Affectation du fichier, sélectionnez le bouton
d'option Spécifier les caractéristiques par type d'utilisation puis
sélectionnez la valeur correspondante dans chaque zone de ligne, comme cela est présenté dans
le tableau.
- Cliquez sur Terminer.
- Obtenez le code source exemple pour ce tutoriel :
- Cliquez sur Fichier > Nouveau > Exemple. Développez Poste de travail
COBOL, puis cliquez sur COBOL Sample 1 dans la liste. Cliquez sur Suite.
- Spécifiez LocalCOBOLSample comme nom de projet, puis cliquez surTerminer.
- Copiez les fichiers source COBOL, PrintApp.cbl et StartApp.cbl,
dans le fichier partitionné <HLQ>.REMOTE.COBOL.
- Créez un projet z/OS et un
sous-projet MVS :
- Dans la vue Projets z/OS, cliquez sur Nouveau
> Projet z/OS. L'assistant Nouveau projet
z/OS s'affiche.
- Dans la zone Nom du projet, entrez SampleProject.
- Sélectionnez Créer un sous-projet MVS et cliquez
sur Terminer.
- Dans la zone Nom du sous-projet, entrez
RemoteCOBOLSample. Par défaut, la zone Qualificatif de haut niveau prend la
valeur de l'ID utilisateur avec lequel vous vous êtes connecté au système distant.
- Dans la zone Groupe de propriétés de la fenêtre
Nouveau sous-projet MVS, cliquez sur Créez un groupe de propriétés
et associez-le au projet.
- Nommez le groupe de propriétés, SamplePropGroup.
- Cliquez sur Terminer pour modifier le groupe de propriétés.
- Pour définir les options de génération dans le nouveau groupe de propriétés, procédez comme suit :
- Dans l'éditeur de groupe de propriétés, cliquez sur l'onglet COBOL puis
sur Procédures et étapes.
- Développez la procédure ELAXFCOC puis cliquez deux fois
sur COBOL pour éditer l'étape COBOL.
- Copiez et collez l'élément JCL suivant dans la zone de texte JCL
supplémentaire :
//SYSOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
Ben
Q
/*
//
- Cliquez sur l'onglet JCL dans l'éditeur de groupe
de propriétés et vérifiez que la carte JOB par défaut inclut une instruction
PROCS qui désigne la bibliothèque de procédures sur le système distant. Si vous ne connaissez pas l'emplacement de la bibliothèque de procédures, demandez cette information à votre
administrateur système.
- Fermez et enregistrez le nouveau groupe de propriétés.
- Ajoutez le fichier partitionné <HLQ>.REMOTE.COBOL au sous-projet
RemoteCOBOLSample :
- Sélectionnez le fichier dans la vue Systèmes distants.
- Cliquez avec le bouton droit de la souris, puis sélectionnez Ajouter au sous-projet.
- Saisissez ou sélectionnez le nom du sous-projet, puis cliquez sur Terminer.
- Générez et exécutez l'application :
- Dans le sous-projet RemoteCOBOLSample, sélectionnez STARTAPP.cbl et
cliquez sur Affecter comme point d'entrée.
- Sélectionnez RemoteCOBOLSample puis cliquez
sur Régénérer le sous-projet. A la fin de l'opération de génération, le paquet de cartes objet et le module de chargement généré sont
ajoutés au sous-projet.
- Sélectionnez le module de chargement généré et cliquez sur Exécuter
> Exécuter pour exécuter l'application. Vous pouvez également cliquer sur Exécuter
> Déboguer pour déboguer l'application.