show

La sentencia show presenta un formulario de texto (incluyendo formularios en almacenamiento intermedio con la sentencia display) o procesa un registro VGUI de un programa principal:
  1. Compromete recursos recuperables, cierra archivos y libera bloqueos
  2. Opcionalmente, pasa un registro básico para que lo utilice el programa especificado en la cláusula returning (si existe) de la sentencia show
  3. Finaliza el primer programa
  4. Presenta el formulario de texto o procesa el registro VGUI

La sentencia show no está disponible en un programa llamada

Si está procesando un formulario de texto, se aplican las sentencias siguientes:
  • Si no incluye una cláusula returning, la operación finaliza cuando se visualiza el formulario de texto.
  • Si incluye una cláusula returning, un programa especificado recibe el control después de que el usuario pulse una tecla de evento. El formulario se asigna a la propiedad inputForm del programa receptor y el registro pasado (no cambiado por la entrada del usuario) se asigna al registro de entrada del programa receptor.
Si está procesando un registro VGUI, se aplican las sentencias siguientes:
  • Si no incluye una cláusula returning, la operación finaliza cuando se visualiza la página Web.
  • Si incluye una cláusula returning, un programa especificado de tipo VGWebTransaction recibirá el control después de que el usuario someta un formulario. Los datos de formulario se asignan a registroUI de entrada del programa receptor y el registro básico pasado (no cambiado por la entrada del usuario) se asigna al registro de entrada del programa.

Pasar el registro es opcional.


Diagrama de sintaxis para la sentencia show
nombreComponenteFormulario
Nombre del formulario de texto que es visible para el programa. Para obtener detalles acerca de la visibilidad, consulte el apartado Referencias a componentes. Si incluye una cláusula returning en la sentencia, el formulario de texto debe ser equivalente al formulario de texto especificado en la propiedad inputForm del programa que se invoca.
nombreRegistroVGUI
Nombre del registroVGUI que se presenta al usuario.
nombreDestino
Identificador del programa que se invoca una vez que el usuario ha sometido el formulario de texto o la página Web. Si el programa destino está en CICS, utilice el ID de transacción; de lo contrario, utilice el nombre del programa.
sysVar.transferName
Variable de sistema que contiene el identificador del programa o transacción que debe invocarse. Utilice esta variable para establecer el identificador durante la ejecución.
nombreRegistroBásico
Nombre de un registro de tipo basicRecord. El contenido se asigna al registro de entrada del programa receptor.
externallyDefined
Un indicador de que devuelve el control a un programa basado en CICS definido fuera de EGL o VisualAge Generator. Este indicador sólo está disponible si establece la propiedad de proyecto para la compatibilidad con VisualAge Generator.

Es aconsejable que un programa no generado por EGL se identifique como definido externamente no en la sentencia show, sino en el componente de opciones de enlace utilizado durante la generación. (La propiedad relacionada se encuentra en el componente de opciones de enlace, elemento transferToTransaction, y también se denomina externallyDefined). Sin embargo, puede realizar la identificación de cualquier manera.

Conceptos relacionados
Referencias a componentes

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.