D M=CONFIG: detectar desviaciones en estado de dispositivos
Hay veces que algún dispositivo puede quedarse offline por alguna incidencia sin que nos demos cuenta. O que, por error, se pongan online dispositivos en una LPAR que no corresponde.
Una forma de tener un aviso de cuando la configuración de los dispositivos no es la esperada es usar el miembro CONFIGxx y el comando D M=CONFIG.
Veremos qué es CONFIGxx, cómo crearlo (el ADCD no trae ninguno) y cómo detectar un dispositivo que no está como debería.
Qué es CONFIGxx
📖 CONFIGxx (standard configuration list)
Es un miembro de PARMLIB con una lista de sentencias que describe la configuración «buena» del sistema: procesadores, memoria (central storage), CHPIDs (canales), dispositivos, etc.
Tiene dos usos:
- Compararlo con la configuración actual: D M=CONFIG(xx).
- Reconfigurar algunos elementos del sistema para que queden como dice el miembro: CF MEMBER(xx).
No hay ningún parámetro en IEASYSxx que lo active: el miembro se indica en el propio comando. Si no ponemos sufijo, D M=CONFIG busca CONFIG00.
Las reglas son sencillas: un comentario lleva un * en la columna 1 y no hay continuaciones.
📖 Statements and parameters for CONFIGxx
Sentencias que admite:
- CPU / CPUAD y CORE: procesadores (STANDARD, ZAAP, ZIIP o ANY).
- STOR / STORAGE: rangos de memoria real (central storage).
- CHP: canales (CHPIDs), con STATIC o MANAGED.
- DEV / DEVICE: dispositivos y, opcionalmente, por qué canales deben estar.
- VOL / VOLUME: qué volumen debe estar montado (y en qué dispositivo).
- PFID: funciones PCIe.
- SWITCH: puertos de switch para DCM.
- PAV y HPAV: sin parámetros.
- ESTOR: memoria expandida (expanded storage); no existe en z/Architecture, se tolera y se ignora.
En esta entrada usaremos DEV, que es la que sirve para discos y cintas. Ejemplos del manual:
DEV 340-34F,ONLINE
DEV (334,33A),12,ONLINE
DEV (A451,A453,A455),*,ONLINEEl segundo valor (opcional) son los CHPIDs por los que debe estar el dispositivo. Con * solo comprueba que tenga al menos un camino online.
¿Tiene el ADCD z/OS V3R1 May Edition of 2024 un CONFIGxx?
Primero miramos qué librerías PARMLIB usa el sistema:
D PARMLIBO con el comando PARM de SDSF.

En ninguna de ellas hay un miembro CONFIGxx.
Ver los dispositivos del sistema
Para saber qué poner en el miembro necesitamos las direcciones de los dispositivos. En ZD&T vienen del devmap.
D U,DASD,ONLINE
D U,TAPE,ONLINE
D U,TAPE,OFFLINE

Para provocar la desviación usaré una unidad de cinta: nadie la tiene asignada, así que se puede poner offline sin problema. Con un disco hay que tener cuidado: si alguien lo tiene asignado, el VARY se queda en pending offline. Y nunca hay que tocar B3RES1, B3SYS1 ni los discos de paginación o spool. Es decir, para hacer una prueba, elegiremos un dispositivo que no sea disruptivo.
Crear CONFIG01
Como mi sistema no tiene ningún CONFIGxx, voy a crear CONFIG01 en mi PARMLIB de usuario (USER.Z31B.PARMLIB).
En el primer intento copié el ejemplo del manual (DEV 340-34F,ONLINE). Al comprobarlo, la columna ACTUAL mostraba NOT GEND: esos dispositivos no están definidos en el IODF de mi sistema.
RESPONSE=S0W1
IEE097I 20.22.57 DEVIATION STATUS 396
FROM MEMBER CONFIG01
DEVICE DESIRED ACTUAL
0340 ONLINE NOT GEND
0341 ONLINE NOT GEND
0342 ONLINE NOT GEND
...Así que lo cambié por los discos de mi sistema y añadí la unidad de cinta 0560:
* CONFIG01 - expected device configuration (ADCD on ZD&T)
* System volumes
DEV 0A80-0A86,ONLINE
* Tape drive used for the test
DEV 0560,ONLINE
Sin desviaciones
D M=CONFIG(01)El resultado sale en el mensaje IEE097I. Si todo está como dice el miembro, veremos:
RESPONSE=S0W1
IEE097I 21.10.23 DEVIATION STATUS 834
FROM MEMBER CONFIG01
NO DEVIATION FROM REQUESTED CONFIGURATION 
Provocar una desviación
Ahora pongo la unidad de cinta offline y vuelvo a comprobar:
V 0560,OFFLINE
D M=CONFIG(01)
Corregirla
📖 Reconfiguring the system with a CONFIGxx parmlib member
Existe el comando CF MEMBER(xx), pero no sirve para esto: según el manual, las sentencias DEV y VOL solo se usan para verificar, no para reconfigurar. CF MEMBER reconfigura procesadores, memoria, PFIDs, canales y switches, y solo se puede lanzar desde una consola con autoridad master. Las desviaciones de las unidades se resuelven una a una.
Pero antes de tocar nada hay que investigar por qué el dispositivo no está como debería. Por ejemplo:
- Alguien lo ha puesto offline por error.
- Hay un fallo de canal y por eso está offline.
- Se está trabajando con él: por ejemplo, un disco que hemos dejado offline para inicializarlo. Si justo salta el automatismo que lanza la comprobación, avisará de la desviación aunque sea un trabajo previsto.
- Se ha hecho un cambio en el sistema (por ejemplo, esas unidades se van a quitar) y todavía no se ha actualizado el CONFIGxx. En ese caso lo que hay que corregir es el miembro, no el dispositivo.
En mi caso la puse offline yo para la prueba. Para volver a ponerla online, el VARY de toda la vida:
V 0560,ONLINE
D M=CONFIG(01)
Generarlo desde HCD (no es posible en el ADCD)
En un sistema real no hace falta escribir el miembro a mano: HCD tiene la función «Build CONFIGxx member», que lo crea a partir del IODF de producción con las sentencias CHP, DEVICE y SWITCH. También se puede hacer en batch con el programa CBDMGHCP.
📖 z/OS 3.1 HCD User's Guide (PDF): capítulo 13, «How to invoke HCD batch utility functions». Los parámetros de CBDMGHCP están en «Input parameter string» (pág. 294) y los de CONFIG,XX en «Build I/O configuration data» (págs. 305-307).
PARM='CONFIG,XX,xx,procid,partition_id,osid,U|R,backup'En el ADCD no es posible hacer la prueba: en ZD&T el hardware es emulado y en mi IODF no hay ningún procesador definido, solo la configuración del sistema operativo con sus dispositivos. El procesador es obligatorio en el PARM y el que indique no va a existir en el IODF, así que HCD termina con el mensaje:
CBDA632I Processor procid does not exist.Por eso aquí el CONFIGxx lo escribimos a mano, solo con sentencias DEV.
Job de ejemplo para un sistema real
Este job no se usa en el ADCD. No lo he podido ejecutar completo: en el ADCD el paso BUILD termina con CBDA632I, como cuento arriba.
//BLDCONF JOB (ACCT),'BUILD CONFIGXX',CLASS=A,MSGCLASS=X
//* Delete the work PDS from a previous run (RC 0 if not found)
//DELETE EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DELETE IBMUSER.HCD.CONFIG
SET MAXCC=0
/*
//* Allocate a work PDS for the generated member
//ALLOC EXEC PGM=IEFBR14
//WORKPDS DD DSN=IBMUSER.HCD.CONFIG,DISP=(NEW,CATLG),
// UNIT=SYSDA,SPACE=(TRK,(5,5,5)),
// DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=27920
//* Build CONFIG02 from the production IODF
//BUILD EXEC PGM=CBDMGHCP,
// PARM='CONFIG,XX,02,procid,partition_id,osid,R'
//HCDIODFS DD DSN=SYS1.IODFxx,DISP=SHR
//HCDDECK DD DSN=IBMUSER.HCD.CONFIG,DISP=OLD
//HCDMLOG DD SYSOUT=*
//* Copy CONFIG02 into the user PARMLIB (R replaces it if it exists)
//COPY EXEC PGM=IEBCOPY,COND=(4,LT)
//SYSPRINT DD SYSOUT=*
//IN DD DSN=IBMUSER.HCD.CONFIG,DISP=SHR
//OUT DD DSN=USER.Z31B.PARMLIB,DISP=SHR
//SYSIN DD *
COPY OUTDD=OUT,INDD=IN
SELECT MEMBER=((CONFIG02,,R))
/*HCD necesita el PDS de salida en exclusiva (DISP=OLD). Contra mi PARMLIB directamente da CBDA020I: está en la concatenación de PARMLIB del sistema, que la tiene asignada en compartido (SHR). Con un data set temporal (&&) da CBDA058I. Por eso se genera en un PDS intermedio y se copia con IEBCOPY.
Para qué sirve en el día a día
- Después de una IPL o de un cambio en el IODF, un D M=CONFIG(xx) nos dice en segundos si falta algo.
- Se podría lanzar de forma automática después de la IPL (COMMNDxx) o cada cierto tiempo con un comando automático de JES2 (Comandos automáticos en z/OS: programar comandos con $TA). Pero así la respuesta solo queda en la consola y en el SYSLOG: lo adecuado es incluirlo en algún proceso automatizado que, si IEE097I muestra unidades en un estado que no es el esperado, nos mande un aviso.
Resumen
- CONFIGxx describe cómo debería estar el sistema. El ADCD no trae ninguno: lo creamos con sentencias DEV.
- D M=CONFIG(xx) compara con la configuración actual y muestra las diferencias en IEE097I (NOT GEND si el dispositivo no existe en el IODF).
- Para un dispositivo, V dddd,ONLINE. CF MEMBER(xx) no actúa sobre las sentencias DEV: reconfigura procesadores, memoria, PFIDs, canales y switches.
Referencias (z/OS 3.1)
- CONFIGxx (standard configuration list) (MVS Initialization and Tuning Reference)
- Statements and parameters for CONFIGxx (MVS Initialization and Tuning Reference)
- Syntax rules for CONFIGxx (MVS Initialization and Tuning Reference)
- Displaying system configuration information (M) (MVS System Commands)
- CONFIG command (MVS System Commands)
- Reconfiguring the system with a CONFIGxx parmlib member (MVS System Commands)
- z/OS 3.1 HCD User's Guide (PDF): capítulo 13, «How to invoke HCD batch utility functions»
- IEE097I: z/OS MVS System Messages, Vol 7 (IEB-IEE) (PDF)