NuevoProyecto ETAPEProyecto Emuframe Tape Server (ETAPE)
z/OS

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),*,ONLINE

El 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 PARMLIB

O con el comando PARM de SDSF.

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 1

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

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 2

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 3

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

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 4

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  

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 5

Provocar una desviación

Ahora pongo la unidad de cinta offline y vuelvo a comprobar:

V 0560,OFFLINE
D M=CONFIG(01)

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 6

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)

D M=CONFIG: detectar desviaciones en estado de dispositivos – captura 7

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)

© 2026 Emuframe·🍪 Este sitio solo usa cookies funcionales. Sin rastreo ni recopilación de datos personales.

En esta página