El título del post parece enrevesado, pero nada mas lejos de la realidad. En articulo de hoy se basará en como configurar nuestro z/OS, de forma que tanto en el log como en nuestro resultado del trabajo o job que lancemos, podamos obtener una tabla con el RC o Return Code de cada paso que se ha ejecutado. De esta forma, y de un vistazo, podremos saber de forma tabular que paso ha fallado, o como ha terminado nuestro JCL sin tener que meternos en harina y ver línea por línea nuestro trabajo.
Activación SMF
Para ello, debemos hacer uso de los registros SMF donde se anotan todos y cada uno de los procesos que lleva a cabo nuestro z/OS. Dicho sistema se controla desde el miembro SMFPRMXX de nuestra PARMLIB. Si no esta activo, debemos activarlo, cambiando la primera linea de NOACTIVE a ACTIVE.
Ejemplo de contenido SMFPRMXX:
ACTIVE /* ACTIVE SMF RECORDING */ DSNAME(SYS1.MAN1, SYS1.MAN2, SYS1.MAN3) NOPROMPT /* DO NOT PROMPT OPERATOR */ REC(PERM) /* TYPE 17 PERM RECORDS ONLY */ MAXDORM(3000) /* WRITE IDLE BUFFER AFTER 30 MIN */ STATUS(010000) /* WRITE SMF STATS AFTER 1 HOUR */ JWT(0400) /* 522 AFTER 30 MINUTES */ SID(SYS1) LISTDSN /* LIST DATA SET STATUS AT IPL */ SYS(NOTYPE(14:19,62:69),EXITS(IEFU83,IEFU84,IEFACTRT, IEFUSI,IEFUJI,IEFU29),NOINTERVAL,NODETAIL) /* WRITE ALL EXCEPT DATA MANAGEMENT RECORDS, TAKE EXITS. */ /* NOTE: JES EXITS CONTROLED BY JES , THERE IS NO */ /* DEFAULT INTERVAL RECORDS WRITTEN AND ONLY SUMMARY T32 */ /* RECORDS AS A DEFAULT FOR TSO. */ SUBSYS(STC,EXITS(IEFU29,IEFU83,IEFU84,IEFUJP,IEFUSO))
Activando el SMF, hará que todos los registros de nuestra actividad -para luego sacar estadisticas o lo que nos convenga- se almacenen en 3 datasets por defecto, a saber: SYS1.MAN1, SYS1.MAN2 y SYS1.MAN3. Posteriormente, con estos datasets los podemos volcar y preprocesar para, como he dicho antes, sacar estadisticas, obtene consumos, MSUs, y lo que necesitemos, pero esto no lo cubriré en este articulo.
Creación y Activación de una EXIT
Para activar la opción antes descrita, no basta solo con activar el SMF, sino que debemos instalar y activar en nuestra LINKLIST una EXIT que viene dentro del SO. Dicha Exit se encuentra en SYS1.SAMPLIB, baj0 el miembro IEEACTRT. Para instalarla en nuestra SYS1.LINKLST, basta con ejecutar el siguiente JCL:
//SPSMFXIT JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=&SYSUID //ASMXIT EXEC HLASMCL,REGION=4M,COND.L=(0,NE,C), // PARM.L='LIST,LET,NCAL,XREF,RENT,REUS' //C.SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR // DD DSN=SYS1.MODGEN,DISP=SHR //C.SYSIN DD DSN=SYS1.SAMPLIB(IEEACTRT),DISP=SHR //L.SYSLMOD DD DSN=USER.LINKLIB(IEFACTRT),DISP=SHR,UNIT=3390, // SPACE=(TRK,5)
El RC que debería darnos es un 00, es decir, que se ha instalado correctamente.
Lo siguiente es editar el SMFPRMXX, añadiendo nuestra EXIT recien instalada en la LINKLST bajo un nuevo susbsistema JES2 que usará la EXIT (en negrita):
ACTIVE /* ACTIVE SMF RECORDING */ DSNAME(SYS1.MAN1, SYS1.MAN2, SYS1.MAN3) NOPROMPT /* DO NOT PROMPT OPERATOR */ REC(PERM) /* TYPE 17 PERM RECORDS ONLY */ MAXDORM(3000) /* WRITE IDLE BUFFER AFTER 30 MIN */ STATUS(010000) /* WRITE SMF STATS AFTER 1 HOUR */ JWT(0400) /* 522 AFTER 30 MINUTES */ SID(SYS1) LISTDSN /* LIST DATA SET STATUS AT IPL */ SYS(NOTYPE(14:19,62:69),EXITS(IEFU83,IEFU84,IEFACTRT, IEFUSI,IEFUJI,IEFU29),NOINTERVAL,NODETAIL) /* WRITE ALL EXCEPT DATA MANAGEMENT RECORDS, TAKE EXITS. */ /* NOTE: JES EXITS CONTROLED BY JES , THERE IS NO */ /* DEFAULT INTERVAL RECORDS WRITTEN AND ONLY SUMMARY T32 */ /* RECORDS AS A DEFAULT FOR TSO. */ SUBSYS(STC,EXITS(IEFU29,IEFU83,IEFU84,IEFUJP,IEFUSO)) SUBSYS(JES2,EXITS(IEFACTRT)) /* WRITE RECORDS ACCORDING TO SYS VALUE, TAKE ONLY FIVE */ /* EXITS, NOTE: IEFU29 EXECUTES IN THE MASTER ASID WHICH IS A */ /* STC ADDRESS SPACE SO IEFU29 MUST BE ON FOR STC. */ /* USE ALL OTHER SYS PARMETERS AS A DEFAULT. */
Refrescar y Activar la configuración
Por último, solo nos hace falta activar la configiuración dinámicamente. Para ello, si nuestro miembro SMFPRMXX se llama SMFPRM00, en consola con hacer
T SMF=00
el z/OS adquirirá la nueva configuración.
Y por último, refrescaremos la LLA ya que la LINKLST ha sido modificada:
F LLA,REFRESH
SETPROG EXIT,DELETE,EXITNAME=SYSJES2.IEFACTRT,MODNAME=IEFACTRT
SETPROG EXIT,ADD,EX=SYSJES2.IEFACTRT,MOD=IEFACTRT,DSN=USER.LINKLIB
Y ya tenemos todo funcionando. Por tanto, a partir de ahora, si lanzamos un JCL, de tener esto:
Pasaremos a tener esto otro, con lo que de un vistazo veremos cada paso -en el ejemplo solo hay uno- y como ha acabado:
Actualización: Como dejar este cambio permanente
Usuarios como Javierc me han avisado de que al hacer IPL, al refrescarse la LLA y al releer el PROGXX, estos cambios se pierden y los comandos F LLA,REFRESH y las SETPROG deben ser de nuevo ejecutados si queremos seguir obteniendo los RC de cada paso del JOB . Para dejar estos cambios permanentes, lo que hay que hacer es lo siguiente:
1.- Averiguar nuestra PROGXX de arranque: Esto lo miramos sencillamenbte, sabiendo con que parametro de LOAD hemos arrancado, que a su vez nos lleva al miembro LOADXX de nuestra SYS1.IPLPARM y que a su vez nos apunta a la IEASYSXX de nuestra PARMLIB. Dentro de la IEASYSXX, existe una línea llamada PROG=XX, pues bien, esa “XX” nos apuntará a nuestro miembro PROG”XX” que también reside en nuestra PARMLIB. Una vez localizado, al abrirlo veremos que hay muchas líneas del estilo APF ADD y LINKLIST ADD. Pues lo único que hay que hacer es introducir esta línea al final de nuestra PROGXX:
EXIT ADD EX=SYSJES2.IEFACTRT MOD=IEFACTRT DSN=USER.LINKLIB
Y en nuestro siguiente IPL, tendremos la información de los RC de cada paso de los jobs de forma permanente.

