Descripción General #
El comando {conectar IBMi} pertenece a la categoría de comandos para sistemas de terminales IBM i | AS/400. Su propósito principal es abrir y establecer una sesión de comunicación interactiva contra un servidor remoto IBM i, permitiendo que el robot de STELA tome control de la interfaz y pueda operar sobre la terminal de texto en los pasos siguientes de la automatización.
Ejemplo de Uso Rápido #
Imagina que tu empresa gestiona el inventario o las cuentas principales en un sistema centralizado AS/400. Antes de que el robot pueda ingresar credenciales o consultar información, necesita conectarse a la terminal corporativa.
Con este comando, configuras la conexión inicial especificando la dirección del servidor (Host) y el puerto de comunicaciones para que se despliegue de forma correcta la pantalla de inicio de sesión.
Parámetros y Opciones #
Para que STELA pueda abrir la sesión del emulador, debes configurar los siguientes parámetros:
- URL(obligatorio; tipos: string, constant, variable, extended): Especifica el host, dirección IP o nombre de dominio del servidor IBM i al que deseas conectarte.
- Puerto (tipos: natural, constant, variable, extended): Define el puerto de red para establecer la conexión con el emulador. Si se omite, o si tu organización utiliza la configuración estándar, el valor habitual es el puerto 23.
- Nombre del dispositivo (tipos: string, constant, variable, extended): Indica el nombre específico del dispositivo o identificador de sesión (por ejemplo, QPADEV0001) asignado por el administrador del sistema. Se puede dejar vacío si el entorno no requiere un nombre de sesión fijo.
Ejemplos de Uso Avanzado #
- Conexión estándar a entorno de pruebas: Apertura de una sesión interactiva básica apuntando al servidor de desarrollo de la empresa a través del puerto por defecto. {conectar IBMi} ; as400.qa.empresa.com ; 23 ;
- Conexión con asignación de dispositivo específico: Establecimiento de comunicación con un servidor de producción requiriendo un nombre de dispositivo virtual específico para cumplir con las políticas de auditoría y acceso de la plataforma. {conectar IBMi} ; as400.produccion.empresa.com ; 23 ; QPADEV0005
Errores Comunes y Soluciones #
- Error: La sesión no se inicia y el comando posterior (como {valor IBMi} o {teclear IBMi}) falla de inmediato.
- Solución: El comando {conectar IBMi} debe ser obligatoriamente la primera instrucción del bloque de comandos IBMi. Asegúrate de colocarlo al inicio del flujo para abrir el canal de comunicación antes de intentar interactuar con la pantalla.
- Error: Tiempo de espera agotado al conectar (Timeout / Host inalcanzable).
- Solución: Verifica que la dirección IP o dominio configurado en el parámetro url sea correcto. Si el parámetro está bien configurado, comprueba que el agente de ejecución de STELA tenga los permisos de red necesarios (o acceso VPN) para alcanzar el puerto 23 del servidor AS/400.
- Error: El servidor rechaza la conexión por dispositivo duplicado o no disponible.
- Solución: Si estás ingresando un valor en el campo dispositivo, asegúrate de que no esté siendo utilizado por otra sesión activa del emulador o por otro robot en paralelo. Deja el campo vacío si el servidor está configurado para asignar nombres de terminal de forma dinámica.