PM69571: A Client application that generates a child process receives FAA RQ_NOT_STARTED, after the child process terminates

CICS Transaction Gateway for Multiplatforms V9.0 (all supported platforms)
CICS Transaction Gateway Desktop Edition V9.0 (all supported platforms)

APAR status

• Closed as program error.

Error description

• epi function failure with CICS_EPI_ERR_FAILEDif the child
  process is terminated using the exit function
  using the _exit function does not cause the routine to be driven
  

Local fix

• created a patch to prevent the IPC being stopped when
  exit() is called.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  UNIX and Linux users of the Client API
  ****************************************************************
  PROBLEM SUMMARY:
  If a Client application initializes the Client API and
  generates a child process using the 'fork()' function, after
  the child process terminates the Client application receives
  FAARQ_NOT_STARTED on subsequent API requests.
  If a Client application 'spawns a child process that terminates
  with the '_exit()' function (but not the 'exit()' function),
  the Client application continues to run as expected.
  ****************************************************************
  

Problem conclusion

• The Client API has been changed to prevent a generated child
  process from releasing resources that are required by the
  parent, when the child terminates.<br/>A child process forked
  from a parent application, that has already made a Client API
  request, cannot make subsequent Client API requests. <br/>A
  child process that makes Client API requests must be forked
  before the parent application has made any Client API requests.
  

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:

Fix information

• Fixed component name

  CICS TRNS GATE

• Fixed component ID

  5724I8102

Applicable component levels

• R810 PSY

     UP