PH66782: NEW RUN-TIME MESSAGES (IGZ0404S AND IGZ0405S)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The original issue with this case was that it was opened prior
  to improved messaging around mixed mode calling.
  
  One of the customer's issues was that the program-id was in
  lower case, thus causing a failure to "query target function",
  which doesn't mean much to the average user. Also the ordering
  of query prior to load is counter to what actually happens in
  this scenario.
  
  IGZ0385S (and companion IGZ0386S) could thus be clarified
  further along the lines of:
         IGZ0385S A dynamic call from AMODE 31 {amode31-program}
  to AMODE 64 DLL {amode64-dll} failed
                  because the target was not found, or did not
  contain PROGRAM-ID {amode64-dll}.
                  [etc]
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Enterprise COBOL 6.3 and later      *
  *                 running programs that generate               *
  *                 IGZ0385Sand IGZ0386S runtime                 *
  *                 messages.                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The IGZ0385S and IGZ0386S runtime       *
  *                      messages did not communicate the        *
  *                      root cause of the failure that          *
  *                      occurred during dynamic calls           *
  *                      between AMODE 31 and AMODE 64           *
  *                      programs. This led to ambiguity         *
  *                      upon encountering these messages.       *
  ****************************************************************
  * RECOMMENDATION: Install the provided PTF.                    *
  ****************************************************************
  When a dynamic call was made between AMODE 31
  and AMODE 64 programs, the Language Environment
  Compiler-writer Interface (CWI) services CEL4RO64
  and CEL4RO31 were invoked to manage the
  dynamic call process.
  
  - CEL4RO64 was used when an AMODE 31 program
  dynamically called AMODE 64
  
  - CEL4RO31 was used when an AMODE 64 program
  dynamically called AMODE 31
  
  If either CWI services failed, the COBOL runtime
  prompted IGZ0385S or IGZ0386S messages. These
  messages lacked specific details about the
  root cause of the failure.
  
  You can read more about CEL4RO64 and CEL4RO31
  in z/OS Language Environment Vendor Interface doc:
  
  > z/OS Language Environment Vendor Interface
  
  >> Language Environment vendor interfaces for
         AMODE 31 and AMODE 64 interoperability
  
  >>> Compiler-writer interfaces (CWIs) supported
          for AMODE 31 and AMODE 64 interoperability
  
  >>>> CEL4RO31 - Prepare and run programs in the
             AMODE 31 environment
  
  >>>> CEL4RO64 - Prepare and run applications in
             the AMODE 64 environment
  
  COB0603T/K  COB0604T/K  COB0605T/K
  

Problem conclusion

• The COBOL Runtime has been updated to introduce two
  new runtime messages, IGZ0404S and IGZ0405S.
  In addition to indicating that the dynamic call has failed,
  these messages now also report the underling reason
  for the failure by including the return code from
  CEL4RO64 and CEL4RO31 respectively.
  
  The IGZ0404S message includes the return code from
  CEL4RO64 when a dynamic call from AMODE 31 to
  AMODE 64 fails.
  
  The IGZ0405S message includes the return code from
  CEL4RO31 when a dynamic call from an AMODE 64
  to AMODE 31 fails.
  
  The return codes indicate one of the following:
  4 - Failed to load the target DLL
  5 - Failed to locate the target function
  
  Please refer to the z/OS Language Environment
  Runtime messages document :
  
  > z/OS Language Environment Runtime messages
  >> COBOL Runtime Messages
  
  Refer to the technote below for additional details
  about the new IGZ0404S and IGZ0405S Runtime
  messages introduced by this APAR:
  https://ibm.biz/BdnW3T
  

Temporary fix

Comments

• ×**** PE25/09/19 FIX IN ERROR. SEE APAR PH68222  FOR DESCRIPTION
  ×**** PE25/09/19 FIX IN ERROR. SEE APAR PH68222  FOR DESCRIPTION
  ×**** PE25/09/19 FIX IN ERROR. SEE APAR PH68222  FOR DESCRIPTION
  ×**** PE25/09/19 FIX IN ERROR. SEE APAR PH68222  FOR DESCRIPTION
  

APAR Information

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

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

  UO04166 UO04167 UO04169 UO04170 UO04171 UO04172

Modules/Macros

• IGZBALCT IGZCEV4  IGZCJNI2 IGZCMGEN IGZCMGJA IGZCMGUE IGZEDCCT
  IGZIBMCT IGZIGZCT IGZLLIBV IGZXAPI  IGZXCA31 IGZXCDA  IGZXD24
  IGZXDMR  IGZXJNI2 IGZXLPIO IGZXLPKA IGZXLPKB IGZXLPKC IGZXLPKD
  IGZXLPKE IGZXLPKF IGZXLPKG IGZXPK2
  

Fix information

• Fixed component name

  LE ENT COBOL LI

• Fixed component ID

  568819812

Applicable component levels

• R7D0 PSY UO04166

     UP25/07/31 P F507

• R7DJ PSY UO04167

     UP25/07/31 P F507

• R7E0 PSY UO04169

     UP25/07/31 P F507

• R7EJ PSY UO04170

     UP25/07/31 P F507

• R7F0 PSY UO04171

     UP25/07/31 P F507

• R7FJ PSY UO04172

     UP25/07/31 P F507

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.