Exercise 2.4: Selecting display file members to convert

Before you begin, you must complete Exercise 2.3: Starting the WebFacing Web Project wizard.

On this second page of the WebFacing project wizard you need to specify the name of the iSeries server that contains your display file DDS source, as well as which members of the source file you want to convert. Specifically, the WebFacing Tool needs to know these names:

Note:
You need to identify members for all record formats used in your application. If you miss one and at runtime the record format gets requested, your end user will get a Page not found error.

First since you are starting with a new workspace, you need to specify the iSeries server name to specify where the Data Description Source (DDS) is located.

Connecting to an iSeries

To connect to an iSeries:

  1. Click New beside the Connection list.
    New Button

    The Name personal profile page opens.
    New personal profile

  2. Accept the default profile name as this is your own private connection.
  3. Click Next.

    The Remote iSeries System Connection page opens.
    New connection dialog, second page

  4. In the Host name field, type the name of the host system, for example s400a.
    Note:
    This is your iSeries server name; don't use the one shown unless your system is named s400a.

    The connection name will be filled automatically with the same value.

  5. Leave the Verify host name check box selected to verify that the host name or IP address exists.
  6. Click Finish.

    The connection is created and can be re-used by all tools in the workbench.

    The connection wizard also checks whether the iSeries host can be reached and if this test is successfully completed, you return to the Select Display File Source Members to Convert page.

  7. Check that your iSeries server is selected in the Connection list.
    Connection and Library settings
  8. Make sure that *LIBL is selected in the Library list.
  9. Click Refresh DDS list.
    Refresh DDS List

    A User ID and password dialog opens.
    Logon dialog to access iSeries server

  10. In the User ID field, type your user ID. Use the same user ID that you used when running the Order Entry application in Module 1. Reviewing the 5250 order entry application.
  11. In the Password field, type your password.
  12. Select the Save user ID check box.
  13. Select the Save password check box.
  14. Click OK.

    A connection to the iSeries server gets established. The library list of your iSeries job is displayed under the Refresh DDS list button on the Select Display File Source Members to Convert page.
    After Refresh DDS List

Selecting DDS source members

To select DDS members to convert:

  1. Select the WFLABXX library from the list.
  2. Click the plus sign (+) beside the WFLABXX library to expand it.
    WebFacing project wizard, showing expanded library WFLABXX
  3. Select the QDDSSRC source file from the expanded list.
  4. Expand QDDSSRC and select all members from the list.
  5. Click arrow button push button in the middle of the page to copy the selected members over to the list of members to be converted at the right.

    Tip: To move all members in a source file you can select the source file icon itself and click the arrow button push button. This will add all members in a source file to the list of members to be converted.

    The WebFacing Tool now knows which DDS members to convert for this project. The conversion hasn't been done but the information is stored for future use.

    Next you convert UIM source members.

Selecting UIM source members

To select UIM source members to convert:

  1. Click Next to proceed to the next page of the wizard.

    The Select UIM Source Members to Convert page opens.
    WebFacing project wizard, select UIM source members

    Now you have to identify the panel group source containing the help information for the Order Entry application.

  2. Click Refresh UIM list push button.
  3. Expand library WFLABXX.
  4. Select the QPNLSRC source file from the expanded list of library WFLABXX.
  5. Click arrow button push button in the middle of the page to copy all members over to the list of members to be converted at the right.

    There is actually only one panel group member ORDENTRPNL in this source file.

  6. Click Next to proceed to the next page of the wizard.

    The Specify CL Commands page opens.

You have connected to an iSeries server, selected DDS source members and UIM source members to convert and now you are ready to begin Exercise 2.5: Specifying the CL command to launch the application.