Las reglas en un archivo de correlaciones están delimitadas por una línea, y se aplican las siguientes restricciones a las reglas de archivos de correlaciones:
- La herramienta de importación en masa ignora las líneas en blanco.
- La herramienta de importación en masa ignora las líneas que comienzan con el signo de la libra (#).
- Las líneas deben deben cumplir el siguiente formato, donde tipo-regla debe ser el carácter P, el carácter C
o el carácter X:
rule-type:key=value
- P indica que la regla correlaciona un nombre de miembros cualificados al proyecto zComponent y, de forma opcional, a zFolder donde debería estar colocado.
Nota: Después de la regla P , tiene la opción de especificar una zFolder a la que importar el miembro. Para hacerlo, añada [:zFolder] después de la regla P , pero reemplace zFolder con el nombre de la carpeta donde desea importar el miembro. Esa línea se debería parecer a ésta: P:TEST.COBOL.HELLO=MyProject:MyFolder
Atención: La cualificación del nombre del miembro en la regla P no incluye el cualificador de alto nivel (HLQ).
- C indica que la regla correlaciona un proyecto zComponent al componente Jazz que debería contenerlo.
Importante: Si el proyecto zComponent al que se importaron los miembros no coincide con ninguna regla C , esos miembros no se importarán.
- L indica que la regla correlaciona un nombre de miembros cualificados (sin cualificador de alto nivel) al nombre de la definición de lenguaje para asociarla a él.
Nota: Después de la regla L , tiene la opción de especificar un sufijo de archivo para añadirlo al zFile importado. Para hacerlo, añada [:file suffix] después de la regla L , pero reemplace el sufijo del archivo con la extensión del archivo que desea añadir a zFile. Esa línea se debería parecer a ésta: L:TEST.COBOL.*=COBOL:cbl.
Importante: La definición de lenguaje especificada ya tiene que existir en el área de proyecto que especificó en la línea de mandatos. Especificar las definiciones de lenguaje para miembros importados es opcional, y los miembros sin una definición de lenguaje asociada todavía se pueden importar.
- X indica los miembros a excluir de la importación en masa.
Importante: Cualquier miembro que coincida con la regla de tecla X dada no se importará.
Los contenidos del archivo de correlaciones se parecerá al siguiente ejemplo:
# Miembro para correlaciones del proyecto zComponent
# Especifica el proyecto zComponent, y de forma opcional, el zFolder que
# contiene los miembros importados.
#
# Formato:
# P:<member>=<zComponent project>[:<zFolder>]
P:MORTGAGE.*.(*).*=MortgageApp:%1
P:ALL.COBOL.*CALC=CalcApp:CobolSrc
P:ALL.COBOL.ATM*=ATMApp:CobolSrc
# Proyecto zComponent para correlaciones Jazz Component
# Especifica el Jazz Component que compartirá cada proyecto zComponent.
#
# Formato:
# C:<zComponent project>=<Jazz Component>
C:MortgageApp=Mortgage
C:CalcApp=Sample Applications
C:ATMApp=Sample Applications
# Miembro para correlaciones de la definición de lenguaje
# Especifica opcionalmente la definición de lenguaje para asociar con los miembros importados.
#
# Formato:
# L:<member>=<Language Definition name>
L:*.COBOL.*=COBOL:cbl
L:*.JCL.*=JCL
# Reglas de exclusión # Miembros de la lista que no se importan
#
# Formato:
# X:<member>
X:*.OBJ.*
Si ejecuta el mandato zimport para un PDS denominado SMITH.MORTGAGE.BLD.COBOL, indique SMITH como --hlq, y especifique la regla de archivo de correlaciones P:MORTGAGE.BLD.COBOL.*=MortgageApp, se deberían importar todos los contenidos de SMITH.MORTGAGE.BLD.COBOL en un proyecto zComponent denominado MortgageApp, dentro de zFolder denominadaMORTGAGE.BLD.COBOL. Si, en lugar de eso, especifica la regla de archivo de correlaciones P:MORTGAGE.BLD.COBOL.*=MortgageApp:CobolSRC,
la zFolder se debería denominar CobolSRC.