Example 1
In the SM pubset SMS1 user TSOS owns files Y2 through Y12, each of which is 3 PAM pages in size. Files Y10, Y11, and Y12 were migrated to level S2 on 08/05/2016 and later retrieved to level S0.
Since then they have only been accessed in read mode.
The migration statement below creates 5 PAM pages of free space in pubset SMS1 by migrating files to level S2:
//MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE=*S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*, RELEASE-PAGES=5),OPERATION-CONTROL=*PARAMETERS(REPORT=*FULL)
*** MIGRATE - FILES HSMS V11.0 FULL REPORT ** 2016-05-21 12:44:17 PAGE 1 REQUEST-ENVIRONMENT=SM(SMS1) REQUEST-NAME=MGF#0015 REQUEST-DATE=2016-05-21 12:44:15 USER-ID=SYSHSMS REQ EST-STATE=COMPLETED WITHOUT ERROR STATEMENT LISTING: MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE= *S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*, RELEASE-PAGES=5),OPERATION-CONTROL=*PARAMETERS(REPORT=*FULL) ENVIRONMENT : SM(SMS1) ARCHIVE-NAME : $SYSHSMS.MAX SAVE-FILE ATTRIBUTES TO-STORAGE : S2-STORAGE-LEVEL DEVICE-TYPE : TAPE-C4 RETENTION-PERIOD : 66 SAVE-VERSION ATTRIBUTES SAVE-VERSION-NAME : MIGRATE *** CATALOG - SMS1 USER - TSOS *** ** OUTPUT SAVE VERSION: SAVE-VERSION-DATE=16-05-08 SAVE-VERSION-TIME=12:12:03 * FILE/JOB VARIABLE NAME LASTPG/ SAVE INPUT DEV SUB OUTPUT VERS SIZE TYPE VSN TYP SAVE VSN(S) Y11 1 0 FULL *REMIG D 0 TAPE01 Y12 1 0 FULL *REMIG D 0 TAPE01 NUMBER OF FILES= 0 GLOBAL SIZE= 0 START= 2016-05-21 12:44:15 END= 2016-05-21 12:44:17 *** E N D O F HSMS V11.0 FULL REPORT *** 2016-05-21 12:44:17 ***
Remigratable files Y11 and Y12 are migrated with priority. Remigration takes place in the HSMS server task without storing the data on S2 again.
Example 2
Another migration statement is now used to migrate the remaining files Y2 through Y10 to S2, Y10 being remigrated. Migration takes place in 2 steps here.
In the first step the remigratable files are migrated (in the HSMS server task).
In the second step the remaining files are migrated by an archive subtask in accordance with the old procedure.
//MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE=*S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*), OPERATION-CONTROL=*PARAMETERS(REPORT=*FULL)
A*** MIGRATE - FILES HSMS V12.0 FULL REPORT *** 2016-05-21 12:45:45 PAGE 1 REQUEST-ENVIRONMENT=SM(SMS1) REQUEST-NAME=MGF#0015 REQUEST-DATE=2016-05-21 12:45:17 USER-ID=SYSHSMS REQ UEST-STATE=COMPLETED WITHOUT ERROR STATEMENT LISTING: MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE=* S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*), OPERATION-CONTROL=*PARAMETERS(REPORT=*FULL) ENVIRONMENT : SM(SMS1) ARCHIVE-NAME : $SYSHSMS.MAX SAVE-FILE ATTRIBUTES TO-STORAGE : S2-STORAGE-LEVEL DEVICE-TYPE : TAPE-C4 RETENTION-PERIOD : 66 SAVE-VERSION ATTRIBUTES SAVE-VERSION-NAME : MIGRATE % ARC0033 ARCHIVE SUBTASK TSN '0AAG' GENERATED % ARC0815 SUBTASK '0' HAS TRANSFERRED '9' PAM PAGES FOR '8' FILES AND '0' JVS IN '0' SECONDS SAVE FILE IDENTIFIER - S.160521.124519 SUBSAVE NUMBER VSNS 0 TAPE02 SAVE FILE IDENTIFIER - S.160521.124519 *** CATALOG - SMS1 USER - TSOS *** ** OUTPUT SAVE VERSION: SAVE-VERSION-DATE=16-05-08 SAVE-VERSION-TIME=12:12:03 * FILE/JOB VARIABLE NAME LASTPG/ SAVE INPUT DEV SUB OUTPUT VERS SIZE TYPE VSN TYP SAVE VSN(S) Y10 1 0 FULL *REMIG D 0 TAPE01 SAVE FILE IDENTIFIER - S.160521.124519 *** CATALOG - SMS1 USER - TSOS *** ** OUTPUT SAVE VERSION: SAVE-VERSION-DATE=16-05-21 SAVE-VERSION-TIME=12:45:20 * FILE/JOB VARIABLE NAME LASTPG/ SAVE INPUT DEV SUB OUTPUT VERS SIZE TYPE VSN TYP SAVE VSN(S) Y2 1 1 FULL PUBK00 D 0 TAPE02 Y3 1 1 FULL PUBK00 D 0 TAPE02 Y4 1 1 FULL PUBK00 D 0 TAPE02 Y5 1 1 FULL PUBK00 D 0 TAPE02 Y6 1 1 FULL PUBK00 D 0 TAPE02 Y7 1 1 FULL PUBK00 D 0 TAPE02 Y8 1 1 FULL PUBK00 D 0 TAPE02 Y9 1 1 FULL PUBK00 D 0 TAPE02 NUMBER OF FILES= 8 GLOBAL SIZE= 8 START= 2016-05-21 12:45:18 END= 2016-05-21 12:45:45 *** E N D O F HSMS V12.0 FULL REPORT *** 2016-05-21 12:45:45 ***
Example 3
The basis here is once more the set of files from example 1. The MIGRATE statement below creates free space in pubset SMS1 by migrating only remigratable files to S2 without storing the data.
//MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE=*S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*, MIGRATION-INFO=*REMIGRATION),OPERATION-CONTROL=*PARAMETERS(REPORT=*FULL)
A*** MIGRATE - FILES HSMS V12.0 FULL REPORT *** 2016-05-21 13:04:35 PAGE 1 REQUEST-ENVIRONMENT=SM(SMS1) REQUEST-NAME=MGF#0015 REQUEST-DATE=2016-05-21 13:04:32 USER-ID=SYSHSMS REQ UEST-STATE=COMPLETED WITHOUT ERROR STATEMENT LISTING: MIGRATE-FILES ENVIRONMENT=*SYSTEM-MANAGED(CATALOG-ID=SMS1), FROM-STORAGE= *S0-STORAGE-LEVEL(FILE-NAMES=:SMS1:Y*, MIGRATION-INFO=*REMIGRATION),OPERATION-CONTROL=*PARAMETERS(REPO RT=*FULL) ENVIRONMENT : SM(SMS1) ARCHIVE-NAME : $SYSHSMS.MAX SAVE-FILE ATTRIBUTES TO-STORAGE : S2-STORAGE-LEVEL DEVICE-TYPE : TAPE-C4 RETENTION-PERIOD : 66 SAVE-VERSION ATTRIBUTES SAVE-VERSION-NAME : MIGRATE *** CATALOG - SMS1 USER - TSOS *** ** OUTPUT SAVE VERSION: SAVE-VERSION-DATE=16-05-08 SAVE-VERSION-TIME=12:12:03 * FILE/JOB VARIABLE NAME LASTPG/ SAVE INPUT DEV SUB OUTPUT VERS SIZE TYPE VSN TYP SAVE VSN(S) Y10 1 0 FULL *REMIG D 0 TAPE01 Y11 1 0 FULL *REMIG D 0 TAPE01 Y12 1 0 FULL *REMIG D 0 TAPE01 NUMBER OF FILES= 0 GLOBAL SIZE= 0 START= 2016-05-21 13:04:33 END= 2016-05-21 13:04:35 *** E N D O F HSMS V12.0 FULL REPORT *** 2016-05-21 13:04:35 ***