Error: GIM69168E HFSCOPY FAILED FOR J2Z4IAKI while installing CFF6F00

Products

• Common Components and Services for z/OS
• Common Services

Issue/Introduction

While running the APPLY job for Common Components and Services (CCS) 15.0 the following error is encountered:

CFF6F00  CFF6F00  GIM69168E     36   HFSCOPY PROCESSING FAILED FOR HFS J2Z4IAKI TO THE CFF6PLAT LIBRARY. THE RETURN
                                     CODE WAS 12. THE SEQUENCE NUMBER WAS 000051.

BPXF151I BPXCOPY WAS INVOKED FOR HEAD ID 000051.
BPXF150I MVS DATA SET WITH DDNAME SMP00056 SUCCESSFULLY COPIED INTO BINARY HFS FILE /your/path/prefix/J2Z4IAKI.
BPXF140E RETURN CODE 00000081, REASON CODE 0594003D.  A LINK FAILED FOR LINK NAME /your/path/prefix/../cff6/lib/j2zsdk.jar.

Environment

Release: 15.0

Cause

In this specific situation the problem definitely looks related to the DDDEF defined for CFF6PLAT.

The Reason Code 0594003D typically indicates that a directory in the path does not exist or a link failed because of a pathing error.

 

A review of the SMP/E FILE ALLOCATION REPORT (found in the apply output) showed the following information for DDDEF for CFF6PLAT

ZONE    DDNAME   DDDEFNAM SMPDDNAM TYPE     --------------DATA SET OR PATH-------------- VOLSER UNIT     STATUS
         
        CFF6PLAT CFF6PLAT          PATH     '/your/path/prefix/'
                                   PATHHFS  SYSHLQ.CA90S.R15.ZFS

This is not accurate since the PATH associated with the CFF6PLAT DDDEF should end with the directory name of /CA/

 

If the DDDEF looks good, other possible problems are:

• the directories were not created as required
• the filesystem is mounted to the incorrect mountpoint.

During the initial install, SAMPJCL members AW006MKD and AW015CSU are used to respectively create/mount the filesystems and define the required DDDEFs.

Resolution

1. Review SAMPJCL members AW006MKD and AW015CSU and either...
   
   
   • redefine the DDDEF as required
     
     SET BOUNDARY(target_zone).
UCLIN.
REP DDDEF(CFF6PLAT) PATH('/your/path/prefix/CA/').
ENDUCL.
     
     
   • create the required directories
   • unmount and re-mount the CCSZFS filesystem to the correct mountpoint (Note that the mountpoint does not include /CA/)
     
     
2. Once corrected, rerun the APPLY specifying REDO.