En la entrada MVS/QuickRef 8.2 - Demostración breve, hice una pequeña introducción de esta herramienta. En esta entrada, voy a mostrar los ficheros que nos facilitarán y cómo transferirlos al host. Este es el paso previo a la implementación.
Cuando recibamos el software, una de las formas podría ser por FTP o por descarga directa del enlace correspondiente. En mi caso, me facilitaron el enlace de descarga directa. Además, mediante otro enlace me facilitaron la licencia temporal.
Una vez descargado y descomprimido, nos encontraremos lo siguiente:
El fichero “ftp_in” contiene las instrucciones para obtener el software por FTP. Deberemos usar el usuario correspondiente que nos hayan facilitado.
El fichero “ftp_out” contiene las instrucciones para pasar el software que tenemos descargado en el PC, por ejemplo, al host mediante FTP.
El fichero “qrug82” es el manual de uso/implementación de la herramienta. También lo podemos encontrar en la web oficial de QuickRef.
MVS/QuickRef 8.2 - User’s Guide
Los ficheros “QUICKREF.R82.DATABASE” y “QUICKREF.R82.QWLIBREX.EXEC” son los propios de la herramienta.
El fichero “READme” contiene descripciones e instrucciones necesarias.
El fichero “RECEIVE” contiene un paso de un job para obtener el software directamente en el host mediante FTP. Deberemos usar el usuario correspondiente que nos hayan facilitado.
En mi caso, voy a utilizar las instrucciones del fichero “ftp_out” para pasar el software al host.
Primero debemos poner los ficheros “QUICKREF.R82.DATABASE” y “QUICKREF.R82.QWLIBREX.EXEC” y la licencia “QRKEY_DR_SITEID_xxxxxx.qwl” en una misma carpeta de Windows. En mi caso, en la raíz de C, para simplificar.
Abrimos un “cmd” de Windows en modo Administrador para evitar errores de permisos. Vamos a la ruta en la que tenemos el software.
Haremos un ping para comprobar que llegamos al host.
Los pasos que se indican en el fichero ftp_out son los siguiente:
Empezaremos haciendo el “open” contra el host. En vez de usar el comando “open”, pondremos ftp y la ip para hacer el open directamente. Nos pedirá directamente el usuario y contraseña de TSO. En mi caso, usaré el usuario IBMUSER.
ftp 192.168.1.51
Pondremos el comando “binary”.
Usaremos los siguientes comandos para poner los atributos del fichero QUICKREF.R82.QWLIBREX.EXEC.
quote site filetype=seq blksize=27920 lrecl=80 recfm=fb
quote site unit=sysda tracks pri=170 sec=10
Con el siguiente comando pasaremos el fichero QUICKREF.R82.QWLIBREX.EXEC al host. El primer nombre de la librería es el nombre del origen y el segundo el nombre en el destino. El segundo lo pongo entre comillas para evitar que añada “IBMUSER” como prefijo.
put QUICKREF.R82.QWLIBREX.EXEC 'QUICKREF.R82.QWLIBREX.EXEC'
Ahora vamos a establecer los atributos para el fichero QUICKREF.R82.DATABASE.
quote site lrecl=6160 recfm=f blksize=6160 filetype=seq
quote site unit=sysda tracks pri=37921 sec=1000
Pasaremos el fichero de la base de datos al host. Como hemos hecho anteriormente, el nombre del destino lo pondremos entre comillas simples. Este fichero, al pesar casi 2 GB, tardará un poco más en transferirse.
put QUICKREF.R82.DATABASE 'QUICKREF.R82.DATABASE'
Ya tenemos subida la base de datos y el software. Ahora falta por subir la licencia.
Pondremos los atributos del fichero de licencia:
quote site lrecl=10440 blksize=10444 recfm=vb primary=1 unit=3390
Ahora subiremos el fichero:
put QRKEY_DR_SITEID_xxxxxx.qwl 'QUICKREF.R82.LICENSE'
Por último, comprobamos que tenemos esos ficheros en el host.
Ya tenemos ficheros necesarios en el host. En la próxima entrada veremos qué hacer con ellos para implementar la herramienta.