Migrating a BMCHFS from a UIM to CIS server

If there are files you wish to preserve from the BMCHFS data set in a UIM installation, there is a simple utility that you can use to copy them to the corresponding location under a CIS.

In CIS, the BMCHFS is a directory hosted directly in a z/OS UNIX directory rather than an emulated data set as it was under UIM. These files contain user preferences, pinned objects, and connection lists. It is easier to migrate them from a UIM instance than to re-establish them manually under the new server.

Ensuring that the directory is created

During the first start of the CIS server, the server will automatically create a BMCHFS directory under the path set in the CISHOME variable of the started task. You can create this directory manually, but the user ID associated to the CIS started task must have the read and write permissions to it. If you allow the server to create it, the permissions are created automatically.

Finding the BMCHFS directory and BMCHFS PDSE

When you start the server, locate a message (similar to the following example) in the STDOUT of the CISSRVR step. It shows the directory where you will find BMCHFS. 

You can find the BMCHFS PDSE under UIM in the message log, similar to the following message:

Running the UIMHMIG utility

Use the following job card to run the UIMHMIG utility. 

To run the utility, modify the job card as follows:

1. Set your CIS install path in CISHOME.
2. Add your CIS load library in STEPLIB.
3. Add the path of your BMCHFS directory of the CIS in the USSDIR DD.
4. Add the BMCHFS PDSE in the BMCHFS DD. 
   
   

After executing the job, you can verify the list of migrated files in the output.