SACMIGR Migration Phase

- SACMIGR --------

- MIGRATE [ USER DIRECT * ] ( [ DIRMGR VMSECURE ] ------- [ Directory_fid ] - [ ------ DIRMAINT ] --------------------------- [ NODELETE ------ ] --------------------------- [ FORMAT -------- ] --------------------------- [ NORULES ------- ]

Purpose

SACMIGR MIGRATE is the third and last phase in the SafeAccess migration process. SACMIGR MIGRATE performs the physical migration of the data as well as the many other tasks associated with migrating a minidisk to SFS. This process is described below.

After a minidisk is migrated SafeAccess simulates it's minidisk appearance even though the minidisk has been migrated to SFS. Users access and use the minidisk and it's data just as they did prior to migration.

SACMIGR MIGRATE uses the list of minidisks produced by SACMIGR SELECT to determine which minidisks to migrate. This list is in the SACMIGR SELECTED file produced by SACMIGR SELECT.

The Migration Process

1. The SACMIGR SELECTED file is read to obtain the list of minidisks to migrate. It then performs the following steps for each minidisk in the list.



2. The minidisk is linked and accessed.



3. The SFS directory that will contain the migrated data is created.



4. The minidisk data is copied to the SFS directory.



5. The VM:Secure rules for this minidisk are converted to matching SafeSFS rules for the new SFS directory. This step is NOT performed if the NORULES option is specified or if DIRMGR DIRMAINT is specified.



6. The SafeAccess database is updated to add the new simulated minidisk (SACDISK). SafeAccess begins simulating the minidisk.



7. The old minidisk is removed from the CP directory using the VMSECURE DELMDISK command. The old minidisk is also formatted if the FORMAT option is specified. Any directory links for this minidisk are removed from the directory. This step is not performed if DIRMGR DIRMAINT is specified.



8. The SACMIGR MASTER file is updated to reflect the new MIGRATED status of the minidisk.

1. VM:Secure system administrator authorization.



2. SafeAccess SAFADMIN authorization.



3. SafeSFS SAFADMIN authorization.



4. SafeSFS rule authorizing WRITE access to all objects in each target filepool.



5. VM:Secure rules allowing R/W LINK access to all minidisks or LNKNOPAS directory authorization if VM:Secure is not used.

Directory_fid

Specifies the filename, filetype, and filemode of the input file that contains the CP source directory. The USER DIRECT * file is used if omitted.

Options

DIRMGR VMSECURE -------------DIRMAINT	Specifies the system directory manager is VM:Secure or Dirmaint. The default is VMSECURE.
NODELETE	Specifies that the old minidisk should not be deleted after it's data has been migrated to SFS. If NODELETE is NOT specified, the VM:Secure DELMDISK command is used to delete the minidisk.
FORMAT	Specifies that the old minidisk should be formatted as well as deleted after it's data has been migrated to SFS. If FORMAT is not specified the minidisk will not be formatted. FORMAT may not be specified if NODELETE is specified.
NORULES	Specifies that SafeAccess should not convert the existing VM:Secure rules for the minidisk to SafeSFS rules when the minidisk is migrated.

Return Codes

Return Code	Meaning
0	Processing completed successfully.
>0	Processing failed - see error messages produced for more information.

Usage Notes

1. Minidisks that are being migrated should NOT be in use during the execution of SACMIGR MIGRATE.



2. After migration the MIGRATED status of each minidisk will be listed in the SACMIGR MASTER file. If the SACMIGR MASTER file is re-created by running SACMIGR COLLECT, the migrated minidisks will not be listed.



3. The old VM:Secure rules for each migrated minidisk are not removed during the migration process.



4. The SFS directory name for each minidisk will be Filepool:Ownerid.SACDISKS.SDvaddr. Filepool is the filepool specified on the FILEPOOL parameter when SACMIGR SELECT was run. Ownerid is the id of the user that owns the old minidisk. vaddr is the virtual address of the old minidisk.

1. SACMIGR MIGRATE



2. SACMIGR MIGRATE ( FORMAT



3. SACMIGR MIGRATE CPSOURCE DIRECT A ( FORMAT