PH55137: RSEAPI 1.1.2 INTERNAL DEFECT FIX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RSEAPI 1.1.2 internal defect fix
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01. All users                                *
  *                 02. All users who runs MVS download with     *
  *                 high concurrent level of the same dataset.   *
  *                 03. All users running commands involved      *
  *                 with TSO adapter.                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01. This enhancement is to make use     *
  *                      of Tomcat semaphore valve               *
  *                      functionality to provide a threshold    *
  *                      protection on number of concurrent      *
  *                      requests being handled.                 *
  *                      02. RSEAPI multiple downloads of the    *
  *                      same dataset by the same user at high   *
  *                      level of concurrency may fail.          *
  *                      03. Running a TSO command or a MVS      *
  *                      command that using TSO processor, for   *
  *                      ex: allocate a dataset, may show this   *
  *                      message in job or catalina.out log:     *
  ****************************************************************
  01. The implementation follows the description provided by
  Tomcat with semaphore valve.
  Reference: https://tomcat.apache.org/tomcat-9.0-doc/api/org/
  apache/catalina/valves/SemaphoreValve.html
  02. RSEAPI multiple downloads of the same dataset by the same
  user at high level of concurrency may fail.
  03. The MVS char conversion step in a TSO command adapter
  execution has the arguments list misplaced causing it is being
  skipped unexpectedly with the warning "not cd"
  (not command descriptor) message.
  

Problem conclusion

• 01. RSEAP redirect overflow filter has its own threshold
  mechanism detailing on number of users, threads count and
  memory usage. The introduction of Tomcat semaphore valve
  would help as a second layer on top to prevent the overloading
  of resource usage of the server. Default concurrency is set to
  150, which can be customized using RSEAPI_SEM_VALVE_CONCURRENCY
   parameter in rseapi.env configuration file.
  02. RSEAPI index of a dataset stream download is bawd on
  dataset name (dataset and member names), causing an overlap
  between multiple concurrent downloads of the same dataset.
  Adding the download timestamp and thread id in the index
  naming identifies uniquely the download streams per download
  session.
  03. Fix the argument list of the MVS char conversion step in
  TSO adapter command execution to have it work properly.
  

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:

  UI92232

Modules/Macros

• HUH1SMPE HUH2RCVE HUH3ALOC HUH4ZFS  HUH5MKD  HUH6DDEF HUH7APLY
  HUH8ACPT HUHCRYPT HUHFT000 HUHFT002 HUHFT003 HUHMKDIR HUHMOUNT
  HUHPAX01 HUHRACF  HUHSETUP HUHSHPAX HUHSTC
  

Fix information

• Fixed component name

  EXP FOR ZOS RSE

• Fixed component ID

  5655EXP33

Applicable component levels

• R110 PSY UI92232

     UP23/06/16 P F306

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.