Following migration, a file is marked as “migrated”, i.e. it has a catalog entry on the processing level but occupies no space there. The catalog entry shows to which storage level (S1 or S2) the data of the file in question has been migrated.
Depending on the background level to which the file has been migrated, PUB/S1 or PUB/S2 is output for SUPPORT. Migration does not affect the file size and last-page pointer entries.
An overview of the migrated files can be obtained by issuing the command:
/SHOW-FILE-ATTRIBUTES FILE-NAME=*ALL, - / SELECT=*BY-ATTR(STORAGE-LEVEL=(*S1,*S2))
Sample output for migrated files
/SHOW-FILE-ATTRIBUTES FILE-NAME=TEST.HSMS,INFORMATION=*ALL-ATTRIBUTES %00000543#:10SN:$MANUALE.TEST.HSMS % ------------------------------- HISTORY ----------------------------- % CRE-DATE = 2019-01-29 ACC-DATE = 2019-02-05 CHANG-DATE = 2019-01-29 % CRE-TIME = 15:04:05 ACC-TIME = 15:58:22 CHANG-TIME = 15:04:20 % ACC-COUNT = 2 S-ALLO-NUM = 61 % ------------------------------- SECURITY ----------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = ALL-USERS ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2019-01-29 % 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 = 1 % MIGRATE = ALLOWED STOR-LEVEL = S2 % #BACK-VERS = 0 % ------------------------------- 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 = 0 % AVAIL = *STD % WORK-FILE = *NO F-PREFORM = *K S0-MIGR = *ALLOWED % ------------------------------- ALLOCATION ----------------------------- % SUPPORT = PUB/S2 S-ALLOC = 16 HIGH-US-PA = 543 % EXTENTS VOLUME DEVICE-TYPE % NONE NONE NONE %:10SN: PUB/S2: 1 FILE RES= 543 FRE= 0 REL= 0 PAGES
Migrated files are identified by a number sign (#) between the file size and catalog ID entries. 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.
You can change the file size (SPACE operand in MODIFY-FILE-ATTRIBUTES). They do not take effect or become visible 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.