3270 Pantalla

Descripción General #

El comando 3270 Pantalla pertenece a la categoría de automatización para terminales de tipo TN3270. Su función principal es extraer el contenido de texto completo de la sesión emulada o un rango específico de filas dentro de la grilla de la terminal. Esto permite capturar bloques enteros de datos para auditar pantallas, parsear líneas individuales o realizar validaciones funcionales cuando no se conoce la columna exacta de un texto.

Ejemplo de Uso Rápido #

Imagina que necesitas extraer el encabezado o una grilla de datos completa de un mainframe para verificar si la pantalla cargada es la correcta:

• Configuras el comando 3270 Pantalla indicando las filas que deseas capturar (por ejemplo, desde la fila 1 hasta la fila 10).
• Especificas la variable de STELA en la que deseas almacenar el contenido (por ejemplo, encabezado_3270).
• Al ejecutarse, STELA lee el tramo de texto seleccionado y lo guarda en la variable para su posterior evaluación mediante un comando condicional como si.

Parámetros y Opciones #

Para realizar la lectura de la pantalla, el comando requiere la configuración de los siguientes campos:

• Inicio (opcional): Número de fila inicial desde donde se comenzará la lectura de la terminal, comenzando en 1.
• Fin (opcional): Número de fila final hasta la cual se extenderá la captura de datos.
• Variable (requerido): Nombre de la variable principal de STELA donde se almacenará el texto extraído.

Nota de comportamiento: Si se omiten los parámetros inicio y fin, el comando capturará automáticamente la totalidad de las filas visibles de la pantalla emulada. Además del texto consolidado, STELA genera variables individuales por cada fila leída para facilitar el análisis renglón por renglón.

Ejemplos de Uso Avanzado #

• Lectura completa de la pantalla emulada: Captura la totalidad de las filas de la terminal activa para auditoría o búsqueda global de patrones.
  • Configuración: inicio: (vacío), fin: (vacío), variable: pantalla_3270
• Extracción de la franja de encabezado: Obtiene las primeras seis filas de la terminal para validar el título del menú y la fecha del sistema mainframe.
  • Configuración: inicio: 1, fin: 6, variable: encabezado_3270
• Lectura de la sección de mensajes e instructivos: Lee las líneas inferiores de la pantalla donde habitualmente los sistemas TN3270 despliegan los mensajes de error o atajos de teclado disponibles.
  • Configuración: inicio: 22, fin: 24, variable: pie_pantalla_3270

Errores Comunes y Soluciones #

• Error: El texto capturado aparece desalineado o incompleto.
  • Solución: Confirma que el número de fila ingresado en fin no supere la cantidad de filas soportadas por la terminal configurada (por ejemplo, 24 o 43 filas en modelos TN3270 estándar).
• Error: Se lee una pantalla en blanco o con datos desactualizados.
  • Solución: Incluye un comando 3270 Espera antes de ejecutar 3270 Pantalla. Esto asegura que el servidor mainframe haya finalizado el envío de datos y la terminal haya terminado de renderizar la información.
• Error: Falla la lectura por falta de conexión.
  • Solución: Comprueba que la sesión con el servidor mainframe se encuentre activa mediante el comando 3270 Conectar ejecutado previamente en el flujo.