NuevoProyecto ETAPEProyecto Emuframe Tape Server (ETAPE)
z/OS

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP

SMF (System Management Facilities) guarda en registros lo que pasa en el sistema: los jobs que se ejecutan, los accesos que comprueba RACF, el uso de los dispositivos... Esos registros se van escribiendo en unos data sets, los SYS1.MANx, que se llenan, y hay que volcarlos a otro sitio antes de poder reutilizarlos.

En esta entrada repaso todo el ciclo en mi sistema, el ADCD de z/OS 3.1: dónde guarda SMF los registros, el exit IEFU29 que lanza el volcado automáticamente cuando se llena un MANx (cómo está hecho, qué línea cambiar para elegir el procedimiento que lanza y cómo ensamblarlo), el procedimiento que vuelca, el GDG donde se guardan los volcados y, al final, dos jobs: uno que extrae solo los tipos de registro que nos interesan y otro que muestra sus subtipos.

Dónde guarda SMF los registros

D SMF
RESPONSE=S0W1                                                   
 IEE974I 08.01.02 SMF DATA SETS 134                             
           NAME                VOLSER SIZE(BLKS) %FULL  STATUS  
         P-SYS1.S0W1.MAN1      B3SYS1      7200     0  ALTERNATE
         S-SYS1.S0W1.MAN2      B3SYS1      7200    75  ACTIVE   

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 1

En mi sistema hay dos: SYS1.S0W1.MAN1 y SYS1.S0W1.MAN2. SMF escribe en el que está ACTIVE; cuando se llena, pasa al ALTERNATE, y el que estaba lleno hay que volcarlo para que quede libre otra vez. En el momento de la captura, MAN2 estaba al 75 %.

Con qué opciones trabaja SMF se ve con:

D SMF,O

De toda la salida, las líneas que importan aquí son estas:

IEE967I 20.07.50 SMF PARAMETERS 215
        MEMBER = SMFPRM00
        ...
        SYS(EXITS(IEFU29)) -- PARMLIB
        ...
        SID(S0W1) -- PARMLIB
        ...
        DSNAME(SYS1.S0W1.MAN2) -- PARMLIB
        DSNAME(SYS1.S0W1.MAN1) -- PARMLIB
        ACTIVE -- PARMLIB

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 2

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 3

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 4

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 5

  • MEMBER = SMFPRM00: el miembro de PARMLIB con la configuración de SMF.
  • DSNAME(...): los data sets MANx.
  • SYS(EXITS(IEFU29)): SMF llama al exit IEFU29. Es el que lanza el volcado. Si en SMFPRMxx hay un SUBSYS(STC,EXITS(...)), IEFU29 tiene que estar en esa lista.

SMF también puede grabar en log streams del System Logger en lugar de en data sets MANx (RECORDING(LOGSTREAM) en SMFPRMxx). En ese caso los registros se extraen con el programa IFASMFDL, no con IFASMFDP. Esa opción no la trato en esta entrada: aquí todo es con data sets MANx, que es como está configurado mi sistema.

Qué pasa cuando se llena un MANx

Cuando el data set activo se llena, o cuando lo forzamos con el comando I SMF, SMF cambia al siguiente y llama al exit IEFU29 con el nombre del que acaba de dejar. Sin exit, SMF saca el mensaje IEE362A para que alguien vuelque el data set a mano. Con el exit, el volcado se lanza solo y, como el exit devuelve el código de retorno 4, el mensaje no sale.

El exit IEFU29

El ADCD trae el exit de ejemplo en ADCD.LIB.JCL, en los miembros IEFU29 e IEFU29@. Por el nombre del recurso que usa (IPOSMF01) y la marca SIPO50, viene de un ejemplo de IBM. Yo partí de ellos y mi versión está en IBMUSER.JCL(IEFU29).

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 6

Estas son las partes que importan de mi versión:

         L     R8,0(,R1)               SAVE INPUT PARM(DSNAME)
         ...
         MVC   ENQLIST(LENQLIST),ENQLSTX LOAD IN MODEL PARM LIST
         ENQ   MF=(E,ENQLIST)          TEST IF RESOURCE IN USE?
         LTR   R15,R15                 WAS THE RESOURCE AVAILABLE?
         BNZ   SKIPDUMP                NO, DO NOT START DUMP
         MVC   WTOAREA(WTOLEN),WTOL    MOVE IN WTO MESSAGE
         MVC   CMDAREA(CMDLEN),CMDL    MOVE IN START COMMAND
         ...
         MVC   CMDAREA+20(14),0(R8)     MOVE IN MAN DSN    LPJ88259
         SLR   R0,R0                   CLEAR REG ZERO FOR SVC 34
         LA    R1,CMDAREA              POINT TO START COMMAND
         SVC   34                      ISSUE START COMMAND
         WTO   MF=(E,WTOAREA)          ISSUE MSG
SKIPDUMP ...
         RETURN  (14,12),RC=4          RETURN TO CALLER
         ...
CMDL     DS    0F                      START COMMAND FORMAT FOR SVC 34
         DC    AL2(CMDLEN),AL2(00)     LENGTH OF STRING
         DC    C'S SMFDUMPS,MAN=''SYS1.S0W1.MANX''      **IEFU29** '
*                456789012345678 9012345678901234567  CHECK COLUMNS

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 7

En mi caso, no entiendo todo el fuente. Lo que importa es la línea del comando que lanza: S SMFDUMPS,MAN='SYS1.S0W1.MANX'. El exit pone en ella el nombre del MANx que se acaba de llenar y la emite como un comando de operador. Para que lance otro procedimiento, hay que editar esa línea.

Elegir el procedimiento que lanza

Tal como viene en el ADCD, el exit no lanza SMFDUMPS, sino SMFCLEAR:

CMDL     DS    0F                      START COMMAND FORMAT FOR SVC 34
         DC    AL2(CMDLEN),AL2(00)     LENGTH OF STRING
         DC    C'S SMFCLEAR,MAN=''SYS1.S0W1.MANX''      **IEFU29** '
*                456789012345678 9012345678901234567  CHECK COLUMNS
CMDLEN   EQU   *-CMDL             LENGTH OF COMMAND STRING
DSNCOFF  EQU   20                 OFFSET OF DSNAME FIELD IN CMD LIST
*
WTOL     WTO   'SMF SWITCH CAUSED COMMAND ''S SMFCLEAR''   TO BE ISSUED+
               .',ROUTCDE=(1,2,11),MF=L

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 8

Y el procedimiento SMFCLEAR, en ADCD.Z31B.PROCLIB:

//SMFCLEAR PROC MAN='SYS1.S0W1.MAN1'
//*
//* CLEAR SMF DATASET -
//* SMF MAN DATASET DUMPED REQUIRED MESSAGE RECIEVED
//* OR ISSUE SWITCH, I SMF, THEN THAT FILE WILL BE CLEARED
//*
//*
//DUMP1   EXEC PGM=IFASMFDP,REGION=1M
//INDD1    DD  DSN=&MAN,DISP=SHR
//DUMPOUT  DD  DUMMY
//SYSPRINT DD  SYSOUT=D
//SYSIN    DD  DSN=ADCD.&SYSVER..PARMLIB(CLRMAN),DISP=SHR

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 9

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 10

La salida, DUMPOUT, va a DUMMY: IFASMFDP lee el MANx y lo deja libre, pero los registros no se guardan en ningún sitio. Yo quería conservarlos, así que en mi versión cambié SMFCLEAR por SMFDUMPS en dos sitios: en el comando (CMDL) y en el texto del mensaje (WTOL). Si solo se cambia el comando, el mensaje seguiría diciendo S SMFCLEAR.

El nombre del procedimiento está en la línea DC C'S SMFDUMPS,MAN=...'. Para lanzar otro, se cambia ahí el nombre, y lo más sencillo es que el nuevo tenga 8 caracteres, como SMFCLEAR y SMFDUMPS.

El motivo: el exit escribe el nombre del MANx en una posición fija del comando, justo después de MAN='. Esa posición es el 20 de la línea MVC CMDAREA+20(14),0(R8): 4 bytes de cabecera al principio del comando (2 de longitud y 2 a ceros) más los 16 caracteres de S SMFDUMPS,MAN='. Con un nombre de procedimiento más corto o más largo, el texto se desplaza y el nombre del MANx quedaría mal colocado, así que habría que cambiar también ese 20. Lo mismo pasa con el 14, que es la longitud del nombre de mis MANx (SYS1.S0W1.MAN1): con MANx de otro nombre, también habría que cambiarlo.

Ensamblarlo y enlazarlo en la LPALIB

El job está en IBMUSER.JCL(IEFU29@), copia del IEFU29@ de ADCD.LIB.JCL. Ensambla el fuente con el High Level Assembler (ASMA90) y lo enlaza con el binder (HEWL) en USER.Z31B.LPALIB:

//IEFU29J@ JOB (FB3TR,60000,4365),'SMF',
//             NOTIFY=&SYSUID,REGION=4M,COND=(4,GT),
//             CLASS=A,MSGCLASS=H,MSGLEVEL=(1,1)   ,RESTART=
//*                                                           /*JCTRL*/
//MYASMCL  PROC
//*
//* THIS PROCEDURE RUNS THE HIGH LEVEL ASSEMBLER, LINK-EDITS THE
//* NEWLY ASSEMBLED PROGRAM.                                   @PN22982
//*
//C        EXEC PGM=ASMA90,PARM=(OBJECT,NODECK,RENT)
//SYSLIB   DD  DSN=SYS1.MACLIB,DISP=SHR
//SYSUT1   DD  DSN=&&SYSUT1,SPACE=(4096,(120,120),,,ROUND),UNIT=VIO,
//             DCB=BUFNO=1
//SYSPRINT DD  SYSOUT=*
//SYSPUNCH DD  SYSOUT=B
//SYSLIN   DD  DSN=&&OBJ,SPACE=(3040,(40,40),,,ROUND),UNIT=VIO,
//             DISP=(MOD,PASS),
//             DCB=(BLKSIZE=3040,LRECL=80,RECFM=FBS,BUFNO=1)
//L        EXEC PGM=HEWL,PARM='MAP,LET,LIST,NCAL,RENT,REFR'
//SYSLIN   DD  DSN=&&OBJ,DISP=(OLD,DELETE)
//         DD  DDNAME=SYSIN
//SYSLMOD  DD  DISP=(,PASS),UNIT=SYSDA,SPACE=(CYL,(1,1,1)),
//             DSN=&&GOSET(GO)
//SYSUT1   DD  DSN=&&SYSUT1,SPACE=(1024,(120,120),,,ROUND),UNIT=VIO,
//             DCB=BUFNO=1
//SYSPRINT DD  SYSOUT=*
//      PEND
//*
//STEP01  EXEC MYASMCL
//C.SYSIN    DD DISP=SHR,DSN=IBMUSER.JCL(IEFU29)
//*
//L.SYSLMOD  DD DSN=USER.Z31B.LPALIB(IEFU29),DISP=SHR

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 11

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 12

El procedimiento está dentro del propio job (PROC ... PEND). El paso C ensambla el fuente que le llega por C.SYSIN y el paso L enlaza el módulo. El L.SYSLMOD sustituye la librería temporal del procedimiento por USER.Z31B.LPALIB, con el nombre de miembro IEFU29.

Ojo con el COND=(4,GT) de la ficha JOB: significa «si 4 es mayor que el código de retorno de un paso, sáltate los siguientes». En mi caso el ensamblado (paso C) termina con RC=4, por los avisos, así que el enlace (paso L) se ejecuta. Si el ensamblado terminara con RC=0, el enlace se saltaría. Para que el enlace se salte solo cuando el ensamblado da errores, lo habitual es COND=(4,LT).

-JOBNAME  STEPNAME PROCSTEP    RC   EXCP    CPU    SRB  CLOCK
-IEFU29J@ STEP01   C           04    164    .00    .00    .00
-IEFU29J@ STEP01   L           00     47    .00    .00    .00

Comprobar que el exit está activo

D PROG,EXIT,EXITNAME=SYS.IEFU29
RESPONSE=S0W1
 CSV461I 09.09.23 PROG,EXIT DISPLAY 552
 EXIT             MODULE   STATE MODULE   STATE MODULE   STATE
 SYS.IEFU29       IEFU29     A

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 13

El exit SYS.IEFU29 tiene el módulo IEFU29 activo (A). Y que está cargado en la LPA lo dice:

D PROG,LPA,MODNAME=IEFU29
RESPONSE=S0W1
 CSV550I 09.10.22 LPA DISPLAY 833
 FLAGS  MODULE    ENTRY PT  LOAD PT   LENGTH    DIAG
    P   IEFU29    84860918  04860918  00000150  02F36430

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 14

El módulo está cargado en la LPA. Enlazarlo de nuevo en USER.Z31B.LPALIB no basta para que un cambio entre en funcionamiento: hay que volver a cargarlo en la LPA. Para eso se hace un IPL con CLPA, que carga de nuevo la LPA desde las librerías; sin CLPA, el sistema reutiliza la LPA anterior. En mi caso hice IPL para cargarlo, y mi IEASYSxx (USER.Z31B.PARMLIB(IEASYSAL)) lleva CLPA.

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 15

El procedimiento SMFDUMPS

Es el que lanza el exit. Lo tengo en USER.Z31B.PROCLIB:

//SMFDUMPS PROC MAN='SYS1.S0W1.MAN1'
//*
//* CLEAR SMF DATASET -
//* SMF MAN DATASET DUMPED REQUIRED MESSAGE RECIEVED
//* OR ISSUE SWITCH, I SMF, THEN THAT FILE WILL BE CLEARED
//*
//*
//DUMP    EXEC PGM=IFASMFDP,REGION=4096K
//SYSPRINT  DD SYSOUT=*
//INDD1     DD DSN=&MAN,DISP=SHR
//DUMPOUT   DD DSN=SYS1.SMF.DATA(+1),DISP=(NEW,CATLG),
//             STORCLAS=SCNOSMS,
//             UNIT=3390,VOL=SER=SMF000,SPACE=(CYL,(150,100),RLSE)
//SYSIN     DD DSN=USER.&SYSVER..PARMLIB(SMFDUMP),DISP=SHR

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 16

  • MAN es el parámetro que rellena el exit con el nombre del data set. Si se arranca a mano sin él, vuelca MAN1.
  • IFASMFDP lee el MANx (INDD1) y escribe una nueva generación de SYS1.SMF.DATA en el volumen SMF000. El volumen (SMF000) y la storage class (SCNOSMS) son los de mi sistema; hay que adaptarlos.
  • Las órdenes de IFASMFDP las lee del miembro SMFDUMP de mi PARMLIB. En USER.&SYSVER..PARMLIB, el doble punto cierra el símbolo &SYSVER y deja el punto del nombre.
  INDD(INDD1,OPTIONS(ALL))
  OUTDD(DUMPOUT,TYPE(1:255))

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 17

OPTIONS(ALL) vuelca el MANx y lo deja limpio para que SMF pueda volver a usarlo. TYPE(1:255) copia los tipos de registro del 1 al 255. Sin TYPE, IFASMFDP copia todos, del 0 al 2047.

El GDG

Los volcados se guardan en el GDG SYS1.SMF.DATA. Lo creé con este job:

//IBMUSERB JOB (20,FB3),'IDCAMS BUILD GDG',COND=(0,NE),
//            CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID
//*
//ST1      EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
 DEFINE GDG -
   (NAME(SYS1.SMF.DATA) -
    LIMIT(255)           -
    OWNER(IBMUSER)       -
    SCRATCH)
/*

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 18

LIMIT(255) guarda hasta 255 generaciones y, con SCRATCH, cuando se crea una más, la más antigua se descataloga y se borra. Como mis MANx son pequeños y se llenan a menudo, esto ya lo llevo usando desde hace bastante tiempo, pero no lo había documentado hasta ahora.

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 19

Probarlo: I SMF

Para no esperar a que se llene, fuerzo el cambio de data set:

D SMF
I SMF
D SMF

En el log se ve todo el ciclo: SMF cambia de data set, el exit escribe su mensaje y lanza S SMFDUMPS con el nombre del MANx que estaba activo, y el procedimiento lo vuelca.

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 20

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 21

Y en el GDG aparece una generación nueva:

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 22

Extraer solo algunos tipos de registro

Un volcado tiene muchos tipos de registro mezclados. Para trabajar con uno o dos, IFASMFDP también sirve para leer un volcado anterior y copiar solo lo que nos interesa. Por ejemplo, el tipo 30 (jobs y tareas) y el tipo 80 (RACF), cada uno en un data set:

//SMFTYPE  JOB (ACCT),'SMF BY TYPE',CLASS=A,MSGCLASS=X,
//             NOTIFY=&SYSUID
//* Copy only record types 30 (jobs) and 80 (RACF) from the
//* latest SMF dump to two data sets
//FILTER   EXEC PGM=IFASMFDP
//SYSPRINT DD SYSOUT=*
//DUMPIN   DD DSN=SYS1.SMF.DATA(0),DISP=SHR
//SMF30    DD DSN=IBMUSER.SMF.TYPE30,DISP=(NEW,CATLG),
//            UNIT=SYSDA,SPACE=(CYL,(5,5),RLSE)
//SMF80    DD DSN=IBMUSER.SMF.TYPE80,DISP=(NEW,CATLG),
//            UNIT=SYSDA,SPACE=(CYL,(5,5),RLSE)
//SYSIN    DD *
  INDD(DUMPIN,OPTIONS(DUMP))
  OUTDD(SMF30,TYPE(30))
  OUTDD(SMF80,TYPE(80))
/*
  • SYS1.SMF.DATA(0) es la generación más reciente.
  • OPTIONS(DUMP) solo copia, no borra nada.
  • Cada OUTDD lleva su TYPE: con una sola lectura, los registros se reparten en varios data sets.
  • Además de los registros pedidos, IFASMFDP añade a cada data set de salida un registro de cabecera (tipo 2) y otro de cierre (tipo 3).
  • Los data sets se crean con DISP=(NEW,CATLG): para volver a lanzar el job, antes hay que borrar IBMUSER.SMF.TYPE30 e IBMUSER.SMF.TYPE80.

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 23

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 24

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 25

Ver los subtipos de un registro

Muchos tipos de registro tienen subtipos. Con REPORTOPTS(SUBTYPE), IFASMFDP saca en el SYSPRINT cuántos registros hay de cada subtipo. Si la salida va a DUMMY, solo se obtiene el informe:

//SMFSUBTP JOB (ACCT),'SMF SUBTYPES',CLASS=A,MSGCLASS=X,
//             NOTIFY=&SYSUID
//* Report the subtypes of record type 30 in the latest SMF
//* dump, without writing any data set
//REPORT   EXEC PGM=IFASMFDP
//SYSPRINT DD SYSOUT=*
//DUMPIN   DD DSN=SYS1.SMF.DATA(0),DISP=SHR
//OUT      DD DUMMY
//SYSIN    DD *
  INDD(DUMPIN,OPTIONS(DUMP))
  OUTDD(OUT,TYPE(30))
  REPORTOPTS(SUBTYPE)
/*

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 26

SMF en z/OS: volcado automático con IEFU29 y extracción por tipo de registro con IFASMFDP – captura 27

Resumen

  • SMF escribe en los data sets MANx (D SMF); su configuración está en SMFPRMxx (D SMF,O).
  • Cuando un MANx se llena, o con I SMF, SMF cambia de data set y llama al exit IEFU29.
  • El IEFU29 del ADCD lanza S SMFCLEAR, que deja libre el MANx sin guardar los registros. El mío lanza S SMFDUMPS con el nombre del MANx. Para lanzar otro procedimiento se cambia la línea del comando, sin olvidar el desplazamiento del nombre del data set.
  • El exit se ensambla y se enlaza en USER.Z31B.LPALIB, y se carga en la LPA con un IPL con CLPA; D PROG,EXIT y D PROG,LPA dicen si está activo y si está cargado en la LPA.
  • SMFDUMPS vuelca con IFASMFDP a un GDG con LIMIT(255) y SCRATCH.
  • Con IFASMFDP también se extraen tipos de registro concretos de un volcado, y con REPORTOPTS(SUBTYPE) se ven sus subtipos.

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