IBM i para un agente acostumbrado a Linux/Windows: objetos y bibliotecas en lugar de archivos y rutas

Qué es

IBM i (antes OS/400, se ejecuta sobre hardware Power, versiones 7.4/7.5/7.6) no tiene en su núcleo un concepto nativo de jerarquía de archivos al estilo Unix. Todo lo que gestiona el sistema — programas, archivos físicos y lógicos de base de datos, áreas de datos, perfiles de usuario, descripciones de trabajo — es un objeto tipado, identificado por un nombre de hasta 10 caracteres, un tipo de objeto (*PGM, *FILE, *USRPRF, etc.) y la biblioteca que lo contiene. Una biblioteca es a su vez un objeto de tipo *LIB; es un contenedor plano, no un directorio, y no puede anidar otras bibliotecas (todas las bibliotecas son objetos dentro de la biblioteca especial QSYS).

Donde un proceso de Linux resuelve un nombre de comando desnudo mediante $PATH, un trabajo de IBM i resuelve un nombre de objeto desnudo mediante su lista de bibliotecas (*LIBL): una lista ordenada de bibliotecas formada por una parte del sistema (hasta 15 bibliotecas, incluida QSYS), bibliotecas de producto opcionales, la biblioteca actual del trabajo (*CURLIB) y una parte de usuario. Cualquier referencia sin calificar como MYPGM (comandos como DSPLIB son a su vez objetos *CMD resueltos de la misma manera) busca en la lista de bibliotecas del trabajo, a menos que el nombre esté calificado como LIBRARY/OBJECT. Dos trabajos con listas de bibliotecas distintas pueden invocar el mismo MYPGM sin calificar y ejecutar programas diferentes — el equivalente en IBM i de un error de eclipsado (shadowing) de $PATH; un MYLIB/MYPGM calificado no se ve afectado.

Los nombres de comando suelen seguir un patrón: una abreviatura de verbo de tres letras más una o más abreviaturas de sustantivo, por ejemplo CRTLIB (Create Library), DLTLIB (Delete Library), DSPLIB (Display Library), WRKACTJOB (Work with Active Jobs). Una vez que un agente ha descifrado un puñado de verbos (CRT, DLT, DSP, WRK, CHG, STR, END) y sustantivos (LIB, OBJ, JOB, USRPRF), la mayoría de los nombres de comando se vuelven deducibles en lugar de tener que memorizarse.

Para las herramientas orientadas a archivos, el Integrated File System (IFS) expone todo el espacio de objetos bajo /QSYS.LIB/LIBRARY.LIB/OBJECT.TYPE, por ejemplo /QSYS.LIB/QGPL.LIB/MYPGM.PGM. Esto permite que un find o un ls desde un shell PASE vea los objetos tradicionales, pero la página de soporte de IBM citada describe QSYS.LIB principalmente como un sistema de archivos para archivos de base de datos y otros objetos de biblioteca, no como un sistema de archivos de flujo de propósito general: la E/S de flujo solo funciona con unos pocos tipos de objeto (como miembros de archivos físicos y archivos de guardado), y muchas operaciones habituales en / o /home no son compatibles allí.

Por qué importa

Un agente que trate IBM i como «Linux con comandos poco habituales» diagnosticará mal errores de «archivo no encontrado» que en realidad son problemas de la lista de bibliotecas, e intentará operaciones de sistema de archivos contra QSYS.LIB que el modelo de objetos no admite.

Cómo aplicarlo

• Antes de buscar un objeto, preguntar qué lista de bibliotecas se aplica al trabajo actual, no solo cómo se llama el objeto.
• Leer la calificación LIBRARY/OBJECT como se leería una ruta absoluta; tratar los nombres sin calificar como relativos a *LIBL.
• Descifrar los nombres de comandos CL poco familiares como verbo+sustantivo antes de asumir que se trata de una función no documentada.
• Evitar las operaciones de flujo del IFS (renombrar en el lugar, escrituras de bytes arbitrarias) dentro de /QSYS.LIB; usar en su lugar comandos CL (CRT*, CPY*, DLT*) para el ciclo de vida de los objetos.

Trampas

• Suponer que una biblioteca es un directorio que puede contener subbibliotecas; no puede.
• Suponer que *LIBL es algo que el shell del agente controla como $PATH; es un atributo por trabajo, inicializado a partir de la descripción de trabajo o de los valores del sistema QSYSLIBL/QUSRLIBL y modificado con CHGLIBL/ADDLIBLE, de modo que un trabajo distinto (por ejemplo, un trabajo por lotes enviado) puede ver una lista diferente.