Online documentation - Websydian v6.5 |
This upgrade guide is aimed at development sites that have already built CA Plex models based on Websydian 3.0 and want to move them to Websydian version 3.1. If the CA Plex model is based on a Websydian version prior to 3.0, the upgrade guides for these versions should be read and the guidelines in all the upgrade guides applied.
As a result of supporting Java in the TransacXML patterns a number of changes have been made to the functions in TransacXML.
Using the Windows variant of WSYDOM requires that there is a panel function in the call stack when a DOM function is called. Usually this is implemented by adding a panel to the top-level function.
Using the Java variant of WSYDOM a panel is NOT required when calling a DOM function.
The function EncodeUrl made use of a Windows API to encode URL's. This API did not work correctly in all cases, so the function now traverses the character string and encodes unsafe characters without using any Windows API's.
If you have not used the option WSYD URL Encode Marked Data in the PageGenerator function then you can ignore this.
When a character field is read from an ODBC data source, some data base engines will pad the field with spaces up to the length of the field. To compensate for this Plex (and Websydian) removes trailing spaces before displaying the field value.
If the database engine used does not pad character strings or if the trailing spaces should be sent to the HTML page, a new option (Trim trailing blanks) has been introduced that disables the removal of trailing spaces.
The default behavior is to trim trailing spaces.
The script variant now uses the HTTP client in the model WsyHttp rather than using the functions in WsyBase.
The functionality has not changed but the library WsyHttp.lib must be included in the generate and build settings.
The source codes scoped under SendHtmlPage has been changed so they are capable of sending binary output. The parameter interface is unchanged.
Websydian no longer uses translation tables to translate the HTML templates and incoming requests. Instead information about the code pages to use should be specified in a data area.
Please refer to Set up Character Conversion for further details.
As a result of the support for placing the documenttemplates in the IFS the dataarea WSYDPATH has been changed to support a longer path.
It is required to replace current WSYDPATH with the one supplied with Websydian 3.1, can be found in the library of the Websydian run-time objects.
The run-time files for the DWA variants have been renamed.
Old name | New name |
---|---|
wsydpka.dll | WsydDwa10.dll |
wsyd-relay.jar | WsydDwa10.jar |
The new files should be used instead of the old ones when deploying DWA applications generated and built with Websydian 3.1.
New parameters have been added to the Websydian Server. Please refer to Configure and Start Websydian Server for more details.
All parameters to the Servlet Websydian Web Server Component must now be specified in a file rather than being configured as servlet parameters. More information can be found here.
New packets have been added to the DWA protocol. Therefore it is necessary to re-gen and build the entire application when upgrading and also use the new run-time files.
The functions DecodeUrl and HostNameToIp used in the DWA - Windows variant requires that the libraries wininet.lib and ws2_32.lib are added to the Gen & Build section. Please refer to Setting up Your CA Plex Environment.
Since the acronym DWA is used instead of PKA for the Websydian TCP/IP architecture some Websydian objects have been renamed.
Object type | Old name | New name |
---|---|---|
Function | WpkaListener | ApplicationServiceListener |
Package | PkaObjectsToGenerateAndBuild | DwaObjectsToGenerateAndBuild |
Package | PkaWinObjectsToGenerateAndBuild | DwaWinObjectsToGenerateAndBuild |
Field | WpkaServiceName | ApplicationServiceName |
Field | WpkaInfoText | PacketInfoText |
Fields | All fields with prefix Wpka | Prefix Wpka removed |
The following commands on the iSeries platform have been renamed.
Old name | New name |
---|---|
PKASTRAPP | STRAS |
PKAENDAPP | ENDAS |
PKASTRTKS | STRTKS |
When upgrading to Websydian version 3.1, all Websydian Packages and application functions (Dispatchers, Page Generators, Event Handlers) should be regenerated and built. This is due to changed internal field lengths and parameter lists as well as changed run-time objects.