3270 Info

Descripción General #

El comando 3270 Info pertenece a la categoría de automatización para terminales de tipo TN3270. Su función principal es consultar las propiedades y metadatos de un objeto de campo mapeado dentro de la pantalla emulada y almacenar ese valor en una variable de STELA. Esto permite inspeccionar dinámicamente si un campo en la terminal de mainframe está en modo solo lectura (protegido), su contenido de texto actual o su ubicación exacta dentro de la grilla de pantalla antes de interactuar con él.

Ejemplo de Uso Rápido #

Imagina que necesitas validar si un formulario del mainframe bloqueó el ingreso de datos tras procesar una solicitud:

• Utilizas el comando 3270 Info seleccionando el campo CampoCuenta3270 y la propiedad Protegido.
• Almacenas el valor devuelto en la variable es_protegido.
• Un comando condicional posterior (si) puede evaluar el valor de es_protegido para determinar si el flujo debe continuar llenando datos o proceder con la desconexión.

Parámetros y Opciones #

Para realizar la consulta de un campo en la terminal, se deben configurar los siguientes parámetros:

• Campo (requerido): Objeto tipo campo previamente definido en el mapa de objetos que representa la celda o área en la terminal TN3270.
• Propiedad (requerido): Característica del campo que se desea consultar.
  • Valores habituales:
    • ID: Devuelve el identificador único del campo en el mapa de objetos.
    • Valor: Retorna la cadena de texto visible contenida en el campo.
    • Protegido: Devuelve un estado indicando si el campo es de solo lectura o si permite edición.
    • Tipo de Campo: Retorna la clasificación técnica del campo según la emulación TN3270.
    • Fila: Devuelve la coordenada de fila donde inicia el campo.
    • Columna: Devuelve la coordenada de columna donde inicia el campo.
• Variable (requerido): Nombre de la variable de STELA en la que se almacenará el valor de la propiedad consultada.

Ejemplos de Uso Avanzado #

• Lectura del valor de un campo mapeado: Consulta y guarda en una variable el texto contenido en el campo de cuenta corriente de la terminal.
  • Configuración: campo: CampoCuenta3270, propiedad: Valor, variable: cuenta_leida
• Verificación de campo protegido (Solo Lectura): Obtiene el estado de protección de un campo para confirmar si la pantalla del mainframe está habilitada para edición.
  • Configuración: campo: CampoCuenta3270, propiedad: Protegido, variable: cuenta_protegida
• Inspección de la ubicación de un campo dinámico: Consulta la posición de fila de un campo en pantalla para registrar las coordenadas exactas antes de enviar un comando por posición.
  • Configuración: campo: CampoDetalle3270, propiedad: Fila, variable: posicion_fila

Errores Comunes y Soluciones #

• Error: El campo indicado no se encuentra en el mapa o no está visible.
  • Solución: Verifica que el parámetro campo corresponda a un objeto mapeado correctamente y que la pantalla actual del emulador sea la esperada antes de invocar 3270 Info.
• Error: La variable obtiene un valor vacío o nulo.
  • Solución: Asegúrate de haber ejecutado previamente un comando de sincronización como 3270 Espera para dar tiempo a que el mainframe renderice completamente los campos de la pantalla.
• Error: Falla de ejecución por falta de conexión activa.
  • Solución: Valida que la sesión TN3270 permanezca abierta mediante 3270 Conectar y que la emulación no se haya desconectado por inactividad.