Installing the Sample Application and iSeries Setup


To be able to complete the exercises, you need to install the sample application library that accompanies this book. The sample application comes in the form of a save file on a workstation CD. Before you put a new user interface on this sample application, you will get a look at the green screens featured in this application. From running through the screens you will get a good idea of how the application looks and behaves in its original version and what the differences are after it is converted with the WebFacing Tool.

Installing the Sample Library

For the installation, you will need access to an iSeries server running OS/400 V5R1 or higher. On your iSeries server, you need authority to create a save file in library QGPL, (or any other library you have access to), and you also need authority to create a new library.

In the examples throughout this book, I use an iSeries host with the host name of S400A, and I use a sample user ID and password WDSCLABxx. When going through the exercises on your host, replace S400A with your real iSeries host name , and use your own iSeries user ID and password when accessing the host at your location.

The CD that comes with this book is a workstation CD; the save file it contains has to be copied to the iSeries host and restored to a library.

Installing the Sample Library

This is an overview of the steps to install the sample library on your iSeries server. If you are familiar with these tasks you might want to skip the detailed instructions and just install the library WFLABXX with these three high-level steps:

  1. Create a save file on the iSeries server.

  2. FTP the save file  wflabxx.sav from the workstation CD to this save file on the iSeries server.

  3. Restore library WFLABXX from the save file.

Detailed Instructions for Installing the Sample Library

The following detailed instructions show you exactly how to complete the steps outlined in the previous section.

Start a 5250 emulator and use it to

  • Sign on to your iSeries server.

  • Create a save file named WFLABXX in library QGPL using the Create Save File (CRTSAVF) command:

     crtsavf qgpl/wflabxx 

    (Instead of using QGPL you can select a library of your choice.)

To transfer the file from the CD to your iSeries host,

  • Insert the CD into your workstation CD-ROM drive.

Establish a File Transfer Protocol (FTP) connection to your iSeries server:

  • In a DOS command window type

     ftp s400a 

    (Remember to use your own iSeries host name or IP address instead of S400A.)

  • Press the Enter key.

When prompted in the DOS window,

  • Enter your iSeries user ID and press the Enter key.

  • Enter your iSeries password and press the Enter key.

After the FTP session is established, in the DOS window,

  • Enter bin and press the Enter key (to make sure no character set-specific conversion occurs).

In the DOS window,

  • Type

     put x:/wflabxx.sav QGPL/WFLABXX 

    and press the Enter key. ( x represents the CD-ROM drive letter; use the letter that corresponds to your workstation's CD-ROM drive. Also, use the library that contains the save file you created in the previous step, if it is not QGPL.)

After the file is copied, you are notified in the DOS window.

  • Type qui t and press the Enter key.

You may close the DOS window now and remove the CD.

The last step is to restore the library from the save file. Use your 5250 session in your emulator to restore library WFLABXX.

  • Enter the following Restore Library (RSTLIB) command on the command line:

     rstlib savlib(wflabxx) dev(*savf) savf(qgpl/wflabxx) 

    (Again, if you did not put the save file in the QGPL library, then use the other library name instead of QGPL.)

Once the WFLABXX library is created, you are ready to set up the job environment on your iSeries server and begin the exercises.

Setting up the Job Environment

To successfully perform WebFacing conversion, you will need to specify the WFLABXX library in your job's library list. My suggestion is to make sure it is automatically added when your user ID logs on. You can do this by changing your user profile's job description. Just add the library to the list of libraries in the job description that your user profile uses. If you do not want to change your user environment, create a separate user profile for these exercises and make the WFLABXX library the current library for this special user profile.

Setting up the WebFacing Server on an iSeries Box

The WebFacing run-time support on the iSeries host is a very straightforward process since the WebFacing server is part of OS/400 V4R5 and higher. This means that you do not incur any additional run-time cost for the WebFacing server. You might think that you do not have to take any action since the WebFacing server is part of OS/400. However, you still need to install the WebFacing server and update the iSeries workstation manager by installing PTFs. The latest PTF numbers are available on the WebSphere Development Studio Web site. The page that will get you there is:

ibm.com/software/awdtools/iseries

This is the main page for iSeries tools. (We hope that the URL will not change even if product names change.)

On this page, select the link to the IBM WebFacing Tool. On the WebFacing page, there is a link to the system requirements page that contains the latest PTFs for each of the supported OS/400 releases. This list often changes, so I will not list the PTFs here.

The WebFacing server is a normal TCP/IP server like the FTP and http servers. Its name is *WEBFACING.

After you have installed the OS/400 PTFs for WebFacing, you need to start the server with the iSeries command strtcpsvr *Webfacing. The WebFacing server by default is started on port 4004 on your iSeries host.

You are now ready to move on to the workstation setup instructions.




Understanding the IBM WebFacing Tool. A Guided Tour
Understanding the IBM WebFacing Tool: A Guided Tour (IBM Illustrated Guide series)
ISBN: 1931182094
EAN: 2147483647
Year: 2003
Pages: 153

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net