Les règles des fichiers de mappage sont délimitées par des lignes et les restrictions suivantes
s'appliquent à ces règles :
- L'outil d'importation en masse ignore les lignes vides.
- L'outil d'importation en masse ignore les lignes qui commencent par le signe dièse
(#).
- Les lignes doivent avoir le format suivant, où la valeur associée à type-règle doit être le caractère P, C, L ou X :
type-règle:clé=valeur
- P indique que la règle mappe un nom de membre qualifié
vers le projet zComponent et éventuellement vers le dossier zFolder
où il doit être placé.
Remarque : La règle P,
peut être suivie d'une option permettant de définir le dossier zFolder vers lequel le membre
sera importé. Pour ceci, entrez [:zFolder] après la règle P,
mais remplacez zFolder par le nom du dossier
vers lequel vous souhaitez importer le membre, comme dans l'exemple suivant : P:TEST.COBOL.HELLO=MonProjet:MonDossier
Attention : La qualification du nom de membre de la règle P
ne contient pas le qualificatif de haut niveau (HLQ).
- C indique que la règle mappe un projet zComponent
vers le composant Jazz devant le contenir.
Important : Si le projet zComponent vers lequel des
membres sont importés n'est pas conforme aux règles C, l'importation n'a pas lieu.
- L indique que la règle mappe un nom de membre
qualifié (sans qualificatif de haut niveau) vers le nom d'une définition de langage
à laquelle il doit être associé.
Remarque : La règle L peut être suivie
d'une option permettant de d'indiquer le suffixe de fichier à ajouter au fichier zFile importé. Pour ceci, entrez
[suffixe :fichier] après la règle L,
mais remplacez le suffixe du fichier par l'extension de fichier que vous souhaitez ajouter
au fichier zFile, par exemple : L:TEST.COBOL.*=COBOL:cbl.
Important : La définition de langage indiquée doit déjà exister
dans la zone de projet que vous avez indiquée en ligne de commande. Il n'est pas
obligatoire d'indiquer une définition de langage pour un membre importé et l'importation
d'un membre sans définition de langage associée est toujours possible.
- X indique les membres à exclure de l'importation en masse.
Important : Les membres correspondant à la règle clé X donnée ne sont pas importés.
Voici un exemple du contenu d'un fichier de mappage :
# Mappage de membres vers un projet zComponent
# Indiquez le projet zComponent et éventuellement le dossier zFolder qui
# contiendra les membres importés.
#
# Format :
# P:<membre>=<projet zComponent>[:<dossier zFolder>]
P:MORTGAGE.*.(*).*=MortgageApp:%1
P:ALL.COBOL.*CALC=CalcApp:CobolSrc
P:ALL.COBOL.ATM*=ATMApp:CobolSrc
# Mappage d'un projet zComponent vers un composant Jazz
# Indiquez le composant Jazz dans lequel chaque projet zComponent sera partagé.
#
# Format :
# C:<projet zComponent>=<composant Jazz>
C:MortgageApp=Mortgage
C:CalcApp=Sample Applications
C:ATMApp=Sample Applications
# Mappage de membres vers une définition de langage
# Facultatif : indiquez la définition de langage à associer aux membres importés.
#
# Format :
# L:<membre>=<nom de la définition de langage>
L:*.COBOL.*=COBOL:cbl
L:*.JCL.*=JCL
# Règles d'exclusion
# Répertorie les membres à ne pas importer
#
# Format :
# X:<membre>
X:*.OBJ.*
Si vous exécutez la commande zimport pour un ensemble de données partitionné
nommé SMITH.MORTGAGE.BLD.COBOL, si vous entrez SMITH en tant
que --hlq et et si vous définissez la règle de fichier de mappage P:MORTGAGE.BLD.COBOL.*=MortgageApp,
tout le contenu de SMITH.MORTGAGE.BLD.COBOL sera
importé dans un projet zComponent nommé MortgageApp, dans
un dossier zFolder nommé MORTGAGE.BLD.COBOL. Si, au contraire, vous entrez
la règle de fichier de mappage P:MORTGAGE.BLD.COBOL.*=MortgageApp:CobolSRC,
le dossier zFolder s'appellera CobolSRC.