CA Gen New & Updated Knowledge Base Articles for February 2021

[Lynn Williams]

Here is the February 2021 list of New & Updated CA Gen Knowledge Base Articles (February 1-28, 2021, US EST)
The full list of KB articles can be found from the CA Gen Product Information page here:
https://support.broadcom.com/mainframe-software/product-page.html?productName=CA Gen.
At the bottom of section "Knowledge Base Articles" click on the link for "See All Articles". See All Articles
NOTE: The default UI layout on the "See All Articles" page has improved due to the move to the SearchUnify search engine.
The list below only includes Title, URL and Summary but does not show the Metadata (date etc) - the latter can be controlled by using the Settings wheel (halfway down right-hand side) and its Customize/Pen icon (Search personalization features on the Broadcom Support Portal)

JCL to download CA Gen PTFs from support web site to z/OS

When using SAMPJCL, this JCL will get PTFs from support.ca.com to a PDS definedas FB=80 BLKSZ=3120.This will avoid downloading from the web to the PC and then upload to z/OS. Multiple PTFs can be downloadedwith one batch job run. Add a JOBCARD and only change what is highlighted. It is case sensitive so be sure to enter as shown. All Gen 8.xPTFs are in binary format. NOTE: Theexample provided is for Gen 8.5 PTFs. Underthe "apars" directory "r8.5" would need to be changed to "r8.6" for Gen 8.6 PTFs. Do NOT use this JCL totransfer files or dumps. There is another knowledge document with JCL for transferring files and dumps.

//* //*To FTP PACKED file (PTFs) directly to the mainframe: //* 1. Add JOBCARD //* 2. Replace * email address * with your valid email address. //* 3. Replace 'get' statement with a valid z/OS data set name. //*The dataset will be created if it does not already exist. //* //FTPSTEPEXEC PGM=FTP,REGION=0M,PARM=' (TIME 40' //SYSPRINT DDSYSOUT=* //OUTPUTDDSYSOUT=* //INPUTDD * ftp.ca.com anonymous [e-mail]èyour email address cd /apars/d19/pCGHE/r8.5/oOS dir bin locsite CYL primary=001 secondary=001 get RO69161.BIN'JOHLE05.FTPPTF(RO69161)'(rep ècreate a fixed block library (FB 80) for PTFs sent binary /* //** Delete thearrows and following comments above ** //** Repeat the 'get' statement for multiple PTFs **

CA Gen Call external fails to connect to Gen EJB Custom Web Service running under secure SSL/https WebSphere website ("Could not establish underlying trust relationship for the SSL/TLS secure channel.")

Gen 8.6 Call External statement fails to connect to a Gen EJB Custom Web Service running under a secure SSL/https WebSphere website with error: Error: WSDL Access Detail: The underlying connection was closed: Could not establish underlying trust relationship for the SSL/TLS secure channel.

A (CA Root) certificate had not been installed for the WebSphere https website (port 9443). After installing the certificate it was also added to the Trusted Root Certification Authorities store for the Toolset client-side access via Internet Explorer (IE11) browser using these steps: https://www.poweradmin.com/help/sslhints/ie.aspx The error was then resolved and the Custom Web Service Operation displayed successfully in the Call External WSDL Method dialog box.

CA Gen Web Generation HTML Text custom javascript stops working after moving to Web View

Existing CA Gen Web Generation (JVM, INTERNET) has a working HTML Text custom javascript. After generating the same application for Web View from CA Gen Studio, the javascript no longer works as expected.

1. Support tested provided model using browser with Developer option (F12) enabled. The Console tab shows Warning message: "[Deprecation] Synchronous XMLHttpRequest on the main thread is deprecated because of its detrimental effects to the end user's experience." However, that message turned out not to be significant. 2. The HTML Text for Web View must be XHTML-compliant: CA Gen 8.6 > Developing > Designing > Use Gen Studio > Work with Web View > Use Existing Models in Web View > HTML Control and HTML Text Using the XHTML validation  steps on the above link create an XHTML document (.html file) with body from the HTML Text field. Run that file through the W3C Markup Validation Service http://validator.w3.org to correct any errors. 3. After ....

CA Gen Custom EJB Web Service - Build Tool Assemble "Web Services" tab options for Host, Port and Endpoint URL ("Router" and "Custom Web Service")

When using the CA Gen Build Tool Assemble option for a CA Gen Custom EJB Web Service, the "Web Services" tab for Custom EJB Web Service has Host and Port properties plus Endpoint URL options "Router" and "Custom Web Service". Are there any guidelines on what values should be used?

1. The values used in the Host and Port fields need to be valid for the Application Server being used for the deployment. If no values are entered then the default values from the Gen Studio Web Services Definition properties are used i.e. Host=localhost and Port=8080. NOTE: For Port only an http (unsecure) port can be entered. When the Custom Web Service executes it calls the Default EJB Web Service to access the EJB and the Host & Port values are also used for that purpose. This is not a security issue because it is just the internal call from the Custom Web Service to the Default EJB Web Service. Also, an Application Server normally allows web service endpoint URL configuration to enable the use of a secure port for the external access t....

CA Gen model stuck in W status ("Waiting for verify") after running CSE Encyclopedia Client "Apply -> And Check-In" option

From Encyclopedia client, after running option "Apply -> And Check-In" on model "GEN SAMPLE MODEL 8 6 T1" receive error: CSEXI0064 A model with the specified name already exists on the encyclopedia If then try to use the Checkout Client the model is not listed in the model list. If try to run a download/checkout from the command line the model is reported to be in W status +++ C:\Program Files (x86)\CA\Gen86\CSE\bin>download -u encyadmn -m "GEN SAMPLE MODEL 8 6 T1" -i 1252 Start Time: 2021-02-11 16:21:35 Model GEN SAMPLE MODEL 8 6 T1 is in W status. Model must be in M (modifiable) or R (read only) status. End Time: 2021-02-11 16:21:35 +++ Encyclopedia Client Model Detail shows the model is in "Waiting for verify" status:

Using "Apply -> And Check-In" on the normal model would not have caused any corruption.  However, the current model status 'W' will need to be changed using update SQL as follows to resolve the download access problem. update dmdl set model_status='M' where model_name='GEN SAMPLE MODEL 8 6 T1'; NOTE: It is recommended having a recent CSE database backup before running any update SQL on the database.

CA Gen 8.6 GUI and COM Proxy Deployment

This technical paper is developed to assist in the manual deployment of CA Gen 8.6 GUI client applications (32-bit) on Windows. In addition, it also documents the deployment requirements for COM Proxy applications (32-bit and 64-bit).

Follow the instructions in the latest "CA Gen 8.6 GUI Client and COM Proxy Deployment.docx" attached below.

CA Gen EJB Web Service and Custom Web Service install & execution without "Package runtime in EAR" at Assemble time - WebSphere

When running the Assemble step for either just a default EJB Web Service or combined EJB Web Service and Custom Web Service, the option "Package runtime in EAR" which includes the Gen runtime .jar file in the resulting .ear file should normally be selected to avoid potential install/deployment and execution problems. However, if it is required to deploy a single (maybe customised) version of the Gen runtime .jar file for all applications and not include it in the .ear file, then a workaround is possible per details below.

Background: The Custom Web Service is dependent on the default EJB Web Service and will not function without it. That requirement is enforced during the Assemble step where the Custom Web Service can only be assembled if the default EJB Web Service is also selected with it. So the only 2 options are are to install the EJB Web Service on its own or install both the EJB Web Service with the Custom Web Service i.e. the Custom Web Service cannot be installed on its own. Package runtime in EAR If "Package runtime in EAR" is not selected then the Gen runtime .jar file (genrt.jar for Gen 8.6 or genrt.85.jar for Gen 8.5) will not be included in the resulting .ear file and this will cause problems when that file is installed on WAS because the runti....

Corresponding wru850n.dll in Gen 8.6

In the CA Gen 8.5 runtimes under VS100 or VS110 folder there is a wru850n.dll.  What is the significance of this DLL and what is the corresponding DLL in CA Gen 8.6?

The description for wru850n.dll is "Extensible Function Library DLL".  You can right-click the DLL, Properties, Details tab and see the description.   The Function library code in the wru850n.dll was merged into the Gen 8.6 wrgn.dll with the Gen 8.6 ease-of-upgrade project.

Error: HHC.EXE not found in the PATH during CA Gen 8.6 build using Visual Studio 2017 or 2019

Testing the generation of code using the Gen 8.6 Toolset in combination with Visual Studio 2017 (VS2017). In the Build Tool, an error that the hhc.exe file is not found is being generated: *** Error: HHC.EXE not found in the PATH. ***

The Microsoft Help Compiler was not installed with Visual Studio 2017 (VS2017).  The Help Compiler can be downloaded from the following Microsoft web link.  Once installed, the hhc.exe can be found in this folder, "C:\Program Files (x86)\HTML Help Workshop". https://docs.microsoft.com/en-us/previous-versions/windows/desktop/htmlhelp/microsoft-html-help-downloads

CA Gen .NET Proxy deployment to IIS example and how to overcome "HTTP Error 500.19 - Internal Server Error"

BACKGROUND NOTE: These tests were done on Windows Server 2016 Standard using IIS 10 and Gen 8.6 Complete (WKS86200) with Visual Studio 2017 Simple model attached to this KB as dotnet.ief.zip. Server PStep P1 just sets an exit state "return from server" and is packaged in Server Manager SM1. Gen Build Tool profile OPTIONS token OPT.BITS was set to the default value of 32. Therefore the server SM1 is generated as 32-bit for Windows/IEFAE and deployed using the 32-bit Transaction Enabler (aefad, aefuf) located in directory "C:\Program Files (x86)\CA\Gen86\Gen" The TE is started using a .cmd file as follows: SET AEPATH=C:\Users\Administrator\Documents\CA\Gen 8.6\Models\dotnetp.ief\c; SET PATH=C:\progra~2\CA\Gen86\Gen;%PATH% start /min aefuf -t ....

1. Under Server Manager/ Server Roles for "Web Server (IIS)" enable all options for "Application Development" and restart IIS:    2. A proxy page reload will then show the "operation" link on the left but similar "HTTP Error 500.19 - Internal Server Error" error still appears on the main part of the page: 3. Under IIS Manager "Default Web Site" Configuration Editor unlock the section "system.webServer/handlers" for "ApplicationHost.Config" and restart IIS: BEFORE: AFTER: 4. A proxy page reload then shows no more errors. 5. Click on operation P1 6.  Start the DTU Hit Execute to call the server from the Transaction Enabler Using the DTU the PStep can be seen to execute and return:

When will Gen know to create a Non-DLL NCAL? 

When will Gen know to create a Non-DLL NCAL?

Gen will know to create a non-DLL load by it's Dynamic Link Property setting as CMP. This is specified in two places. (1) From the Application System Construction Menu ---> 5. Specify target environment and construction libraries ---> opt 1. Specify Target Environment Dynamically link procedure steps . . . CMP (YES, NO, CMP) Dynamically link action blocks . . . . . .CMP (YES, NO, CMP) Dynamically link screen managers . . CMP (YES, NO, CMP) These are the Business System settings for the Dynamic Link property and the default. The default can be overwritten in item 2 below. (2) From the Application System Construction Menu ---> 1. Generate business system M=Specify member names Look to the far right of the panel for the Dynamic Link setting. I....

CA Gen action block generation fails with "DBMSNAME property missing for funcdef ..." for several functions.

Some functions like TIMETEXT or DATETIMESTAMP functions can be selected for use in an action block database statement but then cause the CSE or Toolset generation for MVS, DB2 z/OS, COBOL, CICS to fail.  For example the toolset generate.err file or CSE <action_block class="ng-scope">.err file will contain message: DBMSNAME property missing for function TIMETEXT</action_block>

The following update SQL was provided to reset the DBMSNAME property for all 36 functions which should have it: +++ update dname set name32_prop_3 = 'CONCAT' where name_obj_id in (select obj_id from dobj where obj_model_id in (select model_id from dmdl where model_name='MODEL_NAME') and obj_type_code = 24 and obj_name = 'CONCAT'); update dname set name32_prop_3 = 'CONCAT' where name_obj_id in (select obj_id from dobj where obj_model_id in (select model_id from dmdl where model_name='MODEL_NAME') and obj_type_code = 24 and obj_name = 'CONCATDBCS'); update dname set name32_prop_3 = 'CONCAT' where name_obj_id in (select obj_id from dobj where obj_model_id in (select model_id from dmdl where model_name='MODEL_NAME') and obj_type_code = 24 and o....

------------------------------
Lynn Williams
Senior Principal Support Engineer
Broadcom
Australia
------------------------------