Installing Viewpoint

Viewpoint version 11 requires IBM i (System i, iSeries, Client) Access for Windows version V6R1 service pack SI35607 (or higher), or V7R1 service pack SI53809 (or higher) for non-Windows 10 PCs.

For Windows 10, you must first download and install IBM Access Client Solutions (ACS) Windows Application Package, and create connection definitions for your IBM i server(s). See the section, Windows 10 and ACS Support below.

You must have Sequel installed and authorized for Viewpoint on your IBM i before you can use Viewpoint. The Viewpoint program on the PC does not need an authorization code.

  1. You must download the software from the Your Account page on our website to install a new version, or update your current version of Viewpoint.

    For trial installs: Be sure to select and download the Crystal Reports 2011 zip file (.zip).

2a. For First-time/Trial Installs:

a1. Sign on as an Administrator to the PC, extract the Crystal Reports 2011 zip file to a work folder, and run the setup.exe file located in the DATA_UNITS\CrystalReports folder. Only do this for users who will be designing Client Reports.

For non-Client Report designers, skip to a3 to install Viewpoint.

a2. Follow the on-screen instructions to complete the Crystal Reports installation.

Note: Crystal Reports must be installed before Viewpoint. Also, you will be prompted to enter a Product Keycode to complete the Crystal Reports installation. Contact your sales representative to obtain your keycode before you install.

a3. Locate the Viewpoint setup file (ViewPoint11_Setup.exe) downloaded from the HelpSystems Web Site.

a4. Sign on as an Administrator to the PC, and run (double-click) the Viewpoint setup file to start the Viewpoint Installation Wizard.

a5. When prompted to choose components, select the Custom Install option, and then check the Client Report Option feature.

a6. Follow the remaining on-screen instructions to complete the Viewpoint installation.

2b. For Upgrades:

b1. Locate the Viewpoint setup file (ViewPoint11_Setup.exe) downloaded from the HelpSystems Web Site.

b2. Sign on as an Administrator to the PC, and run (double-click) the Viewpoint setup file to start the Viewpoint Installation Wizard.

b3. Follow the on-screen instructions to complete the Viewpoint installation.

Note: If you select the Administrator component, you will be prompted to provide a password. Contact a support representative to obtain the password before you install.

 

Windows 10 and Access Client Solutions (ACS) Support

For Windows 10, Viewpoint requires IBM ACS Windows Application Package. IBM does not support the use of IBM i (System i, iSeries, Client) Access for Windows on Windows 10. The ACS Windows Application Package is a distinct product from the ACS product. Neither product requires the other, and ViewPoint only requires the Windows Application Package. However, ACS does provide most of the features that were formerly provided by the IBM i Access for Windows product including a graphical interface for defining host systems that can be copied to a format used by the Windows Application Package and ViewPoint. Many users will want both products to be installed.

Follow the steps below to download and install IBM ACS Windows Application Package, and create connection definitions for your IBM i server(s).

Note: You must be registered on the IBM Entitled Software site with authorization for software downloads to gain access to the downloads pages. Contact IBM if you are having trouble finding the IBM i Access Solutions Windows Application Package.

  1. In a browser, open the link: http://www-304.ibm.com/servers/eserver/ess/index.wss
  2. Click the Sign In Button.
  3. Enter log-in information and sign in.
  4. Click My Entitled Software in the upper left corner of page.
  5. Click Software Downloads.
  6. Select Operating System (ie. IBM i).
  7. Select Operating Release (ie. V7R1, V7R2, V7R3...).
  8. Click on Continue.
  9. Select Product Number for IBM I: 5770-SS1 (IBM i).
  10. Click on Continue at bottom of page.
  11. Verify / select Language.
  12. Click on Continue.
  13. Click the hide/show option for 5770-SS1 (IBM i) to list releases.
  14. Click the hide/show option to list products.

    Pick hide/show on either:

    5817: i7.1 B_GROUP1 v07.01.00,ENU,DVD

    5827: i7.2 B_GROUP1 v07.02.00,ENU,DVD
    5837: i7.3 B_GROUP1 v07.03.00, ENU,DVD

  15. Select IBM i Access Client Solutions - Win AP.
  16. Click on Continue at bottom of page.
  17. Click I Agree to download.
  18. Click Download Now.
  19. To install, follow the readme.txt instructions in the Documentation folder.

    Simplified instruction: Run setup.exe from 'Image32 for 32 bit systems', or 'Image64a for 64 bit systems'.

  20. Once Installed, the next step is to define your IBM i system(s): (or use Alternate Step 20 below)

    a. Start a DOS Command Window.

    b. To create a definition, run a command similar to:

    cwbcfg /r /host <<IBMiName>> /ipaddr <<198.xxx.xx.xxx>> /uid <<MyUserProfile>>

    where:

    <<IBMiName>> is the name of your IBM i host machine.

    <<198.xxx.xx.xxx>> is the IP address of your IBM i host machine.

    <<MyUserProfile>> is your IBM i user name.

Note: You cannot install a Viewpoint Server on Windows 10 as IBM ACS Windows Application Package does not provide all the required functions.

 

Alternate Step 20

This alternate step uses the more graphical IBM Access Client Solutions to define IBM i host connections for use by Viewpoint.

Steps 1-19 above MUST still be performed-IBM ACS Windows Application Package is required for Viewpoint, but IBM Access Client Solutions is not.

  1. Download IBM Access Client Solutions from IBM at:

    http://www-03.ibm.com/systems/power/software/i/access/solutions.html

  2. Once installed, start ACS, and in the Management panel, click on System Configurations, or select
    Actions\Management\System Configurations
    from the menu.

  3. Click New to add a new system. This part works much like Client Access.

     

  4. Once your systems are defined, close the System Configurations dialog, and select File\Copy Connections from the menu.

     

  5. In the Copy Connections dialog, you can copy host information from ACS to the Windows Application Package and vice versa. You can also use this panel to remove unwanted connections from either.

     

  6. Close this dialog when finished.

 

Viewpoint Dependency with Showcase

Viewpoint and Showcase require compatible versions to work together properly. Occasionally, a new version of Viewpoint requires that you upgrade your Showcase software to maintain compatibility.

 

Enabling the Design View Capability in Viewpoint

You can enable or disable the design capability for each user by entering the SETDFT command on a IBM i command line. See the Showcase Programmers Guide for a complete description of the SETDFT command.

When you use the SETDFT command, the Viewpoint design control is located at the top of the third page of default settings. Set it to Y for each user who is allowed to design views in Viewpoint.

  

After You Are Done

The installation process installed the following objects:

  • The SCSERVER10 product library (you might have specified an alternate library name)

  • The SEQUELWI product library (you might have specified an alternate library name)

  • The BI_COMMON library

  • The SEQUEL_TMP library used for Viewpoint and SWI processes. Requires authority of *CHANGE.

  • The ESEND email support library (you might have specified an alternate library name)

  • The SEQUELEX library containing sample files, views, and reports

  • The Skybot SKYAGENT library (if installed with the Deployment Bundle)

  • The ASCSUPPORT customer support library (where applicable)

  • The SEQUELREPO versioning library

  • SEQUEL, SEQUELWI, and ESEND commands in QUSRSYS.

  • An Apache server with the same name as the SWI product library (SEQUELWI by default) is created, and configured to use port 400, or the next port in succession if unavailable. If a server exists with the same name as the specified product library it will not be overwritten.

  • The initial library list of the job description QZHBHTTP in library QHTTPSVR is modified to include the libraries QGPL, QTEMP, SEQUELWI, SEQUEL and ESEND.

  • IFS files: Operations Navigator ESEND plug-in:

    QIBM\UserData\OpNavPlugin\ASC.ESEND

  • Additional files are installed in the folders \sequel, \esend, \helpsystems, \skyagent and \rio.

  • /SEQUEL/swi IFS directories for the image and icon files used in the standard Web pages created by the SEQUEL Web Interface.

  • The Viewpoint Repository (/SEQUEL/swi/repository/*) in the IFS.

  • Three libraries were restored to your system for use during the installation or update process: HSLOADMGR, HSLOADMGRW, and RBTCDRLIB. We don't remove them from your system in case you're doing multiple installations. You can delete them when you're finished.

    Note: You can move the library HSLOADMGR to a different system on the IBM i and use it to complete additional installs or updates. For more information, see Using the HelpSystems Product Loader on our website.

 


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: September 19, 2018