Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
Persona que Elaboró el Boletín Héctor Armas Garduño Fecha de Elaboración 15/01/2005
Plataforma Sub - Sistema Aplicación
“Comandos Básicos del DFSMShsm”
Contenido
1. Objetivo...................................................................................................................................................................................1
2. Ambito de la Nota..................................................................................................................................................................1
3. Descripción.............................................................................................................................................................................1
4. Ejemplos..................................................................................................................................................................................6
1. Objetivo
Que los usuarios puedan
· Listar lo que tienen respaldado y verificar en qué nivel de migración está su archivo o librería.
· Respaldar sus archivos y librerías.
· Recuperar versiones de respaldo de sus archivos y librerías.
· Migrar sus archivos y librerías.
· Llamar a un archivo ó librería que esté migrado.
2. Ambito de la Nota
Todos los usuarios que tengan acceso al TSO en el Sistema de Producción y Desarrollo del sistema OS/390.
3. Descripción
El DFHSM es una utilería con la que cuenta la instalación para el respaldo y migración automática de todos los
archivos y librerías en los ambientes de Producción y Desarrollo de Banco Santander. Así como el DFHSM
hace sus funciones automáticamente. El usuario puede ejecutar las mismas funciones, pero manualmente, esto
con el fin de no ser dependiente del proceso automático. El DFHSM cuenta con comandos básicos que son muy
útiles para todos los usuarios, es decir, podremos respaldar nuestro archivo ó librería en cualquier momento,
podremos migrar nuestras librerías y archivos en cualquier momento, etc. A continuación describiremos el uso
de estos comandos básicos y ejemplos respectivos.
3.1. Respaldo de Archivos y Librerías
Existen dos formas para hacer un respaldo.
3.1.1. Por TSO Ejecutar el Siguiente Comando
TSO HBACKDS Dsname
Donde
Dsname es el nombre del archivo ó librería a respaldar
Dirección de Soporte Técnico Página 1 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
3.1.2. La otra forma es ejecutar el mismo comando, pero tecleándolo al lado izquierdo del
nombre del archivo ó librería, después que se haya listado por la opción 1.3.4 de ISPF.
DSLIST - Data Sets Matching [Link] Row 1 of 1
COMMAND ===> SCROLL ===> CSR
COMMAND - Enter "/" to select action MESSAGE VOLUME
-------------------------------------------------------------------------------------------------------------
HBACKDS [Link] DPO100
*************************END OF DATA SET LIST *************************
3.2. Recuperar Archivos y Librerías
La recuperación de un archivo ó librería se realiza en los siguientes casos
Al haber borrado una librería ó archivo por equivocación.
Al haber borrado un miembro de una librería.
Al haber actualizado un miembro por error.
Dependiendo de lo que se quiera recuperar, existen varias formas de efectuar dicha recuperación. Antes de
efectuar la recuperación debemos listar lo que se tiene respaldo (Ver Listar archivos ó librerías respaldados
ó migrados).
3.2.1. Si se borró nuestro archivo ó librería debemos ejecutar el siguiente comando por TSO.
TSO HRECOVER Dsname
Donde
Dsname es el nombre del archivo ó librería.
3.2.2. Si se borró un miembro de una librería ó se modificó, ejecutar el siguiente comando.
TSO HRECOVER Dsname NEWNAME(NewDsname)
Donde
Dsname es el nombre de la librería.
NewDsname es el nuevo nombre de la librería que quiero recuperar.
Lógicamente lo que sigue hacer es una copia del miembro recuperado a la librería original, ya sea con
el mismo nombre o con otro, dependiendo de la necesidad, y posteriormente se procederá a borrar la
librería recuperada.
Si no nos sirve el respaldo más actual, podemos recuperar por fecha de generación. En estos momentos se
puede tener de 2 a 7 versiones de una librería ó archivo si diariamente es modificada (dependiendo del tipo
de información a respaldar, ya que las bibliotecas base del entorno de Altair son las únicas que pueden
tener hasta 7 respaldos, en los demás casos el número de versiones es de 2). Estas versiones las podemos
verificar cuando se lista el archivo o librería a recuperar.
Dirección de Soporte Técnico Página 2 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
3.2.3. Si queremos recuperar una generación en especial que sea diferente a la 0, ejecutar el
siguiente comando.
TSO HRECOVER Dsname GEN(Numgeracion) NEWNAME(NewDsname)
Donde
Dsname es el nombre de la librería ó archivo.
NewDsname es el nuevo nombre de la librería ó archivo que quiero recuperar.
Numgeneracion es el número de la generación del archivo ó librería a recuperar.
3.2.4. Si al momento de recuperar una librería ó archivo, me aparece un mensaje que dice que
no hay espacio suficiente en el disco donde se está tratando de alojar, lo podemos
recuperar en otro disco, ejecutando el siguiente comando en TSO.
TSO HRECOVER Dsname NEWNAME(NewDsname) TOVOLUME(Newvol) UNIT(3390)
Donde
Dsname es el nombre de la librería ó archivo.
NewDsname es el nuevo nombre de la librería ó archivo que quiero recuperar.
Newvol es el disco donde recuperaremos la librería ó archivo
3.2.5. Si se quiere reemplazar el archivo ó la librería que existe actualmente se ejecutará el
siguiente comando.
TSO HRECOVER Dsname REPLACE
Donde
Dsname es el nombre de la librería ó archivo.
3.3. Listar Archivos ó Librerías Respaldadas ó Migradas
Para poder recuperar una generación de una librería ó archivo en especial debemos saber con cuales
versiones contamos, para estos debemos listar el archivo ó librería, de la misma manera si queremos saber
en que nivel de migración se encuentra mi archivo, debemos de listar el archivo ó librería. Para obtener esta
información existen 2 maneras de hacerlo:
3.3.1. Ejecutar el siguiente comando en TSO.
TSO HLIST DSN(Dsname) BOTH TERMINAL
Donde
Dsname es el nombre de la librería ó archivo.
3.3.2. La otra forma es ejecutar el mismo comando, pero tecleándolo el siguiente comando al
lado izquierdo del nombre del archivo ó librería, después que se haya listado por la opción
1.3.4 de ISPF.
Dirección de Soporte Técnico Página 3 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
DSLIST - Data Sets Matching [Link] Row 1 of 1
COMMAND ===> SCROLL ===> CSR
COMMAND NAME MESSAGE VOLUME
-----------------------------------------------------------------------------------------------------------
HLIST DSN(/) BOTH TERM IB DPO102
*************************END OF DATASET LIST*************************
La información que podríamos obtener al ejecutar el comando anterior sería como el que a continuación
mostramos:
ARC0138I NO MCDS INFORMATION FOUND FOR DATASET [Link]
DSN=[Link] BACK FREQ = *** MAX VERS=***
BDSN=[Link].J0288 BACKVOL=V05534 FRVOL=DPO102
BACKDATE=00/10/14 BACKTIME=[Link] CAT=YES GEN=000 VER=008 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0287 BACKVOL=V05459 FRVOL=DPO102
BACKDATE=00/10/13 BACKTIME=[Link] CAT=YES GEN=001 VER=007 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0286 BACKVOL=V04948 FRVOL=DPO102
BACKDATE=00/10/12 BACKTIME=[Link] CAT=YES GEN=002 VER=006 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0285 BACKVOL=V05219 FRVOL=DPO102
BACKDATE=00/10/11 BACKTIME=[Link] CAT=YES GEN=003 VER=005 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0284 BACKVOL=V05083 FRVOL=DPO102
BACKDATE=00/10/10 BACKTIME=[Link] CAT=YES GEN=004 VER=004 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0281 BACKVOL=V04110 FRVOL=DPO102
BACKDATE=00/10/07 BACKTIME=[Link] CAT=YES GEN=005 VER=003 UNS/RET= NO
RACF IND=NO BACK PROF=NO
BDSN=[Link].J0280 BACKVOL=V04000 FRVOL=DPO102
BACKDATE=00/10/06 BACKTIME=[Link] CAT=YES GEN=006 VER=002 UNS/RET= NO
RACF IND=NO BACK PROF=NO
ARC0140I LIST COMPLETED, 16 LINE(S) OF DATA OUTPUT
***
Como podemos observar esta librería tiene 7 generaciones que va de la GEN=000 a la GEN=006 y la
fecha de respaldo aparece en el texto BACKDATE. Con esto nos basamos en la recuperación.
3.4. Migrar Archivos y Librerías
En ocasiones es necesario liberar espacio en determinados discos para nuevas alojaciones y por lo regular
siempre se migran aquellos que no son muy referenciados. Existen dos niveles de migración, el nivel 1
Dirección de Soporte Técnico Página 4 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
sigue estando en disco y el nivel 2 se va a cartucho ó cinta. Nosotros podemos indicarle a que nivel
queremos que se vaya nuestro archivo ó librería. Para hacer esto existen dos maneras de hacerlo:
3.4.1. Ejecutar el siguiente comando en TSO.
Llevarlo al nivel 1
TSO HMIGRATE Dsname
Llevarlo al nivel 2
TSO HMIGRATE Dsname ML2
3.4.2. La otra forma es ejecutar el mismo comando, pero tecleándolo del lado izquierdo del
nombre del archivo ó librería, después que se haya listado por la opción 1.3.4 de ISPF.
Llevarlo al nivel 1
DSLIST - Data Sets Matching [Link] Row 1 of 1
COMMAND ===> SCROLL ===> CSR
COMMAND - Enter "/" to select action MESSAGE VOLUME
-----------------------------------------------------------------------------------------------------------
HMIG [Link] DPO100
*************************END OF DATASET LIST*************************
Llevarlo al nivel 2
DSLIST - Data Sets Matching [Link] Row 1 of 1
COMMAND ===> SCROLL ===> CSR
COMMAND - Enter "/" to select action MESSAGE VOLUME
-----------------------------------------------------------------------------------------------------------
HMIG / ML2 [Link] DPO100
*************************END OF DATASET LIST*************************
3.5. Llamar Archivos y Librerías Migradas
Para llamar a una librería tenemos 2 formas de hacerlo.
3.5.1. Ejecutar el siguiente comando en TSO.
HRECALL Dsname
3.5.2. La otra forma es ejecutar el mismo comando, pero tecleándolo del lado izquierdo del
nombre del archivo ó librería, después que se haya listado por la opción 1.3.4 de ISPF.
DSLIST - Data Sets Matching [Link] Row 1 of 1
COMMAND ===> SCROLL ===> CSR
COMMAND - Enter "/" to select action MESSAGE VOLUME
Dirección de Soporte Técnico Página 5 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
-----------------------------------------------------------------------------------------------------------
HRECALL [Link] MIGRAT
*************************END OF DATASET LIST*************************
3.5.3. Si queremos que el archivo ó librería baje en otro disco, ejecutaremos el siguiente
comando utilizando la forma que más le guste:
TSO HRECALL Dsname VOLUME(Newvol) UNIT(3390)
4. Ejemplos
1. Se requiere respaldar una librería que tiene por nombre [Link], debido a que se hicieron
cambios importantes. La manera de respaldarlo dependerá del usuario.
TSO HBACKDS [Link]
2. Se requiere recuperar una librería con el nombre [Link], debido a que fué borrada
accidentalmente.
TSO HRECOVER [Link]
3. Se desea recuperar la librería [Link] con un nuevo nombre que se llame
[Link], debido a que se borró un miembro por equivocación.
TSO HRECOVER [Link] NEWNAME([Link])
4. Se desea recuperar la librería [Link] que fué respaldada el día 5 de octubre del 2000 con
el nombre de [Link]. Después de haber listado las versiones de respaldo de esta
biblioteca se checa que la generación con la fecha de respaldo (BACKDATE=00/10/05) que se requiere
es la 003, además se desea bajar en el disco DPO100.
TSO HRECOVER [Link] GEN(3) NEWNAME([Link])
TOVOLUME(DPO100) UNIT(3390)
5. Se requiere migrar el archivo [Link] al nivel 2.
TSO [Link] ML2
6. Se desea llamar la librería [Link] que se encuentra migrada. Supongamos que la
alojaciòn lo controla el SMS.
TSO HRECALL [Link]
7. Se requiere hacer un Recall al archivo [Link].G4, alojándolo en
el disco CHGMN7.
Dirección de Soporte Técnico Página 6 de 7
Banco Santander Serfín Tipo de documento: Boletín Técnico
Dirección Ejecutiva de Tecnología y Sistemas Clave de documento: [Link]
TSO HRECALL VOLUME(CHGMN7) UNIT(3390)
8. Se requiere obtener información de la librería de usuario [Link], para determinar con
que versiones de respaldo se cuenta y si está migrado en que nivel está.
TSO HLIST DSN([Link]) BOTH TERMINAL
Dirección de Soporte Técnico Página 7 de 7
