Rational Developer for System z, version 7.6.1

Génération de déclarations à partir de tables DB2

Rational Developer for System z permet de générer des fichiers de stockage, des fichiers d'inclusion, des macros et des fichiers d'en-tête C/C++ à partir des informations des tables de base de données, à l'aide de l'utilitaire DB2 DCLGEN. Cette utilitaire facilite l'inclusion de structures de table de base de données dans vos programmes.

Avant de commencer

Pour utiliser l'utilitaire DCLGEN, vous devez d'abord effectuer les tâches suivantes :
  1. Connexion à un système distant
  2. Connexion à une base de données

Il vous sera plus simple d'utiliser votre table de base de données si vous ajoutez également l'explorateur de source de données à votre perspective Projets z/OS. L'explorateur de source de données est une vue qui affiche les tables de base de données, à partir de laquelle l'assistant DCLGEN s'ouvre. Pour ouvrir l'explorateur de source de données, dans la barre de menus, cliquez sur Fenêtre > Afficher la vue > Explorateur de source de données.

Pourquoi et quand exécuter cette tâche

Pour générer un fichier de stockage, un fichier d'inclusion, une macro ou un fichier d'en-tête C/C++ à l'aide de l'utilitaire DCLGEN, procédez comme suit :

Procédure

  1. Dans l'explorateur de source de données, sélectionnez une table de base de données z/OS.
  2. Dans le menu contextuel, cliquez sur DCLGEN. L'assistant Générer des déclarations s'ouvre. Certaines des zones de cet assistant sont renseignées avec les valeurs par défaut. Ces valeurs par défaut sont remplacées par les valeurs que vous entrez lors de la session actuelle et sauvegardées pour votre prochaine session.
  3. Renseignez les zones requises et celles facultatives dans l'assistant Le tableau ci-après décrit les zones de chaque page.
    Tableau 1. Zones de l'assistant Générer des déclarations (DCLGEN)
    Page Zone Description
    Informations de système Nom du système Nom du système z/OS sur lequel se trouve la table DB2. Pour sélectionnez un autre système et une autre table de base de données après le démarrage de l'assistant, sélectionnez un nom de système dans la liste déroulante. Cliquez sur Connecter pour vous connecter au système.
      Sous-système DB2 Nom du sous-système DB2 auquel vous êtes connecté.
      Procédure Indiquez le nom de la procédure JCL à exécuter. La valeur par défaut est ELAXFDCL. Pour plus d'informations sur les exemples de procédure JCL disponibles, voir Procédures fournies avec Rational Developer for System z.
      Etape Etape JCL à exécuter. La valeur par défaut est DCLGEN.
      Carte de travail JCL Carte de travail JCL par défaut sur votre site. Vous pouvez éditer ce JCL ou ajouter les instructions JCL requises par votre site.
    Sortie générée Langage Choisissez le langage de la déclaration générée. Cette liste répertorie les langages pris en charge par l'utilitaire DCLGEN.
    • IBMCOB - IBM Enterprise COBOL for z/OS
    • PLI - IBM Enterprise PL/I for z/OS
    • C - IBM C/370
    • COBOL - IBM OS/VS COBOL
    • COB2 - Autres langages COBOL
    Pour plus d'informations sur les options de langage DCLGEN, reportez-vous aux commandes connexes dans le document de référence des commandes DB2.
      Fichier de sortie Spécifiez le nom du fichier dans lequel le JCL généré doit être stocké. Cliquez sur Parcourir pour sélectionner un nom de fichier.
      Membre Spécifiez le nom du membre de fichier partitionné qui doit contenir le JCL généré.
      Mot de passe (si requis) Si votre fichier de sortie requiert un mot de passe, spécifiez-le ici. Ce mot de passe sera inclus dans le JCL généré.
    Options DCLGEN Connexion Affiche le sous-système DB2 auquel vous êtes connecté.
      Schéma et table Affiche le schéma et la table DB2 que vous avez sélectionnés.
      Nom de la structure de données Indiquez un nom pour la structure de données générée. Ce nom peut contenir jusqu'à 31 caractères.
      Préfixe Spécifiez un préfixe à utiliser pour constituer les noms de zone dans la structure de données. Ce préfixe peut contenir jusqu'à 28 caractères et sera concaténé avec un numéro de un à trois chiffres pour constituer les noms de zone. Si vous spécifiez le préfixe ABC, par exemple, les noms de zone ABC1, ABC2 et ainsi de suite jusqu'à ABC999 sont constitués. Pour plus d'informations sur les noms de zone, reportez-vous à l'option COLSUFFIX.
      Options DCLGEN Sélectionnez les options DCLGEN de la structure de données générée. Les options disponibles sont décrites brièvement ci-après. Pour connaître la version de DB2 utilisée sur votre site et une description complète de ces options, reportez-vous au document de référence des commandes DB2.
      ACTION Indique comment le membre de fichier partitionné contenant la structure de données générée doit être créé. Sélectionnez REPLACE pour remplacer un membre de fichier partitionné existant par le membre actuellement généré ou ADD pour ajouter le nom de membre comme nouveau membre s'il n'existe pas déjà.
      Délimiteur de chaîne Spécifie le délimiteur de chaîne du langage hôte. Cette option n'est utilisée que pour les programmes COBOL. Sélectionnez APOST pour spécifier une apostrophe comme délimiteur de chaîne du langage hôte ou QUOTE pour spécifier un guillemet comme délimiteur de chaîne du langage hôte.
      LABEL Indique si les libellés de colonne doivent être inclus dans la sortie comme commentaires. Sélectionnez YES pour inclure les libellés de colonne ou NO pour les omettre.
      DBCSSYMBOL Indique le symbole utilisé pour dénoter un type de données graphique dans une clause COBOL PICTURE. Sélectionnez G ou N.
      DBCSDELIM Indique si la table DBCS et les noms de colonne dans l'instruction de table DECLARE générée sont délimités. Sélectionnez YES ou NO.
      COLSUFFIX Détermine si les noms de zone doivent être constitués en associant le nom de colonne au préfixe spécifié dans la zone Préfixe. Sélectionnez YES pour constituer les noms de zone en ajoutant les noms de colonne au préfixe. Si le préfixe est ABC, par exemple, et qu'un nom de colonne est EMPNO, le nom de zone généré est ABCEMPNO. Si aucun préfixe n'est spécifié, DCLGEN génère un message d'avertissement et utilise les noms de colonne comme noms de zone. Sélectionnez NO pour n'utiliser que le préfixe pour générer les noms de zone.
      INDVAR Détermine si un tableau de variables indicateur doit être créé pour la structure des variables hôte. Sélectionnez YES ou NO. Si vous sélectionnez YES, le nom du tableau correspond au nom de table avec le préfixe “I” (ou la lettre DBCS “<I>” si le nom de table est sur deux octets).
  4. Cliquez sur Terminer pour générer et soumettre le JCL et créer les déclarations générées. Rational Developer for System z génère le JCL et le soumet au système distant. Si le travail est effectué correctement, la structure de données générée est sauvegardée dans le membre de fichier partitionné de sortie spécifié dans la page Sortie générée de l'assistant.
  5. Pour afficher la sortie du travail, développez le filtre JES > Mes travaux dans la vue Systèmes distants et cliquez deux fois sur le nom du travail pour ouvrir la sortie du travail.
  6. Pour afficher la structure de données générée, développez le filtre Fichiers MVS > Mes fichiers pour rechercher le fichier partitionné et le nom de membre spécifiés dans la page Sortie générée de l'assistant et cliquez deux fois sur le nom du membre pour l'ouvrir.

Conditions d'utilisation | Commentaires

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