Configuring Workplace Services Express V2.6

This example is for users that are familiar with the Web serving environment and have an existing IBM^® Workplace™ Services Express V2.6 environment. It describes all the steps necessary to get iSeries™ Access for Web running in an existing Workplace Services Express V2.6 environment.

Install the latest service pack PTF. This is required for Workplace Services Express V2.6 support. For instructions, see the Installing PTFs for the Licensed Internal Code and the operating system topic for instructions. Configuring your portal environment consists of these steps:

Start the IBM Web Administration for i5/OS^® interface (also known as the IBM HTTP Server for iSeries). See step 1.
Start the Workplace Services Express environment. See step 1.
Configure iSeries Access for Web portlets. See step 3.
Use the iSeries Access for Web portlets. See step 4.

Steps to configure the portal environment:

Start the IBM Web Administration for i5/OS interface.
1. Start a 5250 session to the system.
2. Sign on with a user profile that has at least these special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
3. Run the following command to start the web administration interface job: STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
4. Minimize the 5250 session.
Start the Workplace Services Express environment.
1. Open a browser to: http://(system_name):2001.
2. Log in with a user profile that has, at least, these special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
3. Select IBM Web Administration for i5/OS then the Manage tabbed page.
4. Start the Workplace Services Express environment where iSeries Access for Web portlets will be installed. Wait for the environment to reach a running status before continuing to the next step.
Configure iSeries Access for Web portlets. Use these commands to configure iSeries Access for Web to Workplace Services Express:
```
STRQSH cd /QIBM/ProdData/Access/Web2/install cfgaccweb2 -appsvrtype *WSE -wasinst was_instance_name -wpusrid wp_user_ID 
           -wppwd wp_password -wpurl your_system_name:port/lwp/config 
           -wpdftpag *CREATE
```
The configuration command uses these variables:

was_instance_name

The name of the WebSphere Application Server instance where WebSphere Portal has been deployed and is currently running.

wp_user_ID

The WebSphere Portal user ID that has administrator-level authority to perform configuration changes to WebSphere Portal.

wp_password

The password for the user ID specified in the wpusrid parameter.

your_system_name:port/lwp/config

The Uniform Resource Locator (URL) to access the Workplace Services Express configuration servlet. Replace your_system_name with the name of your i5/OS. Replace port with the port number where the Web environment is running.

*CREATE

Tells the command to create the default iSeries Access for Web portal pages and add iSeries Access for Web portlets to those pages. Specify *NOCREATE if you do not want these portal pages to be created.
Use the iSeries Access for Web portlets.
1. Open a new browser window to the Workplace Services Express log in page. The URL might be similar to http://(system_name):(port)/lwp/workplace.
2. Select the Log in link in the upper right corner of the page to log in to Workplace Services Express.
3. The Web page prompts for a User ID and Password.
  - In the User ID field, enter a Workplace Services Express user ID that has administrative authority.
  - In the Password field, enter the password.
  Select Log in.
4. The Web page is updated displaying the Welcome page.
5. Select the new My iSeries tabbed page.
6. Configure the iSeries Access for Web portlets.
  Most of the iSeries Access for Web portlets must be configured before they can be used. The remaining steps use the iSeries Printer Output portlet as an example to describe how to configure most iSeries Access for Web portlets.
7. Select the Print link.
8. In the iSeries Printer Output portlet window, select the edit icon in the upper right corner of the portlet window.
  - In the Server section, leave the default value for Server or enter the name of your i5/OS system.
  - In the Authentication section, select Use credential specific to this portlet window. Enter i5/OS User and Password information for the system specified in the Server field.
  - In the General section, select Show server and Show user.
  At the bottom of the page, select OK.
9. The page is updated. The iSeries Printer Output portlet lists available spooled files. Each spooled file has several action icons available. Select the Send printer output name to... icon, then select Send to iSeries Printer Output - Viewer.
10. The iSeries Printer Output - Viewer portlet is updated with a link to a PDF version of the spooled file selected in the previous step.
  If you prefer to view the PDF within the portlet, select the Edit icon in the upper right corner of the iSeries Printer Output - Viewer portlet. Select View file within portlet.
  Select OK.
11. Select the 5250 link on the left side of the window.
12. The iSeries 5250 Session portlet Server field contains a default value. Enter a different i5/OS system name or leave the default setting.
  Select Start Session. The iSeries 5250 Session portlet is connected to your i5/OS.

The steps above are a simple example for setting up and using iSeries Access for Web portlets to access your i5/OS system. iSeries Access for Web portlets can be added to other pages and coexist with other portlets.

By following these steps, you completed these tasks:

Configured iSeries Access for Web portlets.
Began using iSeries Access for Web portlets.

Parent topic:

Examples for configuring an existing portal environment