Después de ver cómo implementar QuickRef en zOS, vamos a aprender a utilizarlo. Aunque esta entrada es un poco larga por todos los pantallazos que contiene, es muy fácil de usar y veréis que es siempre se hace de la misma manera.
Hay varias formas de utilizar esta herramienta: a través de los paneles, accediendo directamente a un error concreto o por JCL. En esta entrada nos centraremos en las dos primeras.
Empezaremos viendo cómo usar QuickRef a través de los paneles. Esta es la primera pantalla que nos encontraremos.
Primero entraremos en la opción “C - Request Reference Information by Category”.
En la siguiente pantalla, observamos distintas categorías: codes, glossary, hardware, JCL, etc. Esta opción es útil si queremos buscar información concreta sobre algo y sabemos la categoría en la que está.
Recomiendo echarles un vistazo a todas las categorías, para conocer la información de la que disponemos. Por ejemplo, podemos entrar en la categoría “CODES”.
Entraremos en nuestra versión del sistema. En mi caso, zOS 1.13 (V1R13).
Vemos un listado de códigos de ABEND. Entraremos, por ejemplo, en B37.
Vemos que hay una explicación del error B37 y cómo actuar.
Volvemos a las categorías y entramos en JCL.
Vemos que hay varias opciones para ver ejemplos de sintaxis.
Entraremos en el parámetro deseado, por ejemplo, JOBLIB.
NOTA: Podemos buscar algo concreto con “F texto”, por ejemplo, F JOBLIB.
Vemos una descripción de este parámetro y cómo usarlo dentro de un JCL.
Volvemos a la lista de categorías y entramos en TSO.
Aquí tenemos varias opciones distintas desde ejemplos de comandos de HSM hasta ejemplos de sintaxis de CLIST.
Al entrar en una de las opciones de CLIST, veremos todas las variables del sistema que podemos usar y otros parámetros.
En este caso, la variable &SYSNAME devuelve el nombre del sistema.
Si entramos en la categoría UTILS encontraremos distintas opciones de utilidades: COBOL, DB2, DFSORT, IMS, etc.
Volvemos al panel principal y entramos en la opción “R - Request Reference Information by Name”.
En esta opción, podemos buscar directamente un producto concreto. Por ejemplo, IMS 12.1.
Veremos todos elementos disponibles (9732) que tenemos relacionados con IMS versión 12.1
En mi opinión, esta opción contiene demasiada información como para que sea útil. Para que realmente sea útil, debemos buscar un código de mensaje concreto.
Buscando un código de mensaje, por ejemplo, el EQQV004E, utilizaremos mucho mejor esta opción.
Elegimos la versión correspondiente, por ejemplo. TWS 8.6.
La siguiente opción me parece muy interesante. Se trata de la opción “L - List Vendors, Products, and Releases”.
Podemos buscar los manuales de una compañía concreta: IBM, BMC, CA Technologies, etc. Por ejemplo, podemos buscar BMC.
También podemos buscar los manuales de CA Technologies. Veremos que aparecen distintos manuales, por ejemplo, de ACF2.
También podemos buscar un producto concreto, como CA7.
Veremos los manuales referentes a CA7.
La opción “S - Request DASD Free Space Information” también puede ser de utilidad si no tenemos acceso a ISMF. Desde aquí podremos ver el espacio libre de los discos, storage groups, etc.
También es posible obtener esta información usando JCL.
En el parámetro “Volser”, debemos poner el nombre del disco o el storage group. También podemos usar “comodines” tipo *, %, etc.
En el resultado, podemos poner las columnas que nos interesen y su orden.
Además, podemos ordenar los datos según la columna deseada ya sea ascendente o descendente.
Como en el campo “Volser” he puesto un *, saldrán todos los discos que tengo disponibles. También saldrá el espacio disponible en esos 59 volúmenes. En mi caso, un 30.2%.
Entre la información que aparece, veremos si pertenecen a algún Storage Group.
Vamos a buscar por ese Storage Group.
Vemos que aparecen 3 volúmenes y su espacio libre total es del 56,7%.
También podemos buscar los volúmenes según el tipo de uso que se les da: Public, Private o Storage. Por ejemplo, buscaremos aquellos discos cuyo uso es storage.
NOTA: En la siguiente entrada ya expliqué la diferencia entre el uso que se le puede dar a los discos. https://emuframe.com/index.php/14-creando-discos-en-hercules
Vemos que tienen libre un 67,6%.
También podemos poner parte del nombre de un volumen para mostrar aquellos que coinciden con esa búsqueda.
Ya hemos visto cómo movernos a través de los paneles. Ahora vamos a ver cómo podemos acceder directamente a la información de un mensaje cuando estamos en otras opciones del sistema, por ejemplo, en SDSF.
Entramos a una salida en la que aparezca algún mensaje del que queremos tener información.
En la barra de comandos pondremos QW y posicionaremos el cursor en el mensaje que queremos buscar.
Al pulsar enter, accederemos directamente a QuickRef y veremos la información. Para salir, deberemos pulsar F3 varias veces hasta volver a la pantalla de SDSF.
También existe la posibilidad de asignar el comando QW a una tecla de función para acceder más rápido. Para asignarlo haremos lo siguiente:
Desde SDSF, escribimos Settings.
NOTA: Si es la primera vez que accedemos a Settings desde SDSF, es posible que se desconfiguren las opciones de “Command line at bottom”, “Tab to action bar choices”, etc.
Iremos al menú “Function keys” y entraremos en la opción 1.
En la tecla de función deseada, pondremos el comando “QW”. Yo he sustituido el F6, que antes ponía el comando “BOOK”.
Saldremos del menú Settings y volveremos al job dónde estábamos antes. Simplemente, posicionaremos el cursor en el error que queramos buscar y pulsaremos la tecla de función correspondiente, en mi caso, F6.
Accederemos directamente a QuickRef. Cabe destacar que, accediendo de esta forma, nos mostrará únicamente el manual de IBM de la versión de zOS que estemos usando. Si hay varios manuales dónde se recoge el error, deberemos elegir el correspondiente.
También es posible buscar mensajes de la opción LOG de SDSF.
Al pulsar F6, nos llevará a QuickRef.
Otra opción para buscar un código de error es desde cualquier panel, poner “QW codigo”, por ejemplo, para ver el abend U0457 (choque entre PSBs de IMS) pondremos “QW U0457”.
Elegiremos la versión de IMS correspondiente, aunque en este caso, el error debería ser el mismo en todas las versiones.
Ya hemos visto algunas de las formas de utilizar QuickRef. En mi opinión, es bastante sencillo y ahorra mucho tiempo al buscar aclaraciones de los errores que se producen. En la próxima entrada, veremos cómo usar alguna opción a través de batch (JCL).