How to convert all MSM related file systems from HFS to z/FS?

Document ID : KB000050626
Last Modified Date : 14/02/2018
Show Technical Document Details

To change the MSM file system from HFS to zFS follow these steps:

  1. Change in MSMSetupOptionsFile.properties the parm:
    USSFileSystemType=

  2. Change in msm.SAMPLIB member DBINIT the parm:
    mpmFilesystemType=

  3. Change the DBINIT DD in the MSMTC first startup to DBUPDATE DD

  4. Change your actual files to the proper filesystem type.
    There is a utility to do this:
    HFS TO ZFS CONVERSION TOOL (BPXWH2Z)

  5. Run the DBSQL inquiry query:
    //SYSIN DD *
    select * from mountpoint;
    /*
  6. Check what's in the field MP_OPTIONS.
    And modify the below 'old value' parm with it.
    The 'old value' could be 'system,HFS' or 'HFS'.
    Then change the 'new value' to 'system,ZFS' or 'ZFS'.
    //SYSIN DD *
    update mountpoint set MP_OPTIONS = 'old value'
    where MP_OPTIONS = 'new value';
    //*
  7. Run the DBSQL inquiry query again to see if the MP_OPTIONS is set correctly.
    //SYSIN DD *
    select * from mountpoint;
    /*

Note that these steps above do not include the file systems mounted to /../msm, /../msmruntime and /../msminstall. These file systems can simply be converted from HFS to zFS without any additional requirement for MSM. If after the conversion of HFS to zFS MSMTC fails at start with:

java.lang.NoClassDefFoundError: org.apache.catalina.startup.Bootstrap 
Caused by: java.lang.ClassNotFoundException: org.apache.catalina.startup.Bootstrap                                              

Refer to TEC559459. If Bootstrap.jar is available under /msmruntime/tomcat/bin then this may be security related.