PH54496: RSEAPI 1.0.13 INTERNAL DEFECT FIX

APAR status

• Closed as program error.

Error description

• RSEAPI 1.0.13 internal defect fix
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: 1. All users running commands involved       *
  *                 with TSO adapter.                            *
  *                 2. All users running MVS dataset content     *
  *                 streaming upload.                            *
  *                 3. All users running MVS dataset content     *
  *                 query with record-range option.              *
  *                 4. All MVS streaming (raw content)           *
  *                 download with large dataset content.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. 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      *
  *                      2. MVS stream upload could hang with    *
  *                      an empty source file. Upload to         *
  *                      non-accessible target dataset failed    *
  *                      as expected but with misleading error   *
  *                      message of lock owner cannot be         *
  *                      determined.                             *
  *                      Uploading long lines of data may        *
  *                      cause cut off. Uploading very-large     *
  *                      data stream to a dataset may fail.      *
  *                      3. When running dataset content query   *
  *                      with record range query option, it      *
  *                      always returns no record found.         *
  *                      4. Download of large dataset may        *
  *                      return incomplete data. Timeout and     *
  *                      memory consumption may happen for       *
  *                      very large dataset streaming download.  *
  *                      Lack of error message returned with     *
  *                      some typical download failure such as   *
  *                      non-access dataset or timeout.          *
  ****************************************************************
  1. 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.
  2. The MVS adapter fails to detect a 0 length data in
  detecting the end of the upload. The upload to a
  non-accessible dataset failure is expected but should be with
  an appropriate error message.
  Uploading long lines of data in text mode to a dataset may
  expect a cut off due to the record length limit.
  Uploading a very large data source file to a dataset may fail
  and disrupt the server due to the capacity configuration limit
  of the target dataset. Make sure the target dataset is
  configured properly for the  upload data.
  3. The existing record-range query relies on the scanner
  adapter to verify on a positive record counts validation.
  Recent change in scanner api has removed the counts, causing
  the record-range content query returns with no record.
  4. Data transition from host to client output buffering
  management could cause high memory usage and longer transfer
  time.
  Error in command status has not been retrieved to returned
  with the status of the download in some cases.
  

Problem conclusion

• 1. Fix the argument list of the MVS char conversion step in
  TSO adapter command execution to have it work properly.
  2. Cut-off in text mode uploading  is expected when the data
  line (treated as a record) is longer than the record length of
  the target dataset. Target dataset should be configured
  properly for the data it is uploading, including storage
  capacity.
  Empty file can be detected to end the upload correctly. Proper
  error message for uploading to a non-accessible dataset is
  provided to user accordingly.
  3. Remove the dependency on the scanner's record count report
  to validate on a non-empty query return instead.
  The dependency on scanner is also not efficient if it is just
  to obtain record count.
  4. Improve memory buffering and management during data
  transition.
  Return a short time after the data retrieval takes place to
  allow the data flowing to client output stream helps in memory
  management of internal buffer.  In addition, throttling data
  received from host also helps with memory consumption during
  data transition time.
  Message error code in typical cases is retrieved and returned
  when possible to the caller.
  

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:

  UI91784

Modules/Macros

• HUH1SMPE HUH2RCVE HUH3ALOC HUH4ZFS  HUH5MKD  HUH6DDEF HUH7APLY
  HUH8ACPT HUHCRYPT HUHFT000 HUHFT001 HUHFT002 HUHFT003 HUHFT004
  HUHFT005 HUHFT006 HUHFT007 HUHFT008 HUHFT009 HUHFT011 HUHFT012
  HUHFT013 HUHFT014 HUHFT015 HUHFT016 HUHFT017 HUHFT018 HUHFT020
  HUHFT021 HUHFT022 HUHMKDIR HUHMOUNT HUHPAX01 HUHRACF  HUHSETUP
  HUHSHPAX HUHSTC
  

Fix information

• Fixed component name

  EXP FOR ZOS RSE

• Fixed component ID

  5655EXP33

Applicable component levels

• R100 PSY UI91784

     UP23/05/23 P F305