This section provides examples dealing with the following subjects:
Controlling migration
Migration from S1 to S2
Deletion of empty save files
Reorganizing save files on S1
Reorganizing migrate save files on S2
Employing the SHOW-PUBSET-USAGE statement (with output of reusable storage space and inconsistencies).
The examples are based on the HSMS configuration described in "Creating an HSMS configuration (example)".
Controlling migration
The HSMS parameters are set so as to permit migration by the HSMS administrator only. However, files can be recalled by nonprivileged users also.
//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) | Only read access is permitted for the migration archive, i.e. only the HSMS administrator, who is the archive owner, can migrate files to this archive. Nonprivileged users can recall files from this archive. |
(2) | The implicit recall of files from S2 is permitted. |
Migration from S1 to 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) | All files which have been on S1 for at least 65 days are migrated to S2; one can assume that migrated files which are used from time to time have already been recalled to S0 at some point. One can assume that migrated files which are used from time to time have already been recalled to S0 at some point. This means that only those files which were not accessed for at least the last 65+28 days (migration to S1) must be recalled from S2. All other files remain on S1. |
Deletion of empty save files
//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 ... Output from the report HSMS.MAN.R.MGF.5 ————————————————————————————————— (2)
(1) | All save files in the system migration archive which contain only invalid files, i.e. which are considered empty, are migrated and thus deleted. |
(2) | The last page of the report has a different header, namely |
Reorganizing save files on 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) | The save files of the system migration archive on S1 are reorganized. All save files containing invalid files are converted (RELEASE-PAGES=*MAXIMUM is the default value). |
Reorganizing migrate save files on S2
The $SYSHSMS.A.MIGRATE archive contains 2 save files and the standard save file:
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
The save files from before the standard save file is changed are to be reorganized using the MIGRATE-FILES statement:
//MIGRATE-FILES - // FROM-STOR=*S2-STOR(SAVE-FILE-ID=*ALL, - // UNUSED-SPACE=*ANY,ARCHIVE-NAME=*SYSMIGRATE), - // OPER-CONTROL=*PAR(OUT=PROT.S2REO)
Output of the log:
*** MIGRATE - FILES HSMS V12.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 V12.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 '12.0'
% HSM0476 SAVE FILE 'S.160521.130622' DELETED DURING REORGANIZATION
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160521.142747', VERSION '12.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 '12.0'
SAVE FILE IDENTIFIER - S.160521.142747
SUBSAVE
NUMBER VSNS
0 TAPE04
*** E N D O F HSMS V12.0 SUMMARY REPORT *** 2016-05-21 14:34:27
***
Save file S.160521.130622 no longer contained any valid files and was therefore deleted.
Save file S.160521.133641 was reorganized into save file 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
Use of the SHOW-PUBSET-USAGE statement
Files are migrated, some of them are subsequently deleted. The reusable space to be gained by reorganization is displayed. Moreover, an inconsistency created in the migration archive is output.
//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 Report output HSMS.MAN.R.MGF.6 ————————————————————————————————— (2) . Migration of further files, 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 Report output 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 (exctract): ———————————————————————————————— (9)
*** MIGRATE - FILES HSMS V12.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='12.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='12.0'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145317', VERSION='12.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='12.0'
% ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.160812.145418', VERSION='12.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='12.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 (extract):
*** RESTORE - FILES HSMS V12.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 V12.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) | The files named FILE.*7* of user ID MANUAL are migrated to the system migration archive. |
(2) | The HSMS-generated report of the migration run is output. Among other things, it also contains the SFID of the migration run |
(3) | Further files of user ID MANUAL are migrated. This is done in separate migration runs so that different save files are created for the example. |
(4) | The migrated files are saved to the system backup archive. Since the SAVE-OPTIONS operand is omitted, the default value for the system backup archive applies. |
(5) | The HSMS-generated report is output. In accordance with the default setting, only the catalog entries of the migrated files have been saved (backup type MIGF). |
(6) | Some of the previously migrated and subsequently saved files are deleted on the processing level and thus become invalid. |
(7) | Output via SHOW-PUBSET-USAGE shows that some save files contain files that have become invalid through deletion of the respective catalog entries, and how many pages could be saved by reorganization. |
(8) | The migration within the S1 level reorganizes all save files on pubset 2BC. |
(9) | Message HSM0475 in the HSMS-generated report indicates the transferred save files. The files not copied because they are invalid (deleted) are listed with message ARC0096. |
(10) | All files previously saved are recalled to the processing level without overwriting any existing files. |
(11) | The report shows that the existing files have triggered warnings. The previously deleted files, on the other hand, have been recalled to the processing level. |
(12) | The save file containing files FILE.07 and .27 after reorganization (see above) is deleted (for demonstration purposes). |
(13) | As a consequence, SHOW-PUBSET-USAGE now indicates inconsistencies: |