IO29523: SMP/E RECEIVE ORDER GETS FSUM7351 NOT FOUND WHEN THE SMPJHOME ISCODED WITH $ CHARACTER PATH='/GLOBAL/SYS9/JAV$SMPE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• SMP/E RECEIVE ORDER gets FSUM7351 not found when the SMPJHOME is
  coded with $ character  PATH='/global/SYS9/JAV$SMPE
  

Local fix

• Rename the Java home directory to remove the $.
  Create a symlink that does not contain $ which points to the
  Java home directory, and specify the symlink on the SMPJHOME DD
  statement.
  Instead of using the SMPJHOME DD statement, specify the javahome
  attribute in the <CLIENT> XML with the backslash character to
  escape the $.  Like this:
  javahome=”/global/SYS9/JAV\$SMPE”
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users with a javahome directory          *
  *                 containing "$".                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: SMP/E gets message FSUM7351 not found   *
  ****************************************************************
  For some operations, like the RECEIVE ORDER command, SMP/E
  requires the use of Java.  The Java home directory may be
  specified for SMP/E in the <CLIENT> XML on the javahome
  attribute.  If the java home directory contains a "$" (dollar
  sign) character, SMP/E processing will end with an error because
  the directory is not found.
  
  For example:
  
    <CLIENT
      javahome="/global/jav$smp"
      >
    </CLIENT>
  
  Causes this error:
  
    /global/jav/bin/java: FSUM7351 not found
  
  This error occurs because SMP/E starts the UNIX shell to run its
  Java programs, and the UNIX shell performs shell variable
  substitution when it sees a "$" in the java home directory
  value, thus transforming the java home directory value into a
  directory that does not exist.
  

Problem conclusion

• SMP/E 3.7 is updated to automatically escape the "$" (dollar
  sign) and "'" (apostrophe) characters if found anywhere in a
  provided value for the javahome and classpath attributes in the
  <CLIENT> XML.  Preceding the "$" and "'" characters with the "\"
  (backslash) escape character instructs the UNIX shell to turn
  off the special meaning for these characters, thus disabling
  shell variable substitution on the javahome and classpath
  values.
  
  As a circumvention you can manually instruct the UNIX shell to
  turn off the special meaning of the "$" character by preceding
  it with the "\" (backslash) escape character.  Like this:
  
      javahome="/global/jav\$smp"
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UO07191

Modules/Macros

• GIMJVLVL GIMLEVEL GIMMPRCO
  

Fix information

• Fixed component name

  SMP/E

• Fixed component ID

  566894901

Applicable component levels

• RK00 PSY UO07191

     UP26/04/01 P F603

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.