GIM69209S when attempting to Register Portable Software Instance in z/OSMF

Products

• Common Components and Services for z/OS

Issue/Introduction

You are in the process of receiving your first order into z/OSMF.   While running the first package receive job, you received the following GIM69209S error. 

GIM69209S ** RECEIVE PROCESSING HAS FAILED BECAUSE PROGRAM GIMJVCLT COULD NOT BE STARTED.
GIM20501I    RECEIVE PROCESSING IS COMPLETE. THE HIGHEST RETURN CODE WAS 12.

You found KB Article 208987 that said to add a SMPCPATH DD card, which you did but it still failed with the same error.  Below is what was reported:

 

--------------------------------------------------------------------------------
 DATE mm/dd/yy  TIME nn:nn:nn         SMP/E GIMJVCLT OUTPUT         SMP/E 37.32

 /bin/sh -c /usr/lpp/java/j8.0_371/bin/java -Dfile.encoding=IBM-1047 -cp /usr/lpp
 /smp/classes/GIMJAR.jar com.ibm.smp.GIMJVCLT

 /usr/lpp/java/j8.0_371/bin/java: FSUM7351 not found
1PAGE 0001  - NOW SET TO GLOBAL ZONE          DATE mm/dd/yy  TIME nn:nn:nn  SMP/E 37.32   SMPOUT   OUTPUT

    SET BOUNDARY(GLOBAL) .
 GIM20501I    SET PROCESSING IS COMPLETE. THE HIGHEST RETURN CODE WAS 00.

    RECEIVE FROMNETWORK(
          SERVER(SMPSRVR)
          CLIENT(SMPCLNT)
                       ).

 GIM69209S ** RECEIVE PROCESSING HAS FAILED BECAUSE PROGRAM GIMJVCLT COULD NOT BE STARTED.
 GIM20501I    RECEIVE PROCESSING IS COMPLETE. THE HIGHEST RETURN CODE WAS 12.

Cause

As witnessed in the job output, there was a reported "FSUM7351 not found" message related to the java file. Both the javahome and classpath variables are defined in the following <CLIENT> section of the job that is generated to perform the RECEIVE FROMNETWORK

<CLIENT
   downloadmethod="https"
   downloadkeyring="*AUTH*/*"
   javahome="/usr/lpp/java/j8.0_371"
   classpath="/usr/lpp/smp/classes"
   >
 </CLIENT>

Resolution

It is likely that the defined path for the javahome variable is not accurate.

Using the TSO ISHELL command or ISPF 3.17, verify that both the javahome and classpath paths are valid as defined.

You should find both the java and GIMJAR.jar files in the respective paths.

Note that the specification of classpath is equivalent to defining a //SMPCPATH DD statement in the JCL.