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.

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:

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