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 number
PH46593
Reported component name
EXP FOR ZOS RSE
Reported component ID
5655EXP33
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2022-05-19
Closed date
2022-05-19
Last modified date
2022-06-01
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
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"100"}]
Document Information
Modified date:
06 July 2022