When elements need to be installed in a UNIX file system, the HFSINST job is generated to invoke the hierarchical file system copy utility for those elements:

• One job step is generated per target library within a UNIX file system.
• The name of each job step matches the ddname for the associated target library.
• Each job step installs multiple hierarchical file system elements from multiple distribution libraries into a single target library. This is done by invoking the SMP/E program GIMIAP, which calls the hierarchical file system copy utility to do the actual installation. For more information about the control statements passed to GIMIAP, see the GIMIAP section in SMP/E for z/OS Reference.
• The DD statement for the target library specifies the pathname, not a data set name.
• COPY and SELECT statements are arranged by distribution library ddname and by element name under each distribution library ddname.
• The first two bytes after EPARM( on the SELECT control statement may appear as blanks or odd characters. However, they are valid data and should not be changed or deleted.

If no PATH value was specified in the DDDEF entry for a target library DD statement in the HFSINST job, SMP/E issues an error message. Instead of generating the required JCL statement, SMP/E produces a comment with the following format:

//*xxxxxxxx *** ERROR *** INFORMATION MISSING FOR THIS DDNAME

where:

xxxxxxxx

is the name of the DDDEF entry that should contain a PATH subentry for the hierarchical file system element's target library.