Online documentation - Websydian v6.0

Users Guide | Patterns Reference | WebsydianExpress | Search

 

Installing Websydian Applications on iSeries Web Server


The Websydian application must be generated and built with the AS400 web server variant. This will result in generation of the Websydian application as iSeries server components in an iSeries application library.

This page describes how to install a finished Websydian application on an iSeries server running the iSeries Internet Connection Server as the web server.

Generate and Build Message File

Before the Websydian application is started the AS400 message file must be generated and build. Refer to the Plex documentation for details.

Configure Job Description

The Websydian application must be executed in a known job context specified in an iSeries job description.  In the WSYD600 library there is a predefined job description object labeled WSYDJOBD. Use this or create your own copy.

Use the CHGJOBD command to change the following:

An existing user can be used or a new, dedicated application specific user can be created.

Transfer HTML Document Templates to iSeries Server

The generated and edited HTML document templates must be transferred to the file system of the iSeries server (IFS). Use Windows explorer to copy the templates to a directory of your choice.

After transferring the HTML document templates, the file authorizations must be changed  to either *ALL or to the dedicated user.

Change Path to HTML Document Templates

In the WSYD600 library there is a data area object labeled WSYDPATH.  The value of the WSYDPATH data area contains the absolute path to the location of the HTML Document Templates.  Use this object directly or create your own copy in another library with higher precedence.

The value of  WSYDPATH data area must be changed with the CHGDTAARA command so it is set to point to the path of the IFS file system.

Data area display example:

Display data area example

The HTML document templates are set to reside in the WEBDTAQ folder in the QDLS file system.

Other external parameters of the Websydian application are also specified in iSeries data areas. Refer to the External Settings section of the Event Dispatcher Other Uses help page.

Create Websydian Data Queues

Two commands are available depending on whether local or remote data queues should be created.

If the data queues are placed in a folder different form the Websydian folder remember to copy the objects CGIDTAQ and CGISRVPGM from the Websydian folder to the folder of the data queues objects.

Web Server and Application on Same iSeries Server

The command WSYDCRTQ creates a number of normal data queues associated with the Dispatcher function of a Websydian application.

The command has the following parameters:

Create Local Websydian Queues (WSYDCRTQ)

Number of queues Number of input/out queues to create.
Library to place data queues Target application library where the queue objects are stored.
Copy objects to application library If 'Y' is chosen, the necessary Websydian iSeries program objects are copied to the target library.
Description for data queues Textual description of the dataqueue objects (optional).
Jobd for Websydian Application The job description of the Websydian application job.

Library

Library where job description is stored
Jobq for Websydian Application The job queue of the Websydian job.

Library

Library where job queue is stored.
Init librarylist Websydian Job Initial library list of the Websydian job.
Websydian Dispatcher program The name of the Websydian Dispatcher program.
Websydian Application job name The name of the Websydian job.

There will be created number input queues, number output queues and one vacant queue to administer references to free queues. A vector of number instances of the Websydian application will be initialized. If some old queues exist prior to execution of the command, the old queues will be removed.

Example:

WSYDCRTQ command example

A vector of 3 instances of the Sales Order application will be ready to process web user requests.

Web Server and Application Divided on Two iSeries Servers

If the web server and Websydian application are divided on two iSeries servers, they must be connected by a data queue configured as a *DDM remote data queue.  For this purpose, the command WSYDCRTRQ is available.

WSCRTRMTQ creates data queues on the Web Server site. It is also necessary to use the WSYDCRTQ command on the Application Server side to create the connection between the to Servers. The order of command initiation makes no difference.

The number of queues on the local and the remote command must be identical.

The command has the following parameters:

Create Remote Websydian Queues (WSYDCRTRQ)

number of queues Number of input/out queues to create.
Library to place data queues Local target application library where the queue objects are stored.
Copy objects to application library If 'Y' is chosen, the necessary Websydian iSeries program objects are copied to the target library
Remote location Name of remote iSeries server
Remote Library Name of remote target library with the remote queue objects.
APPC Device description

}

Parameters for the CRTDTAQ system command.
Local location
Mode
Remote network identifier
Description for data queues Textual description of the data queue objects (optional).

If some old queues exist prior to execution of the command, the old queues will be removed.

Example:

WSYDCRTRQ command example

3 remote dataqueues are created in the library library WEBDTAQ - The remote library have the same name.

Configure iSeries Web Server Software

The iSeries Internet Connection Server must be on version V4R2M0 or above The minimum PTF level should be 98174.

Configuration Commands

The iSeries web server is configured with the WRKHTTPCFG command.  This command will result in a screen with configuration lines.

Example:

Work with HTTP configuration example

Example iSeries web server configuration lines shown by a screenshot.

A user must make three new entries with QSECOFR privileges:

  1. A map command, which maps the Websydian dispatcher name of the HTML form action to the CGI mediator program located in a non-existing folder. In the above example, this is line with sequence number 00060.
  2. An exec command, which maps any references within the non-existing folder to the actual location of the application library. In the above example, this is line with sequence number 00070.
  3. A pass command, which gives access to other files, e.g. image files located in a subfolder. In the above example, this is the line with sequence number 00080.

Be careful about where you place the directives since the sequence of the directives may have an influence on if and how they are interpreted.

Example:

In an example Websydian application, the action attribute of the HTML forms references the Dispatcher program as  /ACMEApp/Orders.EXE.   This action attribute must be mapped to the CGI mediator program.  The CGI mediator program object CGIDTAQ.PGM is located in the Websydian product library WSYD600.LIB.

Images referenced from the HTML document templates are stored in a subfolder ACMEApp/images.

The following three lines are entered in the iSeries web server configuration:

  1. Map /ACMEApp/Orders.EXE /dummy.xyz/cgidtaq.pgm

  2. Exec /dummy.xyz/* /QSYS.LIB/WSYD600.LIB/*

  3. Pass /ACMEApp/*

For more information about configuration of the iSeries web server, consult the Redbook "Cool Title About the AS/400< and Internet" from IBM International Technical Support Organization, SGS24-4815-01.

After the configuration file has been changed, the web server must be restarted (ENDTCPSVR *HTTP, STRTCPSVR *HTTP).