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 ***