Generación de metadatos de compilación automáticamente utilizando el generador de definiciones de idiomas Rational Team Concert for System z

Antes de empezar
Utilice el generador de definiciones de idiomas en el cliente del entorno de desarrollo integrado de Rational Team Concert for System z (IDE) para crear definiciones de conjuntos de datos, conversores y definiciones de idiomas sin utilizar un editor.

Antes de que pueda utilizar el generador de definiciones de idioma, debe haber hecho lo siguiente:

Importación de un proyecto zComponent para utilizarlo con el generador de definiciones de idiomas

Por qué y cuándo se efectúa esta tarea
Completar esta tarea para practicar utilizando el generador de definiciones de idiomas con un proyecto de muestra, varios de los cuales están instalados con el cliente Rational Team Concert for System z .
  1. En Rational Team Concert for System z, abra la perspectiva Recurso.
    1. Pulse Ventana.
    2. Ciérnase sobre Abrir perspectiva.
    3. Seleccione Otro.
    4. Seleccione Recurso.
    5. Pulse Aceptar. Se muestra la vista Explorador del proyecto.
  2. En la vista Explorador del proyecto, pulse con el botón derecho sobre el proyecto y seleccione Importar. Se abre la ventana del asistente de Importar Seleccionar .
  3. En la ventana del asistente Importar Seleccionar , expanda el nodo General y seleccione Proyectos existentes en el espacio de trabajo.
  4. Pulse Siguiente. Se abre la ventana del asistente de Importar Importar proyectos .
  5. Seleccione el botón de selección Seleccionar directorio raíz y pulse Navegador.
  6. Seleccione el directorio raíz del proyecto que quiere importar. Los proyectos de muestra están almacenados en el subdirectorio rtcz\samples del directorio de instalación de Rational Team Concert for System z : C:\Archivos de programa\IBM\SDP\rtcz\samples.
  7. Seleccione los recuadros al lado de los proyectos que quiere importar. Están disponibles los siguientes proyectos de muestra:
    HelloWorldSample
    Una sencilla muestra de aplicación “Hello World” de COBOL .
    HelloWorldSample2
    Una aplicación adicional “Hello World” en el ensamblador de host, PL/I y C.
    MortgageApplication
    Una aplicación de muestra de COBOL con varios proyectos zComponent. Para importar este proyecto de muestra, seleccione todos los proyectos cuyos nombres comiencen con MortgageApplication.
  8. Pulse Finalizar.

Ejecución del generador de definiciones de idiomas de Rational Team Concert for System z

  1. Expanda el nodo de proyecto.
  2. Seleccione el archivo setuprtcz.xml , a continuación seleccione Ejecutar como > Compilación Ant.
    Nota: setuprtcz.xml es el nombre del archivo que está incluido en el proyecto de muestra. Si graba su propio archivo, asegúrese de que le da la extensión de archivo .xml .
  3. Seleccione el separador Propiedades, a continuación borre el recuadro al lado de Utilizar propiedades globales como se especifica en las preferencias de tiempo de ejecución Ant, después, añada las siguientes propiedades:
    • repositoryAddress. Ésta es la URL de Rational Team Concert for System z .
    • userID. Éste es el ID de usuario de Rational Team Concert for System z .
    • password. Ésta es la contraseña de Rational Team Concert for System z .
    • projectArea. Es el nombre del área de proyecto.
  4. Seleccione el separador JRE, a continuación, seleccione Ejecutar en el mismo JRE que el espacio de trabajo.
  5. Pulse Aplicar, después Ejecutar. Si ejecutó satisfactoriamente el generador de definiciones de idiomas, creará todas las definiciones del conjunto de datos necesarios, conversores y definiciones de idiomas, y los metadatos contenidos en los proyectos seleccionados se actualizarán para señalar las nuevas definiciones.
  6. Vaya a la vista Cambios pendientes y verifique los cambios para los metadatos.
  7. Vaya a la perspectiva Elementos de trabajo, pulse con el botón derecho del ratón sobre el área de proyecto y pulse Renovar. En la vista Artefactos de equipo, las nuevas definiciones de conjunto de datos, las definiciones de idiomas y los conversores deberían mostrarse dentro del área de proyecto.

Tareas Ant del generador de definiciones de idiomas

Utilice el generador de definiciones de idiomas de Rational Team Concert for System z para realizar las siguientes tareas Ant personalizadas. Cada nombre de tarea representa el nombre de clase Java™ que implementa la tarea.

InitTask

Por qué y cuándo se efectúa esta tarea
InitTask es una tarea Ant personalizada que inicializa conexiones con el servidor de Rational Team Concert for System z para otra definición de conjunto de datos, conversor y tareas de definición de idiomas. Debe realizar InitTask antes de cualquier otra definición de conjunto de datos, conversor y tareas de definición de idiomas.
Tabla 1. Parámetros de InitTask
Atributo Descripción
repositoryAddress Serie URL para el servidor Rational Team Concert for System z
userId ID de usuario de Rational Team Concert for System z
contraseña Contraseña de Rational Team Concert for System z
passwordFile Archivo de contraseñas Rational Team Concert for System z
projectArea Nombre del área de proyecto donde están almacenadas las definiciones de conjunto de datos asociadas, conversores y definiciones de idiomas.
Ejemplo
Lo siguiente es un ejemplo de InitTask:

<ld:init repositoryAddress="https://opusdejazz.raleigh.ibm.com:9443/jazz"userId="tami" password="tami" projectArea="Build Test"/>

DsDefTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para crear una definición de conjunto de datos.
Tabla 2. Parámetros de DsDefTask
Atributo Descripción Predeterminado
nombre Nombre de definición  
descripción Descripción de definición  
dsName Nombre conjunto de datos  
dsMember Nombre de miembro  
prefixDSN verdadero si el prefijo que especificó en la solicitud de compilación debería preceder al nombre del conjunto de datos. verdadero
dsDefUsageType
  • 0 = zFolder
  • 1 = nuevo
  • 2 = temp
  • 3 = existente
0 (zFolder)
dsType
  • 0 = PDSE
  • 9 = UNSPECIFIED
0 (PDSE)
storageClass Clase de almacenamiento a la que se asigna el conjunto de datos.  
dataClass Clase de datos utilizada para crear el conjunto de datos.  
managementClass Clase de gestión para gestionar el conjunto de datos.  
volumeSerial Número de serie del volumen del conjunto de datos  
GenericUnit nombre de grupo genérico o dirección de unidad  
spaceUnits Unidad de espacios de asignación que se utilizarán. El valor debe ser uno de los siguientes:
  • trks (pistas)
  • blks (bloques)
  • cyls (cilindros)
 
recordUnit Unidad de cantidad de asignación. El valor debe ser uno de los siguientes:
  • U (único)
  • K (mil)
  • M (millón)
U
primaryQuantity Cantidad de asignación primaria 1
secondaryQuantity Cantidad de asignación secundaria 1
directoryBlocks Número de bloques de directorio de 256 bytes proporcionado. 0
recordLength Longitud lógica en bytes 80
blockSize Tamaño de bloque  
recordFormat Una serie de formato de registro de conjunto de datos z/OS , como F, FB, V, VB o U. Los posibles valores pueden incluir:
  • F (fijo)
  • V (variable)
  • U (sin definir)
  • B (bloqueado)
  • A (Especifica que el archivo contiene caracteres de control ASA.)
  • M (Especifica que el archivo contiene caracteres de control de máquina.)
  • S (formato estándar si es fijo; formato extendido si es variable)
  • T (truncado)
FB
Ejemplo
Lo siguiente es un ejemplo de DsDefTask:

<!-- zFolders --> <ld:dsdef name="COBOL" dsName="COBOL" dsDefUsageType="0" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="FB" recordLength="80" blockSize="0" />  
<!-- Nuevos conjuntos de datos --> <ld:dsdef name="OBJ" dsName="OBJ"  dsDefUsageType="1" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="FB" recordLength="80" blockSize="0" /> <ld:dsdef name="LOAD" dsName="LOAD"  dsDefUsageType="1" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="U" recordLength="0" blockSize="32760" />
<!-- Conjunto de datos temporal --> <ld:dsdef name="TEMPFILE" dsDefUsageType="2" prefixDSN="false" dsType="9" spaceUnits="trks" primaryQuantity="5" secondaryQuantity="5" genericUnit="SYSALLDA" />
<!-- Conjuntos de datos existentes --> <ld:dsdef name="IGYCRCTL" dsName="COBOL.V4R1M0.SIGYCOMP" dsMember="IGYCRCTL" dsDefUsageType="3" prefixDSN="false"/> <ld:dsdef name="IEWBLINK" dsMember="IEWBLINK" dsDefUsageType="3" prefixDSN="false"/> <ld:dsdef name="SCEELKED" dsName="CEE.SCEELKED" dsDefUsageType="3" prefixDSN="false"/>

TranslatorTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para crear un conversor. TranslatorTask acepta Asignación y Concatenación como elementos hijo.
Tabla 3. Parámetros TranslatorTask
Atributo Descripción Predeterminado
nombre Nombre del conversor  
descripción Descripción del conversor  
dataSetDefinition Definición del conjunto de datos para el módulo del conversor  
ddnamelist Lista de nombres DD alternativos para el conversor  
defaultOptions Serie opción que se pasa al conversor.  
maxRC Código de retorno máximo permitido 0
Ejemplo
Lo siguiente es un ejemplo de TranslatorTask:

<ld:translator name="ASMMAP" dataSetDefinition="ASMA90"
   defaultOptions="SYSPARM(MAP),DECK,NOOBJECT"
   ddnamelist="SYSLIN,,,SYSLIB,SYSIN,ANTPRINT"
   maxRC="0">
   <ld:concatenation name="SYSLIB">
      <ld:allocation dataSetDefinition="SDFHMAC"/>
      <ld:allocation dataSetDefinition="MACLIB"/>
   </ld:concatenation>
   <ld:allocation name="SYSIN" input="true"/>
   <ld:allocation name="SYSPUNCH" dataSetDefinition="OBJ" member="true"/>
   <ld:allocation name="ANTPRINT" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT1" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT2" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT3" dataSetDefinition="TEMPFILE"/>
</ld:translator>

LangDefTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para crear una definición de idioma.
Tabla 4. Parámetros de LangDefTask
Atributo Descripción
nombre Nombre de definición de idioma
descripción Descripción de la definición de idioma
conversores Nombres de conversores, delimitado por dos puntos
defaultExtension Extensión de archivo predeterminado asociado
Ejemplo
Lo siguiente es un ejemplo de LangDefTask:

<ld:langdef name="BMS" translators="ASMMAP,ASMDSECT"defaultExtension=”bms”/>

DeleteDsDefsTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para suprimir todas las definiciones de conjuntos de datos.
Ejemplo
Lo siguiente es un ejemplo de DeleteDsDefsTask:

<ld:deletedsdefs/>

DeleteTranslatorsTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para suprimir todos los conversores.
Ejemplo
Lo siguiente es un ejemplo de DeleteTranslatorsTask:

<ld:deletetranslators/>

DeleteLangDefsTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para suprimir todas las definiciones de idioma.
Ejemplo
Lo siguiente es un ejemplo de DeleteLangDefsTask:

<ld:deletelangdefs/>

ResolveMetadataTask

Por qué y cuándo se efectúa esta tarea
Utilice esta tarea para asociar zFiles con definiciones de idiomas y zFolders con definiciones de conjuntos de datos. Estas asociaciones están almacenadas en el subdirectorio .antzBuild de cada proyecto zComponent. Puede realizar una asociación entre zFiles y definiciones de idiomas utilizando la extensión zFile y el atributo defaultExtension de una definición de idiomas dada. Por ejemplo, si la definición de idioma COBOL tiene el atributo defaultExtension cbl, el zFile HELLO.cbl está asociado con esa definición de idioma. Puede realizar una asociación entre zFolders y definiciones de conjuntos de datos utilizando los nombres de zFolders y los nombres de las definiciones de conjuntos de datos. Por ejemplo, si tiene una definición de conjunto de datos llamada HELLO.COBOL, la zFolder HELLO.COBOL está asociada con la definición del conjunto de datos del mismo nombre.
Tabla 5.
Atributo Descripción Predeterminado
projectRoot Directorio raíz del proyecto zComponent Directorio donde está almacenado el script.
Ejemplo
Lo siguiente es un ejemplo de ResolveMetadataTask:

<ld:resolvemetadata/>
<ld:resolvemetadata projectRoot="../AnotherProject"/>

Limitaciones del generador de definiciones de idiomas

Por qué y cuándo se efectúa esta tarea
Lo siguiente son limitaciones del generador de definiciones de idioma de Rational Team Concert for System z :
  • El generador de definiciones de idioma no soporta sustituciones utilizando propiedades de compilación.
  • ResolveMetadataTask actualiza los metadatos aunque no realice cambios en las definiciones de conjuntos de datos asociados o definiciones de idiomas.