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.
- 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 .
- 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?
- 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.
- Asegúrese de que no haya conexiones activas entre el RAM PDS de muestra, CARMA y el
sistema host antes de continuar.
- 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).
- 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.
- 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).