Web Services Encoding Overrides and Other Enhancements Released

[Vaughn Marshall]

Hi all,

We just released some new PTFs (LU02924, LU02925) for the Endevor Web Services, adding encoding overrides, a status / health check page and other fixes.  Here are the details:

Enhancements:

Encoding override

Introduces 3 related changes:

1. Introduces a new header parameter Accept-Charset to both v1 and v2 endpoints for Retrieve element, Print element,Print element components and Package SCL. The header value is used as an override to the charset defined in cfg file.
2. During add/update and during upload of package SCL or Notes as a file, the Content-Type in the FormData multipart belonging to the uploaded content is used as the charset override for the upload. ¨
3. When returning a response that is not of the application/json type, the content-type header also contains the charset that was currently set in the STC (override or not) - this change is only applied to the v2 response, as it could be considered a breaking change for anyone parsing the header.

Documentation:
https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-endevor-software-change-manager/18-1/using/using-the-rest-api/restful-api-v1/element-actions-for-restful-api-v1.html

https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-endevor-software-change-manager/18-1/using/using-the-rest-api/restful-api-v2/element-actions-for-restful-api-v2.html

 

Health check

The static web page on /EndevorService has been enhanced to perform a health check of all defined .cfg files and their related STCs. It will now attempt to obtain each STC, and report the success or failure. 

 

Documentation:

https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-endevor-software-change-manager/18-1/release-notes/new-features.html#concept.dita_2a49c104-e5b5-4443-ba55-8d9c8e4b7857_MinorFeatures

 

Queue incoming requests by default

Wait for free STC when connectionTimeout = 0. When the connectionTimeout is 0, it used to not wait if an STC wasn't immediately available.

Documentation:

https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-endevor-software-change-manager/18-1/installing/web-services/install-and-set-up-web-services/configuration-files.html

 
Bug Fixes

• Register both API versions to API ML
• Unauthorized request returns with HTTP code 401, not 500
• STC pool size increase fails with incrsize>1 and ConnectionTimeout = 0 (or very small)
• Print with search returns only last matching element 
• Fingerprint value exctraction from APIMSGs not correct