Xpediter

En este post reuniremos las dos entradas más importantes acerca de este tema.

Y, para ello, diferenciaremos entre el batch y el online.

Así que, si un programa da un error, no dudéis en depurarlo utilizando esta utilidad tan útil.

xpediter online

Lo primero de todo para poder pasar el xpediter con programas online es saber si dicho se programa se ha ejecutado. Y ¿cómo se sabe? pues muy fácil. Debemos ejecutar el siguiente comando en CICS:

                    CEMT S PROG(NOMB-PROG)

Siendo NOMB-PROG el nombre del programa online que queremos pasar por xpediter.

Tras ejecutar dicho comando debe aparecer en pantalla un mensaje en el que se indica el número de veces que se ha ejecutado el programa online.

Si no aparece eso es que todavía no se ha ejecutado. Y si no aparece....pues ya sabes, ejecuta dicho programa al menos una vez y así ya aparecería.

Llegados a este punto en el que ya aparece lo anterior, sólo tendríamos que ejecutar el siguiente comando: XPED NOMB-PROG (o XPE NOMB-PROG).

De una vez que se ha ejecutado dicho comando aparece una pantalla con el código del programa.

Lo primero de todo es poner un punto de ruptura (poner una B en la línea que queramos).

¿Ahora qué hacemos? Pulsamos PF3 tantas veces hasta que aparezca la pantalla principal. En esta pantalla se elegiría la opción 1 (1 - SESSION CONTROL). Aparece otra pantalla de la que se elegiría la opción 6 - TRAP SUMMARY. Aparece otra pantalla, de la cual, lo más importante es la primera fila, esa primera fila en la que hemos de indicar el nombre del programa bajo la columna PROGRAM. Acuérdate que dicho nombre debe coincidir con el que venga en el campo MODULE. En esa misma fila, y bajo la columna TRAP ABEND, debemos dejar el valor YES (y si no está puesto lo ponemos nosotros).

Pulsamos PF3 tantas veces como sea necesario hasta que volvamos a la pantalla principal. De una vez que estamos en la pantalla principal elegimos la opción 2 (2 - DEBUGGING FACILITIES) y aparece otra pantalla en la que elegimos la opción L - SOURCE LISTING. Tras elegir esa opción estamos en la pantalla del código del programa en la que tenemos el punto de ruptura.

Ya estamos preparados para lanzar el programa online y pasar el xpediter, así que lanzamos el programa. De una vez que está lanzado tenemos que ir al xpediter. Vamos a él y pulsamos PF9.

Ya tenemos la transacción parada y el programa online listo para ejecutarlo por xpediter. A partir de aquí sería igual que cuando empleamos el xpediter para el batch, me refiero a que es igual en lo siguiente:

1) Si das PF9 estarías ejecutando línea a línea.

2) Si das PF12 irías al final del programa y lo finalizarías. A menos que no 

    hubieras puesto previamente un punto de ruptura, en cuyo caso iría a

    dicho punto de ruptura.

3) ¿Cómo se pone un punto de ruptura? Poniendo una B en aquella línea a la

    que queremos ir directamente.

4) Si ponemos SS al inicio de una línea y otra vez SS varias líneas después lo

    que haríamos sería que esas líneas de código no se ejecutarían.

5) Si estamos en un determinado punto del programa y queremos ir varias 

    líneas hacia atrás, ¿cómo se hace? Poniendo GT al inicio de la línea a la 

    que queramos retroceder.

Cuando acabamos de utilizar el xpediter en el online tenemos que hacer lo siguiente: pulsar PF3 tantas veces como sea necesario hasta que aparezca la pantalla en la que pregunta por finalizar sesión.

Tanto en END SESSION como en DUMP OPTION ponemos YES. Pulsamos intro y nos hemos salido del xpediter volviendo de nuevo al CICS. Aparece mensaje de confirmación.

Pues esto es el xpediter para online. Espero que te haya servido de ayuda, si tienes alguna duda no dudes en preguntar.

xpediter batch

Cuando estamos en el tso podemos hacer uso del xpediter para los procesos batch. Vamos a ver cómo se puede depurar un programa batch mediante xpediter.

Lo primero de todo es entrar en la utilidad existente en el sistema para hacer uso del xpediter, dependiendo del cliente en el que estemos trabajando existe una infraestructura que es la que limita la manera en la que se accede al xpediter. Se acceda de una manera o de otra deberemos llegar a un menú donde podamos elegir una opción relativa a XPEDITER. Se elegirá dicha opción.

De una vez que se ha accedido veremos una pantalla con un menú en el que elegimos la opción 2 (2 - TSO, la opción relativa para depurar programas bajo TSO). Aparece una pantalla en donde indicamos el programa, parámetros (si recibe algún dato por SYSIN), la librería en la que está el proceso donde estamos ejecutando el programa (también se indica el miembro dentro de esa librería, es el jcl donde tenemos el programa que estamos ejecutando, ejemplo: LIB.JCLS.DESA(JCL-PRUEBA)) y si tiene plan DB2 (en cuyo caso hay que indicar el nombre del plan y el sistema, éste último será desarrollo).

Lo primero de todo, en la misma pantalla anterior, es escribir SE y dar intro para que aparezca otra pantalla de la que elegiremos 1 - LOADLIBS.

Si elegimos dicha opción podremos indicar las librerías necesarias para poder pasar el xpediter. De una vez que hemos introducido las librerías, damos intro y a continuación damos PF3. De esta manera nos situamos en la pantalla donde ya hemos indicado el nombre del programa y el resto de datos.

En esta pantalla tenemos que rellenar una serie de información que paso a detallar a continuación (la que acabamos de indicar con tanta palabrería pero ahora más detallado):

• Program - aquí indicarías el nombre del programa
• Load Module - el nombre del ejecutable, coincide con el nombre del programa
• PARM - se suele dejar a YES
• File List/Jcl Member - se pone la librería en la que está el jcl desde el que lanzamos el programa y entre paréntesis se pone el nombre de dicho jcl. Ejemplo: LIB.JCLS.DESA(JCL-PRUEBA)
• Preview Files? - se suele dejar a NO
• Is this a DB2 Test? - si no tiene DB2 se deja a NO

La anterior información es obligatoria. Ya habríamos acabado si el programa cobol no tuviese DB2. Si tuviese DB2 habría que informar más cosas:

• Is this a DB2 Test? - si tiene DB2 se pone YES
• Plan - indicamos el plan DB2
• System - indicamos el sistema: DBSD

Tras haber informado lo necesario para pasar nuestro programa por xpediter, damos intro. Aparece una pantalla en la que se indica los ficheros que se alocan. No siempre sale pero en caso de que aparezca, hay una columna llamada UNIT en la que habría que sustituir WORK por SYSDES en todas las filas que aparezca dicho valor para la columna mencionada.

Después de hacer lo indicado, en caso de que sea necesario, iríamos a la línea de comando y pondríamos END. Damos intro y aparece una pantalla en la que habría que indicar lo siguiente: 'LIB.EJEM.XPED(XPEDITER)'

Con esto estamos indicando la librería en la que el xpediter va a crear un archivo auxiliar. ¿Con qué nombre lo creará? Con el que le indiquemos entre paréntesis. Es decir, en nuestro ejemplo xpediter crearía un archivo auxiliar en la librería LIB.EJEM.XPED con nombre XPEDITER....se llamará así porque es lo que yo he puesto entre paréntesis, si hubiese puesto XPEDIT01 se crearía con ese nombre. Como veis, soy original a tope (en algunas instalaciones puede no aparecer esta pantalla, por lo tanto, en esos casos pasaríamos directamente a la siguiente pantalla).

Damos intro y....tatatachán...ya hemos comenzado a pasar el xpediter a nuestro programa.

A partir de aquí hay una serie de cosas que deberías saber:

1) Si das PF9 estarías ejecutando línea a línea.

2) Si das PF12 irías al final del programa y lo finalizarías. A menos que no 

    hubieras puesto previamente un punto de ruptura, en cuyo caso iría a

    dicho punto de ruptura.

3) ¿Cómo se pone un punto de ruptura? Poniendo una B en aquella línea a la

    que queremos ir directamente.

4) Si ponemos SS al inicio de una línea y otra vez SS varias líneas después lo

    que haríamos sería que esas líneas de código no se ejecutarían.

5) Si estamos en un determinado punto del programa y queremos ir varias 

    líneas hacia atrás, ¿cómo se hace? Poniendo GT al inicio de la línea a la 

    que queramos retroceder.

Esto es lo básico que necesitas saber para pasar un programa por xpediter.

Pues esto es el xpediter para batch. Espero que te haya servido de ayuda, si tienes alguna duda no dudes en preguntar.