Exécuter des commandes CL IBM i depuis un shell SSH/PASE : system, qsh et pièges liés au CCSID

Objectif

Exécuter une commande CL IBM i depuis une session SSH vers PASE (Portable Application Solutions Environment), en récupérer la sortie et le code de retour de façon fiable, et éviter les mauvaises surprises liées à EBCDIC/ASCII.

Prérequis

• Un accès SSH au système IBM i (SSHD démarré ; pour le démarrage automatique, voir l'article sur les logiciels open source sur IBM i).
• Savoir si la commande CL visée produit une sortie spoule, un message d'escape ou du texte simple.

Étapes

1. Depuis un appel SSH non interactif, exécuter une seule commande CL avec l'utilitaire PASE system, en passant la commande CL entre guillemets comme une seule chaîne :

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

   system est l'utilitaire PASE destiné à appeler des commandes IBM i. Par défaut, la sortie spoule produite par la commande et les messages qu'elle envoie sont écrits sur la sortie standard ou sur l'erreur standard, que SSH renvoie au shell appelant ; system se termine avec un code non nul lorsque la commande CL s'achève par un message d'escape.
2. Pour une commande qui exige spécifiquement l'environnement Qshell (QSH) (certains utilitaires, comme db2 de Qshell, n'existent que là), l'exécuter de manière non interactive avec system "QSH CMD('...')" (QSH est un alias de STRQSH), plutôt que d'ouvrir une session Qshell interactive, qui ne convient pas aux appelants non supervisés.
3. Récupérer le code de retour dans $? du shell une fois l'appel ssh terminé. Pour QSH CMD(...), Qshell envoie en outre le message QSH0005 lorsque le processus de la commande se termine normalement, avec son code de sortie, et QSH0006 s'il s'est terminé sur un signal. Définir la variable d'environnement QIBM_QSH_CMD_ESCAPE_MSG à Y transforme un code de sortie non nul en message d'escape, de sorte que system (et les appelants CL) voient l'échec ; consulter le journal du job si $? seul est ambigu.
4. Avant de se fier octet pour octet à une sortie texte, vérifier le CCSID du job (DSPJOB OPTION(*DFNA) affiche le jeu de caractères codés et le CCSID par défaut). Les jobs CL travaillent en EBCDIC, alors que PASE repose sur l'ASCII. Les utilitaires system et Qshell convertissent les données de l'entrée, de la sortie et de l'erreur standard ; un CCSID de job de 65535 (« aucune conversion », valeur livrée de QCCSID) est une cause fréquente de caractères illisibles. Les fichiers situés dans QSYS.LIB ne peuvent pas être créés avec un CCSID ASCII via le système de fichiers intégré ; les données lues directement dans QSYS.LIB avec un outil PASE tel que cat arrivent donc dans le CCSID EBCDIC du membre et nécessitent une conversion explicite.

Résultat attendu

La sortie d'une commande et un code de sortie/retour fiable, sans ouvrir de session interactive 5250 ou Qshell à chaque appel.

Limites et base de vérification

Le comportement décrit ici suit les pages de support IBM citées, rédigées pour les versions IBM i 7.x ; vérifier les identifiants de message et les valeurs par défaut exacts sur la version cible avant de s'y fier dans un pipeline non supervisé. Aucune expérience ni mesure n'est revendiquée.