Previous Topic: Pending Installation ConsiderationsNext Topic: USS Paths in a Failed Installation


PDS Directory Block Increase Percentage

In CA CSM, information about how to allocate data sets to house a product (including directory block specifications) is part of metadata files. Metadata files are included in the product pax file. The number of directory blocks can be insufficient to accommodate the expected number of members at your site. Then, failures can occur as the PDSs are populated during the SMP/E APPLY or ACCEPT steps. This failure can cause the entire CA CSM task (product and maintenance installation) to fail.

CA CSM allows you to provide a generic multiplier for PDS directory block allocation specifications. This multiplier is applied consistently across all PDS data set allocations for all products that are installed with CA CSM. You specify this generic multiplier in the shell script for the Java JVM environment variable that is processed during MSMTC address space startup. STDENV DDNAME in the MSMTC STC procedure points to this script.

By default, this variable is not present in the STDENV startup script, and the increase percentage is 0 percent. This value means that product-supplied directory block specifications are used without modification.

If you rarely encounter STOW errors, we recommend that you leave the default value.

If you routinely must adjust directory block specifications or you frequently encounter STOW errors, you can specify an increase percentage. We recommend that you start with a relatively modest number (for example, 25 percent) and increase it, if necessary. Once you have a value set that works, do not change it going forward.

You can change the PDS directory block increase percentage.

Follow these steps:

  1. Shut down the MSMTC address space using the command:
    P MSMTC
    
  2. In the STDENV startup script, specify the variable for msm.pds.dirblk.percentage in the data set that the STDENV DDNAME points to in the MSMTC STC procedure. Alternatively you can increase the value of the variable:
    IJO="$IJO -Dmsm.pds.dirblk.percentage=25”
    
  3. Start the MSMTC address space using the command:
    S MSMTC
    
  4. Retry the task that failed.