Websydian v6.1 online documentationOnline documentation - Websydian v6.5

Setting up your CA Plex v6.1 model for Websydian DWA iSeries

Introduction

Prior to setting up your group model for the Websydian pattern libraries make sure that you have the Websydian patterns installed on your system. Go to the Websydian site to download the latest version of Websydian.

Add Websydian Libraries to the Group Model and Extract to your local model

Start by adding the relevant Websydian library models to the group model of your application. A list of available library models are shown in the table below.

Once the Websydian library models have been added to the group model and a local model has been defined, the objects in the Websydian library models must be extracted to the local model.

Library model Location Licensed
Web Developer
WSYBASE <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYBASE Yes
WSYVAL <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYVAL No
WYSINTEG <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYINTEG No
WYSSESS <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYSESS No
WSYUSER <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYUSER No
WSYUTIL <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYUTIL No
WSYAUDIT <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYAUDIT No
WSYPRES <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYPRES No
SDSTRING <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\SDSTRING No
WSYSTRUC <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYSTRUC No
WSYHTTP <Websydian Install Folder>\development\Plex6.1\patterns\WebDeveloper\WSYHTTP No
Wireless Developer
WSYWAP <Websydian Install Folder>\development\Plex6.1\patterns\Wireless\WSYWAP No
WAPUTIL <Websydian Install Folder>\development\Plex6.1\patterns\Wireless\WAPUTIL No

Model Configuration for iSeries DWA based Websydian applications

Open the "Model Configuration" dialog and set the Variant, Version and Level of the Websydian supplied libraries according to the following table:

Library model Variant Version Level
Web Developer
WSYBASE DWA - iSeries v6.1.4 v6.1.4
WSYVAL Base v6.1.4 v6.1.4
WYSINTEG Base v6.1.4 v6.1.4
WYSSESS Base v6.1.4 v6.1.4
WSYUSER Base v6.1.4 v6.1.4
WSYUTIL Base v6.1.4 v6.1.4
WSYAUDIT Base v6.1.4 v6.1.4
WSYPRES Base v6.1.4 v6.1.4
WSYHTTP Base v6.1.4 v6.1.4
WSYSTRUC Base v6.1.4 v6.1.4
SDSTRING iSeries v6.1.4 v6.1.4
Wireless Developer
WSYWAP Base v6.1.4 v6.1.4
WAPUTIL Base v6.1.4 v6.1.4

Configure Generate and Build Options

System Properties (32-bit C++ build)

Setup the pre-built C++ library files in the CA Plex local model. Follow these steps:

  1. Open the "System Definitions" dialog located under the "Generate and Build Options".
  2. Select the "System name" with "System type" Local System and press the "Properties" button
  3. In the "32-bit C++ Build" section activate "Use pre-built libraries" if not all ready activated.
  4. Add each of the library files listed in the following table to the "Libraries" field. Make sure to add the full path of each library file and delimiting each library file by a semicolon (;)
    Library file Location
    websyd.lib Located in the folder <Websydian Install Folder>\development\Plex6.1\lib
  5. Add the Websydian header folder "<Websydian Install Folder>\development\Plex6.1\include" to the field "Header Directories"
    Header files Location
    Websydian header files Located in the folder <Websydian Install Folder>\development\Plex6.1\include
C++ library files are referenced by file name whereas header files are referenced by the name of the folder where they are located.

Libraries by Example

An example of a libraries string. Shown with line breaks for convenience.

c:\Websydian\development\Plex6.1\lib\websyd.lib

Header Directories by Example

An example of a directory string. Copy and paste to CA Plex "System Properties" and replace location of Websydian.

c:\Websydian\development\Plex6.1\include

Settings for Websydian DocumentTemplateGenerators

Create Websydian.ini file to be located in the GEN\Release directory

Using notepad create a file named Websydian.ini in the GEN\Release directory of your local model and add the following lines. Changing the settings as required.

; Specify location of the generated html files
[WebSourceHTM]
sourcedir=..\html

; Specify location of the generated wml file
[WebSourceWML]
sourcedir=..\wml

; Specify information about URL to be used by your Websydian application
; Will be used in the document templates as action references
[Websydian]
URL_Dispatcher=/websydian/myapp

Now create the directories html and wml in the GEN directory of your local model.

Generate and Build Library Objects

Most Websydian library models include a number of  objects that are used by other pattern objects. These objects must be generated and built.

Generate and build the following objects

Library Subject area Further information
WSYBASE DWA_iSeries_ObjectsToGenAndBuild Always generate and build these functions
WSYSESS SessionObjectsToGenAndBuild Generate these functions if using the Session pattern.
WSYINTEG IntegObjectsToGenerateAndBuild Generate  these functions if using the Integrity pattern.
WSYUSER UserObjectsToGenerateAndBuild Generate these functions if using the User pattern.
WSYUTIL UtilObjectsToGenerateAndBuild Generate these functions if using the Utility patterns.
WSYAUDIT AuditObjectsToGenAndBuild Generate these functions if using the Audit pattern.

Generate and build the following objects only if using the Wireless patterns

Library Subject area Further information
WSYWAP WapObjectsToGenerateAndBuild Generate these functions if using the Websydian WAP patterns.
During generate and build errors will be generated by CA Plex e.g. "'StringFunctions.Server.Base64Decode' is an internal function and can not be generated individually" these can be disregarded.