Included in the Websydian Express installation for iSeries is a 2E-model.
The model is on the oldest release level of 2E, that is supported by CA.
This level is 8.0.
The model contains the well-known Horse-application. We have used the Horse
entity to demonstrate how to develop a classical "Work with .." application using
Websydian Express function API’s.
The model also contains wrappers to all of the API’s that are available with Websydian
Express.
These functions are scoped under the file named "Websydian Express".
A number of 2E function templates are also contained in the delivered model.
In order to be able to pass many parameters between functions it has been
necessary to create three structure-files:
1. Websydian Express Errors
2. Websydian Express User
3. Websydian Express Session
To use Websydian Express API’s in your own models, you need to copy objects from the model you
have received to the model where you want to use the API’s.
In order to do so, you must use the command YCPYMDLOBJ.
Included in the model delivered to you is a model object list for copying.
This list is named EXPRESS.
Before copying you have to ensure that the model library WXPMDL and the MDL library for your own model is in the library list. The MDL library for your own model must be the first MDL library in the library list.
Perform these actions:
Use the YCHGLIBL command to work with the model you want to import the definitions into.
ADDLIBLE WXPMDL *LAST
From model library . .
. . . . . > WXPMDL Name, *CURLIB
To model library . . . . . . . . > (your model) Name, *CURLIB
Copy option . . . . . . . . . . *PREPASS *PREPASS, *COPY
Copy CPF names . . . . . . . . . *YES *YES, *NO
Copy text . . . . . . . . . . . *YES *YES, *NO, *FUN, *OPR
Copy conditions . . . . . . . . *ALL *ALL, *SELECTED
Copy subordinate functions . . . *DBF *DBF, *INT, *ALL, *NONE
Duplicate name action . . . . . *REJECT *REJECT, *GENERATE
Target version to replace . . . *CURRENT *FIRST, *CURRENT
Model object list for copy . . . EXPRESS Name, *MDLPRF, *SELECT, *
Target generation library . . . *MDLVAL Name, *MDLVAL, *NONE
Reserve app.object prefices . . *NEXT Name, *NEXT, *NONE
Severity filter . . . . . . . . *ANY 0-30, *ANY, *ERROR
Expand required objects . . . . *NO *YES, *NO
Locking method . . . . . . . . . *BYOBJECT *MODEL, *BYOBJECT
The model you have received is named WXPMDL. You should
start with a *PREPASS thats check that the copying will not result in any errors.
Set Expand required objects to *NO, in order not to get more objects copied than
necessary.
If the *PREPASS gives you an error-free list, you can do the real copy using
YCPYMDLOBJ with Copy option *COPY.
Now you are ready to use Websydian Express APIs in /2E.
The copying-process should result in one new entity
"Websydian Express"
Because this entity does not have any fields, in order to se
it you need to
select Rel lvl = DFN at the top of the database relations screen.
Five 2E functions templates have also been copied to your model - these are scoped under the *Template file:
W2E/EventHandler
W2E/GridPageGenerator
W2E/LoadGrid
W2E/PageGenerator
W2E/ProcessEntryPoint
Furthermore the copy has resulted in the Structure files:
Websydian Express Errors
Websydian Express User
Websydian Express Session
These files are only used for passing parameters.
The copying also resulted in a number of new fields added to your model. All
fields related to Websydian Express are in the model prefixed with W2E/.
All the generation-names for these fields are on the other hand
postfixed with
the letters W2. This is done to hopefully avoid name clashing with fields
already in your model.