After migration, a file only has a catalog entry at the processing level: it does not occupy any storage space at that location. The catalog entry indicates where the data in this file is located, i.e. to which background level – S1 or S2 – it has been migrated.
Depending on the background level to which the file has been migrated, PUB/S1 or PUB/S2 is output for SUPPORT. NONE is entered for EXTENTS.
The file size and last-page pointer values remain unchanged by migration. The storage level to which the file has been migrated is output under STOR-LEVEL.
The following command serves to obtain a list of all migrated files:
/SHOW-FILE-ATTRIBUTES FILE-NAME=*ALL, - / SELECT=*BY-ATTRIBUTES(STORAGE-LEVEL=(S1,S2))
Sample output for migrated files
/SHOW-FILE-ATTRIBUTES FILE-NAME=TEST.HSMS,INFORMATION=*ALL-ATTRIBUTES %0000000543#:10SN:$MANUALE.TEST.HSMS % ------------------------------- HISTORY ----------------------------- % CRE-DATE = 2016-09-20 ACC-DATE = 2016-09-29 CHANG-DATE = 2016-09-29 % CRE-TIME = 15:15:13 ACC-TIME = 10:34:05 CHANG-TIME = 10:34:05 % ACC-COUNT = 4 S-ALLO-NUM = 0 % ------------------------------- SECURITY ----------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2016-09-20 % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = 00:00:00 % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ----------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 2 % MIGRATE = ALLOWED STOR-LEVEL = S2 % ------------------------------- ORGANIZATION ----------------------------- % FILE-STRUC = ISAM BUF-LEN = STD(1) BLK-CONTR = PAMKEY % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = (V,N) REC-SIZE = 512 % KEY-LEN = 10 KEY-POS = 5 % AVAIL = *STD % WORK-FILE = *NO F-PREFORM = *K S0-MIGR = *ALLOWED % ------------------------------- ALLOCATION ----------------------------- % SUPPORT = PUB/S2 S-ALLOC = 543 HIGH-US-PA = 521 % EXTENTS VOLUME DEVICE-TYPE % NONE NONE NONE %:2OSG: PUB/S2: 1 FILE RES= 543 FRE= 0 REL= 22 PAGES /SHOW-FILE-ATTRIBUTES FILE-NAME=TEST. % 543#:1OSN:$MANUALE.TEST.HSMS % 3 :1OSN:$MANUALE.TEST.MSG % 3#:1OSN:$MANUALE.TEST.VOLX %:1OSG: PUBLIC: 1 FILE RES= 3 FREE= 2 REL= 0 PAGES %:1OSG: PUB/S2: 2 FILES RES= 546 FREE= 2 REL= 0 PAGES
Migrated files are identified by a number sign (#) between the file size value and the catalog ID.
As long as a file is migrated, the following applies to accessing this file and its catalog entry:
Changes to file attributes such as protection attributes, passwords, etc. are possible and remain in effect after the file is recalled.
However, the file cannot be renamed; attempts to do so will be rejected with an error message.
Changes to the file size (SPACE operand in MODIFY-FILE-ATTRIBUTES) are accepted. They do not take effect until the file is recalled.
The file can be deleted at any time. A migrated file whose catalog entry has been deleted is invalid for HSMS. After all, it cannot be recalled without a catalog entry.
Overwriting the file (OPEN OUTPUT, OUTIN or UPDATE) is permitted at the processing level. The file is then no longer considered as migrated and also becomes invalid for the migration archive.