In diesem Abschnitt finden Sie Beispiele zu folgenden Themen:
Steuerung der Migration
Migration von S1 auf S2
Löschen von leeren Sicherungsdateien
Reorganisieren von Sicherungsdateien auf S1
Reorganisieren von Migrations-Sicherungsdateien auf S2
Anwendung der SHOW-PUBSET-USAGE-Anweisung (mit Ausgabe von wiedergewinnbarem Speicherplatz und Inkonsistenzen)
Die Beispiele beziehen sich auf die HSMS-Konfiguration, die auf "Einrichten einer HSMS-Konfiguration (Beispiel)" beschrieben ist.
Steuerung der Migration
Die HSMS-Parameter werden so eingestellt, dass Dateien nur durch den HSMS-Verwalter migriert werden können. Zurückgeholt werden können die Dateien dagegen auch von nicht privilegierten Benutzern.
//MODIFY-ARCHIVE-ATTRIBUTES ARCH-NAME=$SYSHSMS.HSMS.MIG.Y, - —————————— (1) // USER-ACCESS=*ALL-USERS(ACCESS=*READ) % HSM0003 HSMS STATEMENT COMPLETED //MODIFY-HSMS-PARAMETERS - // MIGR-CONTROL=*PAR(RECALL-FROM-S2=*ALLOWED) ——————————————————————— (2) % HSM0003 HSMS STATEMENT COMPLETED
(1) | Für das Migrationsarchiv wird nur Lesezugriff erlaubt, d.h. nur der HSMS-Verwalter als Archiveigentümer kann in dieses Archiv migrieren. Nicht-privilegierte Benutzer können Dateien aus diesem Archiv zurückholen. |
(2) | Das implizite Zurückholen von S2 wird zugelassen. |
Migration von S1 auf S2
//MIGRATE FILES - // FROM-STOR=*S1-STOR(S1-PUB-ID=2BC, - // ARCH-NAME=$SYSHSMS.HSMS.MI.2BY,MIN-DAYS-ON-S1=65), - ——————————— (1) // OPER-CONTROL=*PAR(REPORT=*NONE) % HSM0003 HSMS STATEMENT COMPLETED
(1) | Alle Dateien, die schon mindestens 65 Tage lang auf S1 liegen, werden auf S2 migriert. Dabei wird davon ausgegangen, dass migrierte Dateien, die gelegentlich benutzt werden, inzwischen auf S0 zurückgeholt wurden. D.h. nur Dateien, auf die seit mindestens 65+28 Tagen (Migration auf S1) nicht mehr zugegriffen wurde, müssen von S2 zurückgeholt werden. Alle anderen verbleiben auf S1. |
Löschen von leeren Sicherungsdateien
//MIGRATE-FILES - ———————————————————————————————————————————————————— (1) // FROM-STOR=*S1-STOR(S1-PUB-ID=2BC,UNUSED-SPACE=100, - // TO-STOR=*S1-STOR), - // OPER-CONTROL=*PAR(REPORT=*FULL, - // OUT=HSMS.MAN.R.MGF.5,WAIT-F-C=*YES) % HSM0003 HSMS STATEMENT COMPLETED ... Ausgabe des Reports HSMS.MAN.R.MGF.5 ————————————————————————————————— (2)
(1) | Alle Sicherungsdateien im System-Migrationsarchiv, die zu 100% ungültige Dateien enthalten, die also leer sind, werden verdrängt und damit gelöscht. |
(2) | Der Report zeigt auf der letzten Seite einen anderen Kopf, nämlich |
Reorganisieren von Sicherungsdateien auf S1
//MIGRATE-FILES - ———————————————————————————————————————————————————— (1) // FROM-STOR=*S1-STOR(S1-PUB-ID=2BC,TO-STOR=*S1-STOR), - // OPER-CONTROL=*PAR(REPORT=*FULL,OUT=HSMS.MAN.R.MGF.4, - // WAIT-F-C=*YES) % HSM0003 HSMS STATEMENT COMPLETED
(1) | Die Sicherungsdateien des System-Migrationsarchivs auf S1 werden reorganisiert. Dabei werden alle Sicherungsdateien umgesetzt, die ungültige Dateien enthalten (RELEASE-PAGES=*MAXIMUM ist Standard). |
Reorganisieren von Migrations-Sicherungsdateien auf S2
Das Archiv $SYSHSMS.A.MIGRATE enthält 2 Sicherungsdateien und die Standard-Sicherungsdatei:
SHOW-ARCHIVE (SAVE-FILES) INFORMATION = SUMMARY ENVIRONMENT = SF ARCHIVE-NAME = $SYSHSMS.A.MIGRATE SAVE-FILE-STATE = ANY SAVE-FILE-STORAGE = ANY CREATED-BEFORE = LATEST EXPIRATION-BEFORE = LATEST -------------------------------------------------------------------------------- M SFID CREA-DATE EXP-DATE OBS ACCESS ST DEVICE #VOL #SV #RUNS S.160521.130622 16-05-21 16-05-21 YES OWNER TAP TAPE-C4 1 1 1 S.160521.133641 16-05-21 16-05-21 YES OWNER TAP TAPE-C4 1 1 1 S.160521.135324 16-05-21 16-05-21 YES OWNER TAP TAPE-C4 1 1 1 -------------------------------------------------------------------------------- NEXT-PAGE : + (+, -, ++, --, E) % HSM0012 END OF OUTPUT LIST REACHED
Die Sicherungsdateien vor dem Wechsel der Standard-Sicherungsdatei sollen mit der Anweisung MIGRATE-FILES reorganisiert werden:
//MIGRATE-FILES - // FROM-STOR=*S2-STOR(SAVE-FILE-ID=*ALL, - // UNUSED-SPACE=*ANY,ARCHIVE-NAME=*SYSMIGRATE), - // OPER-CONTROL=*PAR(OUT=PROT.S2REO)
Ausgabe des Protokolls:
*** MIGRATE - FILES HSMS V11.0 SUMMARY REPORT *** 2016-05-21 14:34:27 PAGE 1
REQUEST-ENVIRONMENT=SF
REQUEST-NAME=MGF#0015 REQUEST-DATE=2016-05-21 14:20:28 USER-ID=SYSHSMS REQUEST-STATE=COMPLETED WITH WARNINGS
STATEMENT LISTING:
MGF FROM-STORAGE=*S2-STORAGE-LEVEL,OPERATION-CONTROL=*PARAMETERS(OUTPUT=PROT.S2REO)
ENVIRONMENT : SF
ARCHIVE-NAME : $SYSHSMS.A.MIGRATE
SAVE-FILE ATTRIBUTES
TO-STORAGE : S2-STORAGE-LEVEL
DEVICE-TYPE : TAPE-C4
RETENTION-PERIOD : 0
SAVE-VERSION ATTRIBUTES
SAVE-VERSION-NAME : MIGRATE
*** MIGRATE - FILES HSMS V11.0 SUMMARY REPORT *** 2016-05-21 14:34:27 PAGE 2
REQUEST-ENVIRONMENT=SF
REQUEST-NAME=MGF#0015 REQUEST-DATE=2016-05-21 14:20:28 USER-ID=SYSHSMS REQUEST-STATE=COMPLETED WITH WARNINGS
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160521.142625', VERSION '11.0'
% HSM0476 SAVE FILE 'S.160521.130622' DELETED DURING REORGANIZATION
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160521.142747', VERSION '11.0'
% ARC0096 MIGRATED FILE ':A:$TSOS.TTT1' NOT COPIED
% ARC0033 ARCHIVE SUBTASK TSN '0AAL' GENERATED
% ARC0815 SUBTASK '0' HAS TRANSFERRED '3' PAM PAGES FOR '1' FILES AND '0' JVS IN '10' SECONDS
% HSM0475 SAVE FILE 'S.160521.133641' REORGANIZED INTO SAVE FILE 'S.160521.142747'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160521.143149', VERSION '11.0'
SAVE FILE IDENTIFIER - S.160521.142747
SUBSAVE
NUMBER VSNS
0 TAPE04
*** E N D O F HSMS V11.0 SUMMARY REPORT *** 2016-05-21 14:34:27 ***
Die Sicherungsdatei S.160521.130622 enthielt keine gültigen Dateien mehr und wurde daraufhin gelöscht. Die Sicherungsdatei S.160521.133641 wurde reorganisiert in die Sicherungsdatei S.160521.142747.
SHOW-ARCHIVE (SAVE-FILES) INFORMATION = SUMMARY ENVIRONMENT = SF ARCHIVE-NAME = $SYSHSMS.A.MIGRATE SAVE-FILE-STATE = ANY SAVE-FILE-STORAGE = ANY CREATED-BEFORE = LATEST EXPIRATION-BEFORE = LATEST -------------------------------------------------------------------------------- M SFID CREA-DATE EXP-DATE OBS ACCESS ST DEVICE #VOL #SV #RUNS S.160521.135324 16-05-21 16-05-21 YES OWNER TAP TAPE-C4 1 1 1 S.160521.142747 16-05-21 16-05-21 YES OWNER TAP TAPE-C4 1 1 1 -------------------------------------------------------------------------------- NEXT-PAGE : + (+, -, ++, --, E) % HSM0012 END OF OUTPUT LIST REACHED
Anwendung der SHOW-PUBSET-USAGE-Anweisung
Dateien werden verdrängt, einige dieser Dateien anschließend gelöscht. Der durch die Reorganisation wiedergewinnbare Platz wird ausgegeben.
Außerdem wird eine Inkonsistenz im Migrationsarchiv erzeugt und ausgegeben.
//START-HSMS //MIGRATE-FILES - ———————————————————————————————————————————————————— (1) // FROM-STOR=*S0-STOR(F-NAMES=$MANUAL.FILE.*7*,TO-STOR=*S1-STOR) - // OPER-CONTROL=*PAR(REPORT=*FULL,OUT=HSMS.MAN.R.MGF.6, - // WAIT-F-C=*YES) % HSM0003 HSMS STATEMENT COMPLETED Ausgabe des Reports HSMS.MAN.R.MGF.6 ————————————————————————————————— (2) . Verdrängung weiterer Dateien, FILE.*6*, FILE.*5*, FILE.*4*, FILE.* ———— (3) . //BACKUP-FILES F-NAMES=$MANUAL., - ——————————————————————————————————— (4) // TO-STOR=*S1-STOR, - // OPER-CONTROL=*PAR(REPORT=*FULL,OUT=HSMS.MAN.R.BCF.7, - // WAIT-F-C=*YES) % HSM0003 HSMS STATEMENT COMPLETED Ausgabe des Reports HSMS.MAN.R.BCF.7 ————————————————————————————————— (5) //END % HSM0014 HSMS PROGRAM TERMINATED /DELETE-FILE FILE-NAME=$MANUAL.FILE.*1* —————————————————————————————— (6) /DELETE-FILE FILE-NAME=$MANUAL.FILE.*2 //SHOW-PUBSET-USAGE PUB-ID=2BC,INF=*REUS-S1-SPACE ———————————————————— (7)
SHOW-PUBSET-USAGE PUBSET-ID = 2BC INFORMATION = REUSABLE-S1-SPACE
MINIMUM-SIZE = NONE MINIMUM-DAYS-ON-S1 = 0 MAXIMUM-DAYS-ON-S1 = 9999
ARCHIVE-NAME = *SYSMIGRATE
--------------------------------------------------------------------------------
PUBSET: 2BC CAPACITY: 663345 %USED: 84.6 %AVAIL: 15.4
--------------------------------------------------------------------------------
% UNUSED-SPACE #SAVE-FILES #PAGES #UNUSED-PAGES
= 100 0 0 0
90 - 100 0 0 0
80 - 90 0 0 0
70 - 80 0 0 0
60 - 70 1 82 53
50 - 60 0 0 0
40 - 50 0 0 0
30 - 40 4 175 57
20 - 30 0 0 0
10 - 20 0 0 0
00 - 10 0 0 0
= 00 0 0 0
--------------------------------------------------------------------------------
TOTAL 5 257 110
--------------------------------------------------------------------------------
NEXT-PAGE : __ (+, -, ++, --, E)
% HSM0003 HSMS STATEMENT COMPLETED
//MIGRATE-FILES- ————————————————————————————————————————————————————— (8)
// FROM-STOR=*S1-STOR(S1-PUB-ID=2BC,TO-STOR=*S1-STOR), -
// OPER-CONTROL=*PAR(REPORT=*FULL,OUT=HSMS.MAN.R.MGF.7, -
// WAIT-F-C=*YES)
% HSM0003 HSMS STATEMENT COMPLETED
Report HSMS.MAN.R.MGF.7 (Ausschnitt): ———————————————————————————————— (9)
*** MIGRATE - FILES HSMS V11.0 FULL REPORT *** 2016-08-12 14:54:39 PAGE 2
REQUEST-ENVIRONMENT=SF
REQUEST-NAME=MGF#0AAK REQUEST-DATE=2016-08-12 14:52:48 USER-ID=SYSHSMS REQUEST-STATE=COMPLETED WITH WARNINGS
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145256', VERSION='11.0'
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.17' NOT COPIED
% ARC0033 ARCHIVE SUBTASK TSN '0ACQ' GENERATED
% HSM0475 SAVE FILE 'S.160812.145048' REORGANIZED INTO SAVE FILE 'S.160812.145256'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145314', VERSION='11.0'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145317', VERSION='11.0'
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.16' NOT COPIED
% ARC0033 ARCHIVE SUBTASK TSN '0ACR' GENERATED
usw.
% HSM0475 SAVE FILE 'S.160812.145148' REORGANIZED INTO SAVE FILE 'S.160812.145358'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145415', VERSION='11.0'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145418', VERSION='11.0'
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.01' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.02' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.11' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.12' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.13' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.21' NOT COPIED
% ARC0096 MIGRATED FILE ':2BY:$MANUAL.FILE.22' NOT COPIED
% ARC0033 ARCHIVE SUBTASK TSN '0ACU GENERATED
% HSM0475 SAVE FILE 'S.160812.145208' REORGANIZED INTO SAVE FILE 'S.160812.145418'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145436', VERSION='11.0'
% HSM0473 REORGANIZATION COMPLETED. '114' PAGES ON S1 STORAGE RELEASED
//RESTORE-FILES -
// F-NAMES=$MANUAL.FILE., -
// REPLACE-FILES-AND-JV=*NO, -
// OPER-CONTROL=*PAR(REPORT=*FULL,OUT=HSMS.MAN.R.RSF.7, -
// WAIT-F-C=*YES)
% HSM0003 HSMS STATEMENT COMPLETED
Report HSMS.MAN.R.RSF.7 (Ausschnitt):
*** RESTORE - FILES HSMS V11.0 FULL REPORT *** 2016-08-12 14:54:48 PAGE 3
REQUEST-ENVIRONMENT=SF
REQUEST-NAME=RSF#0AAK REQUEST-DATE=2016-08-12 14:54:40 USER-ID=SYSHSMS REQUEST-STATE=COMPLETED WITH WARNINGS
*** CATALOG - 2BY USER - MANUAL ***
FILE/JOB VARIABLE NAME LASTPG/ SAVE VERSION SAVE INPUT SUB OUTPUT
VERS SIZE IDENTIFIER TYPE VSN SAVE DISK(S)
FILE.03 1 13 160812.145229 MIGF 0:2BC 0
% ARC0035 FILE TO BE RESTORED ALREADY EXISTS. FILE NOT REPLACED
FILE.04 1 18 160812.145229 MIGF 0:2BC 0
% ARC0035 FILE TO BE RESTORED ALREADY EXISTS. FILE NOT REPLACED
usw.
FILE.27 1 6 160812.145229 MIGF 0:2BC 0
% ARC0035 FILE TO BE RESTORED ALREADY EXISTS. FILE NOT REPLACED
FILE.01 1 3 160812.145229 MIGF 0:2BC 0
FILE.02 1 8 160812.145229 MIGF 0:2BC 0
FILE.11 1 3 160812.145229 MIGF 0:2BC 0
FILE.12 1 8 160812.145229 MIGF 0:2BC 0
usw.
FILE.22 1 8 160812.145229 MIGF 0:2BC 0
*** E N D O F HSMS V11.0 FULL REPORT *** 2016-08-12 14:54:48 ***
//END
% HSM0014 HSMS PROGRAM TERMINATED /DELETE-FILE FILE-NAME=:2BC:$TSOS.ARCHIVE.SAVE.FILE. - ——————————————— (10) / 160812.145256.0 //SHOW-PUBSET-USAGE PUB-ID=2BY,INF=*MIG-EVAL —————————————————————————— (11) % HSM0433 DMS ERROR '0333' DURING 'CATALOG-'ACCESS TO FILE ':2BC:$TSOS.ARCHIVE.SAVE.FILE.160812.145256.0'
SHOW-PUBSET-USAGE INFORMATION = MIGRATION-EVALUATION S0-PUBSET: 2BY S1-PUBSET: 2BC USER-ID: MANUAL -------------------------------------------------------------------------------- INCONSISTENT FILE ERROR FILE.01 NOT-IN-ARC FILE.02 NOT-IN-ARC FILE.07 NO-S1-DATA FILE.11 NOT-IN-ARC FILE.12 NOT-IN-ARC FILE.13 NOT-IN-ARC FILE.14 NOT-IN-ARC FILE.15 NOT-IN-ARC FILE.16 NOT-IN-ARC FILE.17 NOT-IN-ARC FILE.21 NOT-IN-ARC FILE.22 NOT-IN-ARC FILE.27 NO-S1-DATA -------------------------------------------------------------------------------- NEXT-PAGE : __ (+, -, ++, --, E)
% HSM0003 HSMS STATEMENT COMPLETED //END % HSM0014 HSMS PROGRAM TERMINATED
(1) | Die Dateien der Benutzerkennung MANUAL mit Namen FILE.*7* werden in das System-Migrationsarchiv verdrängt. |
(2) | Der von HSMS erzeugte Report des Migrationslaufs wird ausgegeben. Er enthält u.a. auch die SFID des Migrationslaufs. |
(3) | Weitere Dateien der Kennung MANUAL werden verdrängt. Um für das Beispiel verschiedene Sicherungsdateien zu erzeugen, geschieht dies in getrennten Migrationsläufen. |
(4) | Die vorher verdrängten Dateien werden in das System-Backup-Archiv gesichert. Weil der Operand SAVE-OPTIONS nicht angegeben ist, gilt der voreingestellte Wert des System-Backup-Archivs. |
(5) | Der von HSMS erzeugte Report wird ausgegeben. Entsprechend der Standardeinstellung wurden nur die Katalogeinträge der migrierten Dateien gesichert (Sicherungstyp MIGF). |
(6) | Ein Teil der zuvor verdrängten und dann gesicherten Dateien wird auf der Verarbeitungsebene gelöscht und damit ungültig. |
(7) | Die Ausgabe mit SHOW-PUBSET-USAGE zeigt, dass einige Sicherungsdateien durch das Löschen der Katalogeinträge ungültige Dateien enthalten und wie viele Seiten durch eine Reorganisation einzusparen wären. |
(8) | Durch das Migrieren innerhalb der S1-Ebene wird eine Reorganisation aller Sicherungsdateien auf dem Pubset 2BC angestoßen. |
(9) | Der von HSMS erzeugte Report zeigt die übernommenen Sicherungsdateien mit der Meldung HSM0475. Die Dateien, die nicht übernommen wurden, weil sie ungültig (gelöscht) sind, werden mit der Meldung ARC0096 aufgelistet. |
(10) | Alle vorher gesicherten Dateien werden auf die Verarbeitungsebene zurückgeholt, wobei existierende Dateien nicht überschrieben werden. |
(11) | Der Report zeigt, dass die existierenden Dateien zu Warnmeldungen geführt haben. Dagegen wurden die vorher gelöschten Dateien auf die Verabeitungsebene zurückgeholt. |
(12) | Die Sicherungsdatei, die nach der Reorganisation die Dateien FILE.07 und .27 enthält (siehe oben), wird (nur zu Demonstrationszwecken) gelöscht. |
(13) | Deshalb zeigt SHOW-PUBSET-USAGE jetzt Inkonsistenzen auf: |