Tarjeta de referencia: mandatos de z/OS Debugger más utilizados cuando se depuran programas ensambladores

La siguiente tarjeta de referencia proporciona una lista de los mandatos de z/OS Debugger más utilizados cuando se depuran programas ensambladores. Especifique todos los mandatos en la línea de mandatos, a menos que se indique lo contrario.

Las tarjetas de referencia están diseñadas para imprimirse desde un archivo PDF. Si está viendo esta página a través de Documentación de IBM, siga estas instrucciones para ver la tarjeta de referencia a través de un archivo PDF e imprimirla:

Pulse el tema "Versión de PDF" debajo de "Resumen de consulta de IBM® z/OS" en el panel de navegación. Se abre el archivo PDF de Resumen de consulta de IBM z/OS Debugger.
En la vista de Marcadores (Tabla de contenido) de Adobe, pulse la cabecera del apéndice para la tarjeta de referencia que desea imprimir.
Desplácese a la primera página de la tarjeta de referencia, identifique el número de página en la barra de herramientas de Adobe Reader y, a continuación, tome nota de este número de página. No utilice el número de página impreso en la parte inferior de la página. Desplácese por la tarjeta de referencia para determinar el número de páginas que abarca.
Pulse en Imprimir en la barra de herramientas de Adobe Reader o pulse en Archivo-> Imprimir. En el recuadro "Rango de impresión", seleccione Páginas y, a continuación, escriba el número de página que ha anotado en el paso anterior, seguido de un guión y la última página de la tarjeta de referencia. Por ejemplo, si la primera página de la tarjeta de referencia está en la página 75 y la tarjeta de referencia abarca cuatro páginas, entre "75-79" en el campo Páginas. Si puede imprimir en dúplex, habilite la impresión dúplex. No modifique ningún otro valor; imprima estas páginas como lo haría con cualquier página de orientación vertical.
Pulse en Aceptar o Imprimir para iniciar la impresión.

Establecimiento de puntos de interrupción (puntos de detención) en un programa

A: Escriba A en el área de prefijo de la ventana Source en la línea donde desee establecer un punto de interrupción. Pulse Intro. z/OS Debugger establece un punto de interrupción en esa línea. (A es la abreviatura de AT.)
PF6: Mueva el cursor a la línea donde desee establecer el punto de interrupción. Pulse FP6. z/OS Debugger establece un punto de interrupción en esa línea.
AT 509: z/OS Debugger establece un punto de interrupción en la línea 509.
AT EXIT *: z/OS Debugger establece un punto de interrupción en cada punto de salida del programa.
AT ENTRY *: z/OS Debugger establece un punto de interrupción en cada punto de entrada del programa.
AT ENTRY nombre_cu: z/OS Debugger establece un punto de interrupción en el punto de entrada de nombre_cu.

Borrado (eliminación) de los puntos de interrupción establecidos en un programa

C: Escriba C en el área de prefijo de la ventana Source en la línea que contiene el punto de interrupción que desea eliminar. Pulse Intro. z/OS Debugger elimina el punto de interrupción en esa línea. (C es la abreviatura de CLEAR AT.)
PF6: Mueva el cursor a la línea donde desee eliminar el punto de interrupción. Pulse FP6. z/OS Debugger elimina el punto de interrupción en esa línea.
CLEAR AT 509: z/OS Debugger elimina el punto de interrupción en la línea 509.
CLEAR AT EXIT *: z/OS Debugger elimina puntos de interrupción de cada punto de salida del programa.
CLEAR AT ENTRY *: z/OS Debugger elimina puntos de interrupción de cada punto de entrada del programa.
CLEAR AT: z/OS Debugger elimina todos los puntos de interrupción.

Definir un punto de interrupción diferido

Un punto de interrupción diferido es un punto de interrupción que establece en un programa que todavía no es conocido para z/OS Debugger.

AT ENTRY nombre_cu: Si el nombre de bloque es igual que nombre_cu, ya no tiene que especificar nombre_cu como nombre_cu:>nombre_cu.

Establecimiento de puntos de interrupción condicionales

AT CHANGE ITEMNO: Cuando el valor de ITEMNO cambia, z/OS Debugger detiene el programa. ITEMNO debe conocerse a través de DC, DS o USING.
AT CHANGE _STORAGE (R6 + 1::5): Cuando los datos en la dirección (R6+1) cambian, z/OS Debugger detiene el programa.

Ejemplo de cómo se detiene cuando una variable alcanza un valor específico, cómo se muestra el número de línea donde se detiene el programa y cómo se visualiza el valor de ITEMNO:


AT CHANGE ITEMNO WHEN ITEMNO = ‘00006’ DO QUERY LOC;
LIST (‘ITEMNO CHANGED HERE”, ITEMNO)
END; GO; ;

Puede sustituir ITEMNO = '00006' por ITEMNO = 6 o _STORAGE (R6 + 1::5). Las cláusulas AT CHANGE, WHEN y DO deben estar en la misma línea.

Borrado (eliminación) de puntos de interrupción condicionales

CLEAR AT CHANGE ITEMNO: z/OS Debugger elimina el punto de interrupción que detiene el programa cuando el valor de ITEMNO cambia.

Visualización de datos en un programa

MONITOR LIST ITEMNO SET MON WRAP OFF: z/OS Debugger añade la variable ITEMNO y su valor actual a la ventana Monitor, y muestra todo en una línea.
LIST ITEMNO: z/OS Debugger añade el contenido de ITEMNO al registro.
SET AUTO ON: z/OS Debugger muestra automáticamente valores en la ventana Monitor.
SET AUTO ON LOG: z/OS Debugger muestra automáticamente valores en el registro.

Mandatos de prefijo de la ventana Monitor

Escriba estas letras en el área de prefijo de la ventana Monitor.

C: z/OS Debugger ejecuta el mandato CLEAR MONITOR n, donde n es el número de supervisor asignado a la variable que se está supervisando en esa línea.
H: Muestra el valor de las variables en esta línea en formato hexadecimal.
DEF: Muestra el valor de las variables en esta línea en su formato declarado.

Cambio de valores de variables

ITEMNO = '00006': z/OS Debugger sustituye el valor ITEMNO por 00006.
Escribir encima del valor mostrado: En la ventana Monitor, si el valor está entre cajas negras, escriba el nuevo valor encima del valor mostrado.

Trabajo con programas invocados

STEP INTO: z/OS Debugger entra en el programa que se está invocando y continúa recorriendo el programa.
STEP OVER: z/OS Debugger ejecuta el programa que se está invocando sin mostrar el origen de ese programa.

Especifique la siguiente serie de mandatos para realizar las siguientes tareas:

Identifique nombre_prog en z/OS Debugger.
Debe poder establecer un punto de interrupción en nombre_prog.
Muestre el origen de nombre_prog en la ventana Source.


LOAD nombre_prog;
QUALIFY nombre_prog
QUALIFY RESET;

Volver o encontrar la siguiente línea que se ejecuta

QUALIFY RESET: z/OS Debugger muestra, en la ventana Source, la siguiente línea que ejecutará.

Ensamblador de carga e información de depuración de OSVS COBOL

LDD asmcsect: z/OS Debugger carga la información de depuración desde EQALANGX en la ventana Source.
LDD prog_oscob: z/OS Debugger carga la información de depuración desde EQALANGX en la ventana Source.

Trabajo con registros

MON LI REG: z/OS Debugger añade todos los registros a la ventana Monitor.
LIST STORAGE (%GPR6->+1,5);: z/OS Debugger muestra 5 bytes de almacenamiento empezando en la dirección a la que apunta el registro 6 más 1 byte.
MON LI STORAGE (R6->+1,5);: z/OS Debugger añade a la ventana Monitor 5 bytes de almacenamiento empezando en la dirección a la que apunta el registro 6 más 1 byte.
MON LI _STORAGE(R6 + 1::5): z/OS Debugger añade a la ventana Monitor 5 bytes de almacenamiento empezando en la dirección a la que apunta el registro 6 más 1 byte.

Control de la ejecución del programa

STEP: Ejecuta una instrucción.
PF2: Tecla PF para ejecutar una instrucción.
GO: Ejecuta el programa hasta que termina anormalmente, encuentra un punto de interrupción o finaliza.
PF9: Tecla PF para ejecutar el programa hasta que termina anormalmente, encuentra un punto de interrupción o finaliza.
JUMPTO 27: z/OS Debugger convierte la línea 27 en el punto de ejecución actual, pero no ejecuta la línea 27.
RUNTO 27: z/OS Debugger ejecuta el programa en la línea 27 y luego se detiene.

Guardado de supervisores, puntos de interrupción y valores en
sesiones de depuración

SAVE MONITORS: z/OS Debugger guarda todas las variables que se están supervisando en la ventana Monitor.
SAVE BPS: z/OS Debugger guarda todos los puntos de interrupción.
SAVE SETTINGS: z/OS Debugger guarda todos los valores establecidos por el mandato SET.
RESTORE MONITORS: z/OS Debugger restaura todas las variables guardadas por el mandato SAVE MONITORS en la ventana Monitor.
RESTORE BPS: z/OS Debugger restaura todos los puntos de interrupción guardados por el mandato SAVE BPS.
RESTORE SETTINGS: z/OS Debugger restaura todos los valores guardados por el mandato SAVE SETTINGS.

Ventana Memory

MEMORY ITEMNO: z/OS Debugger muestra el almacenamiento bruto empezando en la ubicación de ITEMNO.
MEMORY X'2503D008': z/OS Debugger muestra la memoria empezando en la dirección base X'2503D008'.
SWAP MEMORY LOG: z/OS Debugger conmuta entre la ventana Memory y la ventana Log.
SET EQUATE SW='SWAP MEM LOG': z/OS Debugger asigna las letras "SW" con el mandato SWAP MEMORY LOG. Posteriormente, especifica SW para conmutar entre la ventana Memory y la ventana Log.

programas pseudonconversacionales de CICS

SET TEST ERROR: z/OS Debugger no se detiene para las excepciones de clase 1 de Language Environment: EXEC CICS RETURN y STOP RUN en el proceso por lotes.
QUIT DEBUG TASK: Detiene z/OS Debugger para esta tarea.

Técnica para ignorar una condición de terminación anómala

GO BYPASS: Omite la condición de excepción y se detiene en el siguiente punto de interrupción.

Técnica para invocar el analizador de errores para DUMP

CALL %FA: z/OS Debugger genera un DUMP que el analizador de errores puede utilizar en su análisis.

Terminar depuración de programa (pruebas)

QUIT: Finaliza z/OS Debugger y el programa deja de ejecutarse.
QQUIT: Finaliza z/OS Debugger sin ninguna solicitud.
QUIT DEBUG: Finaliza z/OS Debugger, pero el programa continúa ejecutándose.
QUIT DEBUG TASK: Finaliza z/OS Debugger, pero el programa continúa ejecutándose.
QUIT ABEND: Provoca un ROLLBACK para los programas IMS y Db2.

Valores de tecla PF recomendados

PF1: "PF13/24"=SET KEYS 24;
PF2: "KEEP"=MON LOCAL %CU LIST CURSOR;
PF3: "QUIT"=QUIT;
PF4: "CURRLINE"=QUALIFY RESET
PF5: "FIND"=FIND;
PF7: "UP"=SCROLL UP;
PF8: "DOWN"=SCROLL DOWN;
PF9: "GO 1"=STEP'
PF10: "ZOOM WIN"=IMMEDIATE ZOOM;
PF11: "ZOOM LOG"=WINDOW ZOOM LOG;
PF12: "GO"=GO;
PF13: "PF1/12"=SET KEYS 12;
PF14: "CLR KEEP"=CLEAR MONITOR;
PF15: "QUIT"=QUIT;
PF16: "LIST CSR"=LIST CURSOR;
PF17: "FIND"=IMMEDIATE FIND;
PF18: "AT/CLEAR"=AT TOGGLE;
PF19: "TOP"=TOP;
PF20: "BOTTOM"=BOT;
PF21: "GO 1"=STEP;
PF22: "ZOOM WIN"=IMMEDIATE ZOOM;
PF23: "ZOOM LOG"=WINDOW ZOOM LOG;
PF24: "RETRIEVE"=IMMEDIATE RETRIEVE;