Rational Developer para System z, Versión 7.6

Paso 3.2: añadir elementos de mensaje a los archivos de mensaje

En este paso añadirá un elemento de mensaje al mensaje de entrada, al mensaje de salida y al mensaje de variables del flujo CheckItemAvailability.seqflow. Además, suprimirá elementos de mensaje que se hayan añadido automáticamente al mensaje de salida durante la creación de acciones Extraer durante el registro de flujo.

Basándose en los nombres predeterminados que ha aceptado en el asistente Nuevo registro de flujo (consulte la sección Paso 2.4: registrar el flujo), se han creado automáticamente los siguientes archivos de mensaje, mensajes y elementos de mensaje para CheckItemAvailability.seqflow:
Tabla 1. Artefactos de mensajes creados para CheckItemAvailability.seqflow
Tipo de archivo de mensaje: Archivo de mensaje: Mensaje: Elementos de mensaje:
Entrada i_CheckItemAvailability.sfmxsd i_CheckItemAvailability (Ninguno)
Salida o_CheckItemAvailability.sfmxsd o_CheckItemAvailability Un elemento de mensaje para cada acción Extraer en el flujo registrado
Variable v_CheckItem- Availability.sfmxsd v_CheckItemAvailability Un elemento de mensaje para cada acción Extraer en el flujo registrado
En esta sección se explica cómo añadir un elemento de mensaje a cada uno de los tres mensajes:
Tabla 2. Elementos de mensaje que deben añadirse
Mensaje: Elemento de mensaje que debe añadirse: Tipo de datos del elemento de mensaje:
i_CheckItemAvailability itemNumber xsd:string
o_CheckItemAvailability available xsd:string
v_CheckItemAvailability available1 xsd:string
1Para obtener más información sobre esta variable, consulte el tema Utilización de v_CheckItemAvailability.available en el flujo CheckItemAvailability.seqflow

Asimismo, en esta sección suprimirá los elementos de mensaje Extraer del mensaje de salida. Si ha creado acciones Extraer durante el registro de flujo (consulte el Paso 2.4: registrar el flujo), el registrador de flujo ha creado automáticamente una variable (elemento de mensaje) para cada acción Extraer del mensaje de variables y del mensaje de salida (consulte la cuarta columna de la Tabla 1). Deberá suprimir esos elementos de mensaje de extracción del mensaje de salida solamente. No suprima los elementos de mensaje Extraer del mensaje de variables.

Mensaje de entrada

En este subtema añadirá el elemento de mensaje itemNumber al mensaje de entrada. Este elemento de mensaje es un parámetro de entrada que especifica un número de artículo que hay que buscar en la lista de artículos del catálogo de la aplicación de catálogo de ejemplo de CICS.

Para añadir el elemento de mensaje:

  1. Abra el archivo de mensaje de entrada:
    1. En el Explorador de proyectos EST, pulse con el botón derecho del ratón sobre CatalogSample > CatalogSample.Interface > Mensajes > i_CheckItemAvailability.
    2. Pulse Abrir con > Editor de mensajes de flujo.

  2. Añada el elemento de mensaje:

    Tabla 3. Crear el elemento de mensaje itemNumber
    Acción: Artículo: Interfaz de usuario:
    a) Pulse la pestaña Básico Editor de mensajes de flujo
    b) Pulse con el botón derecho del ratón i_CheckItemAvailability.sfmxsd > i_CheckItemAvailability Editor de mensajes de flujo, pestaña Básico, panel izquierdo
    c) Pulse Añadir elemento
    d) Pulse localElement1
    e) Escriba itemNumber Editor de mensajes de flujo, pestaña Básico, panel derecho, campo Nombre
    f) Pulse la pestaña Avanzado Editor de mensajes de flujo
    g) Pulse i_CheckItemAvailability.sfmxsd > Mensajes > i_CheckItemAvailability > itemNumber Editor de mensajes de flujo, pestaña Avanzado
    h) Pulse La celda en la columna Tipo a la derecha de itemNumber
    i) Desplácese en la lista y seleccione (Nueva restricción de tipo simple) La lista desplegable que se abre cuando pulsa la celda vacía en el paso anterior.
    j) Desplácese en la lista y seleccione xsd:string La lista desplegable Tipo base La ventana Nueva restricción de tipo simple
    k) Pulse Aceptar
    l) Pulse i_CheckItemAvailability.sfmxsd > Mensajes > i_CheckItemAvailability > itemNumber > xsd:string1 Editor de mensajes de flujo, pestaña Avanzado
    m) Pulse la pestaña Propiedades Editor de mensajes de flujo
    n) Pulse Propiedades lógicas > Restricciones de valores Editor de mensajes de flujo, pestaña Propiedades, panel izquierdo
    o) Déjelo en blanco Campo Longitud Editor de mensajes de flujo, pestaña Propiedades, grupo Restricciones de longitud
    p) Déjelo en blanco Campo Mín
    o) Escriba 42

    Consulte PRECAUCIÓN.

    Campo Máx
    q) Pulse la pestaña Básico Editor de mensajes de flujo
    1Tenga en cuenta que aquí el tipo de la variable itemNumber está definido como xsd:string en lugar de xsd:integer. La razón es que así, en una comparación como la siguiente, ambos operandos tienen el mismo tipo (xsd:string):
    (i_CheckItemAvailability.itemNumber = v_CheckItemAvailability."INQ1-ITEMREF")

    2Aquí, la longitud máxima (la restricción Máx) se establece en 4 caracteres porque el número máximo de artículos es 9999.

  3. Cierre el editor de mensajes de flujo.

Mensaje de salida

En este subtema, suprimirá las variables Extraer (elementos de mensaje) del mensaje de salida. Estas variables Extraer se han añadido automáticamente al mensaje de salida por comodidad al crear las acciones Extraer. A continuación, suprimirá estas variables Extraer porque, en esta guía de aprendizaje, el flujo CheckItemAvailability.seqflow no necesita devolver los valores Extraer al programa de llamada (consulte la Tabla 1).

También se añadirá un elemento de mensaje available al mensaje de salida. Este elemento de mensaje es un parámetro de salida que devuelve al programa de llamada una copia del valor del elemento de mensaje available en el mensaje de variables (la serie YES o una serie vacía).

Para suprimir las variables Extraer (elementos de mensaje):

  1. Abra el archivo de mensaje de variables:
    1. En el Explorador de proyectos EST, pulse con el botón derecho del ratón sobre CatalogSample > CatalogSample.Interface > Mensajes > o_CheckItemAvailability.
    2. Pulse Abrir con > Editor de mensajes de flujo.

  2. Pulse la pestaña Básico.
  3. Para suprimir el primer elemento de mensaje:
    1. En el panel izquierdo del editor de mensajes de flujo, pulse con el botón derecho del ratón sobre o_CheckItemAvailability.sfmxsd > o_CheckItemAvailability > INQ1-ITEMREF.
    2. Pulse Suprimir.

  4. Repita las acciones del paso 3 para suprimir las demás variables Extraer, desde la INQ2-ITEMREF a la INQ15-ITEMREF.

  5. Pulse Control-S para guardar el trabajo. Deje abierto el editor de flujo de momento para que pueda añadir el elemento de mensaje available.

Para añadir el elemento de mensaje available:

  1. Abra el archivo de mensaje de salida si aún no está abierto.
  2. Añada el elemento de mensaje:

    Tabla 4. Crear el elemento de mensaje available del mensaje de salida
    Acción: Artículo: Interfaz de usuario:
    a) Pulse la pestaña Básico Editor de mensajes de flujo
    b) Pulse con el botón derecho del ratón o_CheckItemAvailability.sfmxsd > o_CheckItemAvailability Editor de mensajes de flujo, pestaña Básico, panel izquierdo
    c) Pulse Añadir elemento
    d) Pulse localElement1
    e) Escriba available Editor de mensajes de flujo, pestaña Básico, panel derecho, campo Nombre
    f) Pulse la pestaña Avanzado Editor de mensajes de flujo
    g) Pulse o_CheckItemAvailability.sfmxsd > Mensajes > o_CheckItemAvailability > available Editor de mensajes de flujo, pestaña Avanzado
    h) Pulse La celda en la columna Tipo a la derecha de available
    i) Desplácese en la lista y seleccione (Nueva restricción de tipo simple) La lista desplegable que se abre cuando pulsa la celda vacía en el paso anterior.
    j) Desplácese en la lista y seleccione xsd:string La lista desplegable Tipo base La ventana Nueva restricción de tipo simple
    k) Pulse Aceptar
    l) Pulse o_CheckItemAvailability.sfmxsd > Mensajes > o_CheckItemAvailability > available > xsd:string Editor de mensajes de flujo, pestaña Avanzado
    m) Pulse la pestaña Propiedades Editor de mensajes de flujo
    n) Pulse Propiedades lógicas > Restricciones de valores Editor de mensajes de flujo, pestaña Propiedades, panel izquierdo
    o) Déjelo en blanco Campo Longitud Editor de mensajes de flujo, pestaña Propiedades, grupo Restricciones de longitud
    p) Déjelo en blanco Campo Mín
    o) Escriba 31

    Consulte PRECAUCIÓN.

    Campo Máx
    q) Pulse la pestaña Básico Editor de mensajes de flujo

    1Aquí, la longitud máxima (la restricción Máx) se establece en 3 caracteres porque el valor será la serie YES o una serie vacía.

  3. Cierre el editor de mensajes de flujo.

Mensaje de variables

En este subtema, añadirá la variable available (elemento de mensaje) al mensaje de variables. Este elemento de mensaje indica si el número de artículo de entrada se ha encontrado en la lista de artículos del catálogo de la aplicación de catálogo de ejemplo de CICS. Si se encuentra el número de artículo, available se establece en la serie YES. De lo contrario, available se establece en una serie vacía (consulte el tema Utilización de v_CheckItemAvailability.available en el flujo CheckItemAvailability.seqflow).

Para añadir el elemento de mensaje:

  1. Abra el archivo de mensaje de variables:
    1. En el Explorador de proyectos EST, pulse con el botón derecho del ratón sobre CatalogSample > CatalogSample.Interface > Mensajes > v_CheckItemAvailability.
    2. Pulse Abrir con > Editor de mensajes de flujo.

  2. Añada el elemento de mensaje:

    Tabla 5. Crear el elemento de mensaje available
    Acción: Artículo: Interfaz de usuario:
    a) Pulse la pestaña Básico Editor de mensajes de flujo
    b) Pulse con el botón derecho del ratón v_CheckItemAvailability.sfmxsd > v_CheckItemAvailability Editor de mensajes de flujo, pestaña Básico, panel izquierdo
    c) Pulse Añadir elemento
    d) Pulse localElement1
    e) Escriba available Editor de mensajes de flujo, pestaña Básico, panel derecho, campo Nombre
    f) Pulse la pestaña Avanzado Editor de mensajes de flujo
    g) Pulse v_CheckItemAvailability.sfmxsd > Mensajes > v_CheckItemAvailability > available Editor de mensajes de flujo, pestaña Avanzado
    h) Pulse La celda en la columna Tipo a la derecha de available
    i) Desplácese en la lista y seleccione (Nueva restricción de tipo simple) La lista desplegable que se abre cuando pulsa la celda vacía en el paso anterior.
    j) Desplácese en la lista y seleccione xsd:string La lista desplegable Tipo base La ventana Nueva restricción de tipo simple
    k) Pulse Aceptar
    l) Pulse v_CheckItemAvailability.sfmxsd > Mensajes > v_CheckItemAvailability > available > xsd:string Editor de mensajes de flujo, pestaña Avanzado
    m) Pulse la pestaña Propiedades Editor de mensajes de flujo
    n) Pulse Propiedades lógicas > Restricciones de valores Editor de mensajes de flujo, pestaña Propiedades, panel izquierdo
    o) Déjelo en blanco Campo Longitud Editor de mensajes de flujo, pestaña Propiedades, grupo Restricciones de longitud
    p) Déjelo en blanco Campo Mín
    o) Escriba 31

    Consulte PRECAUCIÓN.

    Campo Máx
    q) Pulse la pestaña Básico Editor de mensajes de flujo

    1Aquí, la longitud máxima (la restricción Máx) se establece en 3 caracteres porque el valor será la serie YES o una serie vacía.

  3. Cierre el editor de mensajes de flujo.


Términos de uso | Comentarios

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