3270 Valor

Descripción General #

El comando 3270 Valor pertenece a la categoría de automatización para terminales de tipo TN3270. Su función principal es ingresar texto, valores numéricos o cadenas de caracteres dentro de un área editable o en la posición actual del cursor de la pantalla mainframe. Esto permite completar campos de entrada, enviar credenciales de acceso o cargar datos transaccionales de forma automatizada en sistemas legacy.

Ejemplo de Uso Rápido #

Imagina que estás automatizando el ingreso a un sistema mainframe corporativo:

• Luego de abrir la sesión con 3270 Conectar, ubicas el campo de entrada deseado.
• Configuras el comando 3270 Valor especificando el texto USUARIO01, junto con las coordenadas de fila y columna donde debe escribirse.
• Al ejecutarse, STELA desplaza el cursor a esa posición e ingresa el texto indicado, dejando el campo listo para enviar con 3270 Teclear.

Parámetros y Opciones #

Para ingresar información en la terminal, el comando utiliza los siguientes parámetros:

• Valor (requerido): Cadena de texto, número o variable con el valor que se desea ingresar en la pantalla TN3270.
• Fila (opcional): Número de fila dentro de la grilla de la terminal donde se posicionará el cursor para ingresar el valor, comenzando desde 1.
• Columna (opcional): Número de columna donde se posicionará el cursor para escribir el texto, comenzando desde 1.

Nota de configuración: Si se omiten los campos fila y columna, el comando escribirá el texto directamente en la posición donde se encuentre ubicado el cursor actualmente. Si se requiere repositionar el cursor antes de escribir, se deben especificar ambos parámetros obligatoriamente.

Ejemplos de Uso Avanzado #

• Ingreso de datos en la posición actual del cursor: Escribe el nombre de usuario directamente en la celda donde el sistema mainframe dejó el foco tras la conexión.
  • Configuración: valor: OPERADOR_01
• Carga de número de documento en coordenadas específicas: Lleva el cursor a una celda concreta e ingresa un número de identificación de cliente.
  • Configuración: valor: 45872123, fila: 7, columna: 18
• Carga dinámica usando variables de STELA: Ingresa el monto de una transferencia almacenado previamente en la variable importe_calculado en la franja inferior de la terminal.
  • Configuración: valor: importe_calculado, fila: 15, columna: 30

Errores Comunes y Soluciones #

• Error: El texto se escribe en una posición incorrecta o sobreescribe la etiqueta del campo.
  • Solución: Revisa las coordenadas de fila y columna configuradas. Recuerda que la pantalla TN3270 estándar se organiza en una matriz (habitualmente de 24 filas por 80 columnas) y que ambos parámetros deben ingresarse juntos si deseas mover el cursor.
• Error: La terminal no acepta los caracteres ingresados (Pantalla bloqueada / Keyboard Locked).
  • Solución: Verifica si el campo de destino es un área protegida (solo lectura) o si la terminal se encuentra bloqueada en estado X SYSTEM. En caso de bloqueo, envía una tecla de desbloqueo como [RESET] mediante 3270 Teclear antes de invocar 3270 Valor.
• Error: Se truncan los caracteres ingresados en el campo.
  • Solución: Comprueba la longitud máxima permitida por el campo en la terminal. Si la cadena de texto supera el número de columnas disponibles para ese campo de entrada, el exceso de caracteres será ignorado o pasará al siguiente campo disponible.