PH68109: Message "BAQH4005E: Unable to send request to the z/OS Connect server." can be misleading.

APAR status

• Closed as unreproducible in next release.

Error description

• The following error message is written to the API requester's
  job log when
  - the request timed out
  or
  - the connection with z/OS Connect is not active:
  
  BAQH4005E: Unable to send request to the z/OS Connect server.
  
  The content of the message returned to application does not
  specify that this can also be a timeout.
  
  Additional search words: msgBAQH4005E msgBAQH4005 BAQH4005E
  BAQH4005 msgBAQH4015E msgBAQH4015 BAQH4015 msgBAQH4016E
  msgBAQH4016 BAQH4016 msgBAQI0036E msgBAQI0036 BAQI0036
  msgBAQI0037E msgBAQI0037 BAQI0037
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS Connect V3.0 features      *
  *                 oasRequester-1.0 (for OpenAPI 3 API          *
  *                 requesters) and apiRequester-1.0 for         *
  *                 OpenAPI 2 API requesters).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message "BAQH4005E: Unable to send      *
  *                      request to the z/OS Connect server."    *
  *                      can be misleading.                      *
  ****************************************************************
  The BAQH4005E message does not provide enough information to
  determine the cause of the problem in the case of a timeout
  without having to turn on the Host API (BAQVERBOSE) tracing.
  

Problem conclusion

Temporary fix

Comments

• The z/OS Connect API requester Communication stubs and Host API
  have been updated to provide more detailed information on the
  possible causes of the failure to connect to the z/OS Connect
  server.
  The following error messages have been added to the z/OS Connect
  communications stub for IMS and z/OS applications:
  BAQI0036E: Communication timeout occurred when sending a request
             to the z/OS Connect server.
  BAQI0037E: Connection to the z/OS Connect server is not active.
  
  The following error messages have been added to z/OS Connect
  Host API:
  BAQH4015E: Communication timeout occurred when sending a request
             to the z/OS Connect server.
  BAQH4016E: Connection to the z/OS Connect server is not active.
  
  The fix for this APAR is expected to be delivered by the PTF for
  z/OS Connect V3.0.100.0 (PH69148).
  

APAR Information

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

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

Fix information

• Fixed component name

  Z/OS CONNECT EE

• Fixed component ID

  5655CE300

Applicable component levels