Rational Developer for System z


Lección 1.1: Personalizar el RAM PDS añadiendo una acción personalizada y parámetros al modelo

Esta lección le guiará brevemente en los pasos necesarios para añadir la acción personalizada HowTo y sus cuatro parámetros: value, string1, string2 y option, al RAM PDS.
Estos parámetros y acciones se añaden al RAM PDS suministrando la información adecuada al archivo CRA0VDEF. Para obtener más información acerca de los pasos de esta lección, consulte la Guía del desarrollador de CARMA, Capítulo 4. Personalizar una API de RAM mediante CAF.
  1. Empiece por indicar la acción o acciones que desea para ampliar la API del RAM. En este ejemplo, añadirá una acción personalizada, HowTo, con los atributos siguientes:
    • Nombre: HowTo
    • Descripción: Suministra un ejemplo de implementación de proyectos de plug-in con puntos de ampliación
    • ID de acción: 100
    • ID de RAM: 00
    • Lista de parámetros value, string1, string2, option
    • Lista de valores de retorno:
    Consejo: Si utiliza el PDS de muestra que se suministra sin personalización, los valores siguientes correspondientes al ID de acción y al ID de RAM deberían ser correctos; sin embargo, si ha añadido o eliminado RAMs, acciones personalizadas o parámetros, compruebe que el ID de acción sea el próximo ID de acción disponible y que el ID de RAM corresponda al RAM PDS de muestra .
  2. En la descripción de la acción personalizada HowTo anterior figuran parámetros y valores de retorno. Cada uno de ellos debe definirse también dentro del RAM. Las descripciones de cada uno de ellos son las siguientes:
    • Nombre: value
    • Descripción: un valor numérico de un dígito
    • ID de parámetro: 000
    • ID de RAM: 00
    • Tipo: string
    • Longitud: 1
    • Constante: no
    • Valor predeterminado: ninguno
    • Solicitud: Especifique un valor de un dígito:
    • Nombre: string1
    • Descripción: una serie de texto
    • ID de parámetro: 001
    • ID de RAM: 00
    • Tipo: string
    • Longitud: 10
    • Constante: no
    • Valor predeterminado: ninguno
    • Solicitud: Especifique una serie de texto corta:
    • Nombre: string2
    • Descripción: una serie de texto
    • ID de parámetro: 002
    • ID de RAM: 00
    • Tipo: string
    • Longitud: 10
    • Constante: no
    • Valor predeterminado: ninguno
    • Solicitud: Especifique una serie de texto corta:
    • Nombre:option
    • Descripción: opción de sí o no
    • ID de parámetro: 003
    • ID de RAM: 00
    • Tipo: string
    • Longitud: 1
    • Constante: no
    • Valor predeterminado: ninguno
    • Solicitud: ¿Sí o No?
  3. Conocer las acciones, parámetros y descripciones de cada uno le ayudará a crear las declaraciones que deben incluirse en el archivo de configuraciones. Cada acción y parámetro se definirá en su propia línea y sus metadatos particulares se especificarán dentro de una longitud de bytes predefinida.
    Consejo: También puede definir las acciones y parámetros sin utilizar los tamaños de bytes predefinidos para los metadatos utilizando tabulaciones como delimitador. Asegúrese de consultar la Guía del desarrollador de CARMA, Capítulo 4. Personalizar una API de RAM mediante CAF para conocer los detalles de este formato alternativo.

    En este ejemplo, utilizando los tamaños de bytes predefinidos, la acción personalizada HowTo se declara como:

    A00100  000,001,002,003|

    Para cada uno de los parámetros respectivos, la declaración es:

    P00000  STRING          1               N
    P00001  STRING          10              N
    P00002  STRING          10              N
    P00003  STRING          1               N
    Nota: Tanto para las acciones como para los parámetros, los ocho primeros bytes del registro se denominan clave de registro.
  4. Asegúrese de que no haya conexiones activas entre el RAM PDS de muestra, CARMA y el sistema host antes de continuar.
  5. Debe añadir esta información a FEK.SFEKVSM2(CRA0DEF) y asegurarse de que todas las claves de registro estén en orden alfanumérico. Utilice el script JCL ubicado en FEK.#CUST.JCL(CRA$VDEF) para REPRO FEK.SFEKVSM2(CRA0DEF).
  6. A continuación, para cada acción y parámetro que defina en el archivo CRA0VDEF, deberá especificar una definición correspondiente en el archivo CRA0VSTR que contenga la información dependiente de idioma acerca de la acción o el parámetro.
    En este ejemplo, la acción personalizada debe definirse en CRA0VSTR del siguiente modo:
    ES_ES   00037A00100  HowTo           Para demostración. No hace
    nada.
    Para cada parámetro respectivo del ejemplo, las definiciones son:
    ES_ES   00037P00000  value                      Especifique un valor numérico de un dígito.
    ES_ES   00037P00001  string1                         Especifique una serie de texto breve.
    ES_ES   00037P00002  string2                         Especifique una serie de texto breve.
    ES_ES   00037P00003  option                          ¿Y/N?
    Nota: Tanto para las acciones como para los parámetros, los primeros veintiún bytes del registro se denominan clave de registro.
  7. Debe añadir esta información al archivo FEK.SFEKVSM2(CRA0VSTR) y asegurarse de que todos los registros estén en orden alfanumérico. Utilice el script JCL ubicado en FEK.#CUST.JCL(CRA$VSTR) para REPRO FEK.SFEKVSM2(CRA0VSTR).

Referencias


Términos de uso | Comentarios



Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)