---
title: 3270 Pantalla
description: "##### 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…"
url: "https://www.stela.ai/wiki/3270-pantalla/"
updated: "2026-10-02"
category: TN3270
---

# 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.

![Comando 3270 Pantalla STELA](https://www.stela.ai/wp-content/uploads/2026/10/image-17.png)

##### 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:

![Parametros Comando 3270 Pantalla STELA](https://www.stela.ai/wp-content/uploads/2026/10/image-18.png)

- **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.