Ejecutar comandos CL de IBM i desde un shell SSH/PASE: system, qsh y las trampas de CCSID

Objetivo

Ejecutar un comando CL de IBM i desde una sesión SSH hacia PASE (el Portable Application Solutions Environment), capturar su salida y su estado de salida de forma fiable, y evitar sorpresas EBCDIC/ASCII.

Requisitos previos

• Acceso SSH al sistema IBM i (con SSHD iniciado; véase el artículo sobre software de código abierto en IBM i para el arranque automático).
• Saber si el comando CL de destino envía salida en spool, un mensaje de escape o texto sin más.

Pasos

1. Desde una llamada SSH no interactiva, ejecutar un único comando CL con la utilidad system de PASE, entrecomillando el comando CL como una sola cadena:

   ssh -T user@ibmi-host 'system "DSPMSG QSYSOPR"'
   

   system es la utilidad de PASE para invocar comandos de IBM i; por defecto, la salida en spool que produce el comando y los mensajes que envía se escriben en la salida estándar o en el error estándar, que SSH retransmite al shell que hizo la llamada, y system termina con un código distinto de cero cuando el comando CL acaba con un mensaje de escape.
2. Para un comando que necesite específicamente el entorno Qshell (QSH) (algunas utilidades, como db2 de Qshell, solo existen ahí), ejecutarlo de forma no interactiva con system "QSH CMD('...')" (QSH es un alias de STRQSH) en lugar de abrir una sesión interactiva de Qshell, que no resulta adecuada para llamadas desatendidas.
3. Capturar el estado de salida desde $? del shell tras el retorno de la llamada ssh; para QSH CMD(...), Qshell también envía el mensaje QSH0005 cuando el proceso del comando termina con normalidad, con su estado de salida incluido, y QSH0006 si terminó por señal. Fijar la variable de entorno QIBM_QSH_CMD_ESCAPE_MSG en Y convierte una salida distinta de cero en un mensaje de escape, de modo que system (y los llamadores CL) detectan el fallo; conviene revisar el registro del trabajo si $? por sí solo resulta ambiguo.
4. Antes de confiar en la salida de texto byte a byte, confirmar el CCSID del trabajo (DSPJOB OPTION(*DFNA) muestra el juego de caracteres codificado y el CCSID por defecto). Los trabajos CL funcionan en EBCDIC; PASE se basa en ASCII. Las utilidades system y Qshell convierten los datos en la entrada/salida/error estándar, y un CCSID de trabajo de 65535 («sin conversión», el valor de QCCSID tal como se distribuye) es una causa frecuente de caracteres corruptos. Los archivos dentro de QSYS.LIB no se pueden crear con un CCSID ASCII a través del sistema de archivos integrado, de modo que los datos leídos directamente de QSYS.LIB con una herramienta de PASE como cat llegan en el CCSID EBCDIC del miembro y necesitan una conversión explícita.

Resultado esperado

La salida de un único comando y un código de salida/retorno fiable, sin necesidad de abrir una sesión interactiva 5250 o de Qshell en cada llamada.

Límites y base de verificación

El comportamiento descrito aquí sigue las páginas de IBM Support citadas, redactadas para versiones de IBM i 7.x; conviene verificar los identificadores exactos de los mensajes y los valores por defecto en la versión de destino antes de confiar en ellos en una canalización desatendida. No se afirma ningún experimento ni medición.