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 SMFRESPONSE=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 
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,ODe 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



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 unSUBSYS(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).

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

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

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 .00Comprobar que el exit está activo
D PROG,EXIT,EXITNAME=SYS.IEFU29RESPONSE=S0W1
CSV461I 09.09.23 PROG,EXIT DISPLAY 552
EXIT MODULE STATE MODULE STATE MODULE STATE
SYS.IEFU29 IEFU29 A
El exit SYS.IEFU29 tiene el módulo IEFU29 activo (A). Y que está cargado en la LPA lo dice:
D PROG,LPA,MODNAME=IEFU29RESPONSE=S0W1
CSV550I 09.10.22 LPA DISPLAY 833
FLAGS MODULE ENTRY PT LOAD PT LENGTH DIAG
P IEFU29 84860918 04860918 00000150 02F36430
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.

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
MANes 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&SYSVERy deja el punto del nombre.
INDD(INDD1,OPTIONS(ALL))
OUTDD(DUMPOUT,TYPE(1:255))
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)
/*
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.

Probarlo: I SMF
Para no esperar a que se llene, fuerzo el cambio de data set:
D SMF
I SMF
D SMFEn 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.


Y en el GDG aparece una generación nueva:

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
OUTDDlleva suTYPE: 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.



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)
/*

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 lanzaS SMFDUMPScon 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,EXITyD PROG,LPAdicen si está activo y si está cargado en la LPA. - SMFDUMPS vuelca con IFASMFDP a un GDG con
LIMIT(255)ySCRATCH. - 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)
- IEFU29 - SMF dump exit (MVS Installation Exits).
- Using IFASMFDP — the SMF data set dump program (MVS System Management Facilities).
- Specifying parameters for the SMF data set dump program (MVS System Management Facilities).
- Displaying SMF data (SMF) (MVS System Commands).
- Displaying LPA information (PROG,LPA) (MVS System Commands).