Rational Developer for System z

Exécution d'une application COBOL simple sur un système distant

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

  1. Accédez à la perspective Projets z/OS :
    1. Dans le plan de travail, sélectionnez Fenêtre > Ouvrir la perspective > Autre. L'assistant Sélection de la perspective s'affiche.
    2. Cliquez sur Projets z/OS.
    3. Cliquez sur OK. La perspective Projets z/OS s'affiche.
  2. Créez une connexion à un système distant :
    1. Dans la vue Systèmes distants, développez Nouvelle connexion et sélectionnez z/OS.
    2. Cliquez avec le bouton droit de la souris et choisissez Nouvelle connexion. La fenêtre Nouvelle connexion s'ouvre.
    3. Sélectionnez un nom de profil dans la liste déroulante.
    4. 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.
    5. 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.
    6. 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.
    7. 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.
  3. Connectez-vous au système distant :
    1. Sélectionnez la connexion au système distant dans la vue Systèmes distants et cliquez sur Se connecter.
    2. Dans la fenêtre de saisie du mot de passe, entrez votre ID utilisateur et votre mot de passe puis cliquez sur OK.
  4. 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 :
    1. Sélectionnez le sous-système Fichiers MVS dans la vue Système distant puis cliquez sur Nouveau > Affecter un fichier partitionné.
    2. Dans la page Affecter un fichier partitionné, effectuez les tâches suivantes :
      1. Acceptez le nom proposé dans la zone Nom abrégé de l'hôte.
      2. Dans la liste déroulante, sélectionnez le qualificatif de haut niveau du fichier.
      3. 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.
      4. Cliquez sur Suivant.
    3. 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.
    4. Cliquez sur Terminer.
  5. Obtenez le code source exemple pour ce tutoriel :
    1. Cliquez sur Fichier > Nouveau > Exemple. Développez Poste de travail COBOL, puis cliquez sur COBOL Sample 1 dans la liste. Cliquez sur Suite.
    2. Spécifiez LocalCOBOLSample comme nom de projet, puis cliquez surTerminer.
    3. Copiez les fichiers source COBOL, PrintApp.cbl et StartApp.cbl, dans le fichier partitionné <HLQ>.REMOTE.COBOL.
  6. Créez un projet z/OS et un sous-projet MVS :
    1. Dans la vue Projets z/OS, cliquez sur Nouveau > Projet z/OS. L'assistant Nouveau projet z/OS s'affiche.
    2. Dans la zone Nom du projet, entrez SampleProject.
    3. Sélectionnez Créer un sous-projet MVS et cliquez sur Terminer.
    4. 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.
    5. 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.
    6. Nommez le groupe de propriétés, SamplePropGroup.
    7. Cliquez sur Terminer pour modifier le groupe de propriétés.
  7. Pour définir les options de génération dans le nouveau groupe de propriétés, procédez comme suit :
    1. Dans l'éditeur de groupe de propriétés, cliquez sur l'onglet COBOL puis sur Procédures et étapes.
    2. Développez la procédure ELAXFCOC puis cliquez deux fois sur COBOL pour éditer l'étape COBOL.
    3. 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
      /*
      //
    4. 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.
    5. Fermez et enregistrez le nouveau groupe de propriétés.
  8. Ajoutez le fichier partitionné <HLQ>.REMOTE.COBOL au sous-projet RemoteCOBOLSample :
    1. Sélectionnez le fichier dans la vue Systèmes distants.
    2. Cliquez avec le bouton droit de la souris, puis sélectionnez Ajouter au sous-projet.
    3. Saisissez ou sélectionnez le nom du sous-projet, puis cliquez sur Terminer.
  9. Générez et exécutez l'application :
    1. Dans le sous-projet RemoteCOBOLSample, sélectionnez STARTAPP.cbl et cliquez sur Affecter comme point d'entrée.
    2. 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.
    3. 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.

Conditions d'utilisation | Commentaires

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)