PH71752: ENVIRONMENT .ENV SCRIPT USES FULL PATHS WITH SYSTEM VARIABLES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After running the Open Enterprise SDK for Node.js setup.sh
  installation script, the generated .env environment script
  creates full path strings to required Node.js directories.
  These full paths may contain resolved z/OS system variables
  ('sysvars') in the full path strings, which may be unexpected
  and causes problems when system variables values change.  For
  example:
  
  > ls -l /usr
  lrwxrwxrwx   1 USER  GROUP  12 Aug  3  2018 /usr -> $VERSION/usr
  
  > sysvar VERSION
  TEST5
  > cat .env
  ...
  export PATH="/TEST5/usr/lpp/IBM/cnj/v22r0/IBM/node-v22.22.1-os3
  90-s390x-202603191702/bin:$PATH"
  export npm_config_nodedir="/TEST5/usr/lpp/IBM/cnj/v22r0/IBM/nod
  e-v22.22.1-os390-s390x-202603191702"
  export npm_config_zoslib_include_dir="/TEST5/usr/lpp/IBM/cnj/v2
  2r0/IBM/node-v22.22.1-os390-s390x-202603191702/include/node/zos
  lib"
  ...
  >
  
  If system variable VERSION changes, then the paths in .env will
  no longer be valid.
  

Local fix

• Manually edit the .env script to include the system variable, OR
  to include the original symlink using the system variable,
  thereby avoiding the system variable (e.x.  /usr/ instead of
  /TEST5/usr/).
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Open Enterprise SDK for *
  *                 Node.js 24.0                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: This PTF enhances the setup.sh scrpt to *
  *                      correctly support a system variable     *
  *                      symlink at the root of the Node.js      *
  *                      installation directory.                 *
  ****************************************************************
  * RECOMMENDATION: Apply provided service                       *
  ****************************************************************
  This PTF enhances setup.sh to correctly support a system
  variable symlink at the root of the Node.js installation
  directory. Users can now pass the --rmsysvar1 option when
  running setup.sh to use this feature.
  

Problem conclusion

• IBM is releasing a cumulative update to the IBM Open Enterprise
  SDK for Node.js 24.0
  

Temporary fix

Comments

APAR Information

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

  PH71186

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

Modules/Macros

• CNJPHPAX CNJSNPAX
  

Fix information

• Fixed component name

  SDK FOR NODE.JS

• Fixed component ID

  5655NDJ00

Applicable component levels

• RO00 PSY UO08220

     UP26/06/25 I 1000

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.