PI80098: SERIALIZING THE EMBEDDED MODE STARTUP

APAR status

• Closed as fixed if next.

Error description

• When using a BATCH configuration and then launched multiple
  batch jobs using the same HBRWORKPATH. The ra.xml may become
  corrupted.
  On startup of multiple servers, we sometimes see the following
  error
  In the logs we can see the following:
  SEVERE: GBRZP6010E An Exception occurred during the creation of
  the raw data service
  ilog.rules.res.session.IlrSessionCreationException : An error
  occurred while the rule session was created
  ilog.rules.res.session.IlrSessionException : An error occurred
  while the rule session was called
  ilog.rules.res.util.IlrRemoteException : The document is not
  XML valid
  ilog.rules.res.util.IlrRemoteException : Premature end of file
  And the jobs abend.
  

Local fix

• This occurs when 2 instances are sharing a work path on batch
  jobs in a zOS environment.
  The file locking mechanism is currently not sufficient to
  protect against another program reading the ra.xml at the same
  time one is writing it. In zRES we use an ENQ to protect
  against this, but this is missing for embedded batch.
  You have 2 workarounds possible:
      Use a separate workpath for your batch jobs
      Setting the HBRCONFIG=NO once a single batch job has been
  run. This prevents further modification of the ra.xml file. (If
  the config parameters were changed though, you would need
  another run with HBRCONFIG=YES to pick up the changes).
  Also please make sure that the ++HBRWORKPATH++ directory has
  enough space (if it is filled by log files you may encounter
  this type of issue as there would not be enough space for the
  creating of the ra.xml file).
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: ODM USERS OF ZRES EMBEDDED BATCHMODE         *
  ****************************************************************
  * PROBLEM DESCRIPTION: LAUNCHING MULTIPLE BATCH JOBS IN        *
  *                      PARALLEL WHICH SHARE THE SAME           *
  *                      HBRWORKPATH CAUSES A CORRUPTED RA.XML   *
  *                      FILE                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  APPLY THE FIX TO AVOID THE CORRUPTION
  

Problem conclusion

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

  WS ODM FOR Z/OS

• Fixed component ID

  5655Y1700

Applicable component levels

• R811 PSN

     UP