Options prises en charge par l'outil d'importation en masse

Cette rubrique répertorie et décrit brièvement les options disponibles dans l'outil d'importation en masse.
Exécutez la commande d'importation en masse zimport à partir de l'interface de ligne de commande de Rational Team Concert for System z. L'outil d'importation en masse prend en charge les options suivantes :
-r
Pour repositoryURI (URI du référentiel). Utilisez cette option pour définir l'emplacement du référentiel vers lequel vous souhaitez importer les membres d'ensemble de données partitionné.
-u
Pour user (utilisateur). Utilisez cette option pour définir un nom d'utilisateur pour le référentiel.
-P
Pour password (mot de passe). Utilisez cette option pour définir le mot de passe d'un référentiel.
Important : Utilisez un P majuscule et non un p minuscule.
--hlq
Pour HLQ (qualificatif de haut niveau). Utilisez cette option pour définir le qualificatif de haut niveau (HLQ) de l'ensemble de données partitionné que vous souhaitez importer.
--mapfile
Pour file (fichier). Utilisez cette option pour définir l'emplacement du fichier de mappage. Ce fichier décrit la structure du projet vers lequel vous souhaitez importer les membres de l'ensemble de données partitionné. Vous devez toujours définir l'emplacement du fichier de mappage et ce fichier doit toujours contenir deux types de mappage :
  • Mappage des membres de l'ensemble de données partitionné vers le projet zComponent vers lequel vous souhaitez importer les membres.
  • Mappage du projet zComponent vers le composant Jazz auquel le projet appartient.
Le mappage des membres vers la définition de langage associée est facultatif.
Remember : La définition de langage indiquée doit déjà exister dans la zone de projet indiquée.
--projectarea
Pour projectArea (zone de projet). Utilisez cette option pour définir le nom de la zone de projet dans laquelle les définitions de fichier associées aux membres importés seront stockées. Il doit s'agir de la zone de projet dans laquelle les définitions de langage associées sont stockées.
-s
Option facultative : pour stream (flux). Utilisez cette option pour définir le nom, l'alias ou l'UUID du flux que vous souhaitez définir en tant que cible de flux par défaut pour l'espace de travail de référentiel créé lors de l'importation en masse.
-q
Option facultative : pour quiet (mode silencieux). Utilisez cette option pour supprimer la sortie de la console.
-v
Option facultative : pour verbosity (prolixité). Utilisez cette option pour augmenter la prolixité de la sortie.

Format des fichiers de mappage

Le fichier de mappage est délimité par des lignes. Le format de chaque ligne doit être le suivant : <caractère identificateur> : <clé> = <valeur>. Le tableau ci-dessous décrit les combinaisons de lignes possibles. Pour plus d'informations sur les restrictions appliquées aux règles des fichiers de mappage, voir Format des fichiers de mappage de l'outil d'importation en masse.
Tableau 1. Combinaisons de lignes d'une importation en masse
Identificateur Clé Valeur Remarques
C Nom du projet zComponent Nom du composant Jazz Définit à quel composant Jazz un projet zComponent doit appartenir. Les projets zComponent non conformes aux règles des noms de projet définies dans le fichier de mappage ne doivent pas être importés.
P1, 2 Nom de membre qualifié complet (hormis HLQ) Nom du projet zComponent [nom :dossier zFolder] Définit vers quels projets zComponent les membres de l'ensemble de données partitionné doivent être importés. Vous pouvez utiliser des caractères génériques dans la clé (*) pour définir plusieurs projets à placer dans le projet zComponent. Les membres non conformes à une règle de nom de membre définie dans le fichier de mappage ne sont pas importés.
L1 Nom de membre qualifié complet (hormis HLQ) Nom de définition de langage [suffixe :fichier] Définit la définition de langage à associer aux membres importés. Rappel : la définition de langage doit déjà exister dans la zone de projet. Vous pouvez utiliser des caractères génériques (*) dans la clé pour définir plusieurs membres à associer à la définition de langage.
X1 Nom de membre qualifié complet (hormis HLQ) aucun Définit les membres à exclure de l'importation en masse. Vous pouvez utiliser des caractères génériques (*) dans la clé pour définir plusieurs membres à exclure. Les membres correspondant à la clé donnée ne sont pas importés.
Important :
  1. Pour les identificateurs P, L et X, les membres sont référencés à l'aide de masques de correspondance composés du nom de l'ensemble de données partitionné (sans le HLQ) suivi d'un point et du nom de membre. Le membre HELLO de l'ensemble de données partitionné SMITH.TEST.COBOL correspond par exemple au masque TEST.COBOL.HELLO. Le masque TEST.COBOL.* correspond à tous les membres de l'ensemble de données nommés SMITH.TEST.COBOL. Les membres sont importés par défaut en tant que fichiers zFile portant le même nom que le membre. Vous pouvez par exemple définir un nom de définition de langage comme celui-ci :

    L:TEST.COBOL.*=COBOL:cbl

    Lors de l'ajout d'une extension de fichier comme .cbl, par exemple, deux événements se produisent :
    1. La définition de langage COBOL est associée à tous les membres correspondant à cette règle.
    2. oLe suffixe .cbl est ajouté au nom des fichiers zFile importés.
  2. Pour l'identificateur P, la commande zimport importe par défaut les membres d'un ensemble de données partitionné vers le projet zComponent indiqué dans un dossier zFolder de même nom que l'ensemble de données partitionné. Vous pouvez également modifier le nom du dossier zFolder en ajoutant un signe deux-points (:) après le nom du projet zComponent, suivi du nom du dossier zFolder de votre choix. Si vous souhaitez par exemple importer tous les membres d'un ensemble de données partitionné nommé MORT.BLD.TEST vers le projet zComponent MortgageApp dans un dossier zFolder nommé MORT.BLD, le fichier de mappage doit contenir la règle suivante : P:MORT.BLD.TEST.*=MortgageApp:MORT.BLD.
  3. Le fichier de mappage peut également contenir des renvois. Pour cela, entrez des parenthèses dans la clé et %n dans la valeur. Si vous souhaitez par exemple importer tous les membres d'un ensemble de données partitionné nommé MORT.*.BLD.TEST vers un projet zComponent nommé MORTApp dans des dossiers zFolder dont les noms sont compris entre MORT. et .BLD, rédigez la règle suivante : P:(MORT).(*).BLD.TEST.*=%1App:%2.

Commentaires en retour

Avez-vous obtenu l'aide souhaitée ? Vous pouvez envoyer des commentaires en retour à Jazz.net (inscription nécessaire) : Commentaire dans les forums ou signaler un bogue