---
title: 3270 Leer
description: "##### Descripción General El comando **3270 Leer** pertenece a la categoría de automatización para terminales de tipo **TN3270**. Su función principal es extraer una secuencia o tramo de caracteres visible en una fila específica de la pantalla del mainframe y…"
url: "https://www.stela.ai/wiki/3270-leer/"
updated: "2026-10-02"
category: TN3270
---

# 3270 Leer

##### Descripción General

El comando **3270 Leer** pertenece a la categoría de automatización para terminales de tipo **TN3270**. Su función principal es extraer una secuencia o tramo de caracteres visible en una fila específica de la pantalla del mainframe y almacenarla dentro de una variable de STELA. Esto permite capturar números de transacción, estados de proceso, importes o cualquier texto emitido por el sistema legacy para reutilizarlo en pasos posteriores del flujo o contrastarlo mediante validaciones.

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

##### Ejemplo de Uso Rápido

Imagina que estás automatizando un flujo de consulta de facturas en un mainframe y necesitas obtener el código de confirmación generado por el sistema tras procesar la solicitud:

- Utilizas el comando `3270 Leer` indicando la fila (por ejemplo, fila 12) y las columnas donde aparece el código en pantalla (desde la columna 5 a la 28).
- Especificas el nombre de la variable de STELA (por ejemplo, `mensaje_estado`) donde quieres que se guarde la información.
- El robot lee esa región exacta y asigna el texto extraído a la variable, permitiendo que un comando posterior como `si` valide si la operación fue exitosa.

##### Parámetros y Opciones

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

![Parámetros Comando 3270 Leer STELA](https://www.stela.ai/wp-content/uploads/2026/10/image-8.png)

- **Fila** (requerido): Número de fila de la pantalla TN3270 donde se encuentra el texto a leer, comenzando desde la posición `1`.
- **Inicio** (requerido): Número de columna donde empieza la secuencia de caracteres que se desea capturar.
- **Fin** (requerido): Número de columna donde termina el tramo de texto a extraer.
- **Variable** (requerido): Nombre de la variable de STELA en la cual se guardará la cadena de texto leída.

##### Ejemplos de Uso Avanzado

- **Lectura de estado o mensaje del sistema:** Captura el mensaje informativo emitido en la franja inferior o de notificaciones de la pantalla mainframe.
  - Configuración: **fila**: `23`, **inicio**: `1`, **fin**: `80`, **variable**: `mensaje_notificacion`
- **Extracción de un identificador numérico fijo:** Extrae un número de cuenta o folio ubicado en una posición fija de la terminal para usarlo en otra aplicación web o de escritorio.
  - Configuración: **fila**: `5`, **inicio**: `15`, **fin**: `26`, **variable**: `numero_cuenta_extraido`
- **Validación de cambio de pantalla o cabecera:** Lee el título de la pantalla para asegurar que la navegación entre transacciones del mainframe ocurrió correctamente.
  - Configuración: **fila**: `1`, **inicio**: `30`, **fin**: `50`, **variable**: `titulo_pantalla_actual`

##### Errores Comunes y Soluciones

- **Error: La variable queda vacía o con caracteres desplazados.**
  - **Solución:** Verifica que las coordenadas ingresadas en **inicio** y **fin** se correspondan exactamente con la rejilla visual de la terminal TN3270. Ten en cuenta que la numeración de columnas comienza en `1` y la pantalla estándar suele ser de 80 columnas de ancho.
- **Error: Se lee una pantalla desactualizada o incompleta.**
  - **Solución:** Asegúrate de invocar el comando `3270 Espera` (por ejemplo, esperando a que aparezca un texto o que el cursor cambie de posición) antes de ejecutar `3270 Leer`, garantizando que el mainframe haya terminado de procesar y renderizar la pantalla.
- **Error: La lectura falla por falta de sesión activa.**
  - **Solución:** Confirma que se haya ejecutado con éxito el comando `3270 Conectar` al inicio de la automatización para mantener activa la sesión con el emulador.