PH46593: RSEAPI V1.0.9 INTERNAL DEFECT FIX

APAR status

• Closed as program error.

Error description

• RSEAPI v1.0.9 internal defect fix
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 1. RSEAPI users                              *
  *                 2. RSEAPI users                              *
  *                 3. All RSEAPI users.                         *
  *                 4. All RSEAPI users.                         *
  *                 5. All RSEAPI users running dataset          *
  *                 attribute query or other queries that do     *
  *                 not required to wait for the mvs subsystem   *
  *                 to be finalized.                             *
  *                 6. RSEAPI users                              *
  *                 7. System that wants to use AT-TLS secure    *
  *                 connection instead of RSE server secure      *
  *                 connection management.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. Similar to the work that was done    *
  *                      for MVS to provide an optional          *
  *                      attributes filter in a query header,    *
  *                      the unix files listing should do        *
  *                      something similar.                      *
  *                      2. Cancel a completed a job using       *
  *                      RSEAPI and error code 500 was being     *
  *                      returned (Internal server error).       *
  *                      3. To query member-specific attributes. *
  *                      4. Now that RSEAPI supports specifying  *
  *                       custom attributes in dataset queries   *
  *                       (i.e. to only return those attributes  *
  *                        specified) we should update RSEAPI    *
  *                        to also honour the order in which     *
  *                        those attributes are specified.       *
  *                      5. The dataset attribute query passing  *
  *                       the DSN mask with * may return nothing *
  *                        due to the unexpected mask expansion  *
  *                         to the matched files under /tmp      *
  *                         directory.                           *
  *                      The query may return an empty result    *
  *                      due to an NPE, causing by the client    *
  *                      version was not set yet when there is   *
  *                      a delay of mvs subsystem connection.    *
  *                      The query might ((unlikely) return a    *
  *                      record of "unavailable" attributes for  *
  *                       entry having attributes with value     *
  *                       containing comma (",").                *
  *                      6. Provide an optional attributes       *
  *                      filter in a query header to filter      *
  *                      the specific attributes in the          *
  *                      specified order in the job query and    *
  *                      displayActive API.                      *
  *                      7. ATTLS is preferred mechanism for     *
  *                      securing connections. IBM Developer     *
  *                      for z/OS, including Enterprise          *
  *                      Edition should implement ATTLS support. *
  ****************************************************************
  1. Update Unix file listing RSE API to support optional
  attributes filter in a query header to filter the attributes
  in the specified order.
  2. Update the RSEAPI job api to return proper response code
  and message when canceling a completed job
  3. Member has specific attributes different from PDS.
  4. JSON object toString method does not reserve the order of
  the entry as entered.
  5. Rexx argument with wild char (*) is expanded using matches
  of file on the working directory (/tmp) of the attribute query
  huh script, results in incorrect argument list to the script.
  To optimize the performance of some mvs query, subsystem mvs
  connection is not required, but it could cause NPE for queries
  referring to client version, which is set in the subsystem
  connection.
  Entry with "," attribute value, which is used as entry
  separator in query result parsing, interfere with parsing
  result. But it is unlikely that there is a difference compared
  with the proper result as the attributes for such entry are
  usually "unavailable" anyway.
  6. Update job query and displayActive all RSE API to support
  optional attributes filter in a query header to filter the
  attributes in the specified order.
  7. ATTLS port rule checking is thread-based. User threads
  (user security switching using pthread secure) fails ATTLS
  handshake where permission is set under RSE started task user
  ID.
  

Problem conclusion

• 1. Update Unix file listing RSE API to support optional
  attributes filter in a query header to filter the attributes
  in the specified order.
  2. When running RSEAPI job api to cancel a completed job, a
  response code 400 (BAD_REQUEST) will be returned with a proper
  error message.
  3. Member-specific attributes to display includes creationDate,
   modifiedDate, referenceDate, lineCount and lockOwnerID.
  4. - Ordering printing of dataset query (attributes) per
  attributes list filter
  - Ordering of supported attrlist printing as logical grouping
  defined in the link hash map definition of attribute names.
  5. Wrap the filename mask argument when passing to the Rexx
  script to avoid unexpected argument expansion.
  For RSEAPI, initialize the client version to the minimum
  version to avoid the NPE when referred. This minimum version
  is sufficient as it is used mainly to distinguish with a very
  old version of RSE host.
  Change the separator of the entries to ";" to avoid the
  collision with "," in attribute value.
  6. Provide an optional attributes filter in a query header to
  filter the specific attributes in the specified order in the
  job query and displayActive API
  7. Have the user security thread switching delayed after the
  ATTLS handshake.
  In this release, only userid/password authentication is
  supported. Client-cert authentication with AT-TLS is not
  supported yet.
  

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:

  UI80595

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 HUHMKDIR HUHMOUNT HUHPAX01
  HUHRACF  HUHSETUP HUHSHPAX HUHSTC
  

Fix information

• Fixed component name

  EXP FOR ZOS RSE

• Fixed component ID

  5655EXP33

Applicable component levels