Installing Websydian iSeries Runtime Objects

The Websydian support for iSeries is partly build into the Websydian groups model, and partly delivered as an iSeries library with program and data objects as well as a number of objects to be located in the IFS directory structure.

The library is named WSYD600 for the library delivered with the Websydian base product and the directory /Websydian/WSYD600 is used for the objects located in the IFS.

Transfer Websydian Library to iSeries Server

When Websydian is installed, WSYD600 and WSYD600PTF can optionally be saved to disk as a binary file. The default location of WSYD600 and WSYD600PTF is in [Install directory]\Deployment\iSeries\.

As a service an installation program has been provided to install the iSeries runtime objects. The program is called WSYD600.exe and is located in the directory [Install directory]\Deployment\iSeries\.

The library file WSYD600 and WSYD600PTF must be transferred to the iSeries server.

Refer to the section "Transferring the product libraries from CD to iSeries" in chapter 6 of the AllFusion Plex installation guide for an example of how to transfer a binary file library from PC to an iSeries server.

The steps 7 to 18 of this section outline the commands needed to produce a save file ( *SAVF ).

From this save file, the WSYD600 library can be restored and added to your library list. It is optional to restore the WSYD600PTF library as this library is empty with the initial shipment. It is included as a service so that all library lists can be configured to include both WSYD600 and WSYD600PTF thereby preparing the system for eventual PTFs to the Websydian iSeries runtime.

Refer to the next section "Restoring the product libraries from save files ( *SAVF )" of the CA Plex installation guide for an example of how to restore an library.

Restore files required for Websydian DWA

In order to run Websydian DWA applications and the Websydian Server a number of runtime objects are required to be located in the IFS.

Restore the directory /WEBSYDIAN/WSYD600 and all subdirectories found in the save file IFSOBJECTS located in the library WSYD600

Step 1: Create the directories /WEBSYDIAN/WSYD600

===> CRTDIR DIR('/websydian') [enter]

===> CRTDIR DIR('/websydian/WSYD600') [enter]

Step 2: Restore the contents of /WEBSYDIAN/WSYD600

 ===> RST DEV('/qsys.lib/WSYD600.lib/WSYD600ifs.file')OBJ(('/websydian/WSYD600/*' *INCLUDE '/websydian/WSYD600'))

Alternatively the directory can be copied from <Websydian Install Folder>\Deployment\iSeries\websydian\WSYD600 to the iSeries IFS.

Set up Character Conversion

This section only applies if non-English web applications should be created with Websydian.

Read Document Templates With Dedicated CCSID

Websydian now uses the data area IFSCCSID to indicate which CCSID should be used to read the document templates. Default is set to 01252 (Windows, Latin 1).

CHGDTAARA IFSCCSID

CCSID of Input from Browser

When a web server receives a request the request is encoded using the ISO-8859-1 code page. The iSeries web server will normally convert the data to EBCDIC so it can be read by the Websydian application. The only problem is that special characters are escaped on the form %xx, where xx is the ISO-8859-1 value of the character in hexadecimal notation. These values are normally also translated to EBCDIC, but if not the data area CGIICCSID should be used to set the CCSID of the character set used to encode the request (normally 00819 for ISO-8859-1).

Set the data area to 65535 if running iSeries CWA which indicates no conversion is needed.

Online documentation - Websydian v6.0