Installation Instructions for Hot Fix I25001


Hot fix I25001 addresses the issue(s) in SAS Web Report Studio Help and Documentation 4.31_M1 on z/OS as documented
in the Issue(s) Addressed section of the hot fix download page:


     1. You must have SAS Web Report Studio Help and Documentation 4.31_M1 installed on your system before
        applying this hot fix. Refer to Usage Note 35968 for instructions
        on how to determine which product releases you have installed.
     2. All currently active SAS sessions, daemons, spawners and servers must
        be terminated before applying this hot fix.
     3. The hot fix installer has a graphical user interface that requires
        the use of an X11 server. If an X11 server is not available at
        your site, the silent installation process described below may
        be used.
     4. SAS Hot Fixes are installed into new datasets after which they can be
        promoted to your production libraries. Several new datasets will be
        created in this process.


FTP to a UNIX file system directory on z/OS.  This can be
done in one of three ways:

Option 1) Download hot fix to your PC. When downloading a
          SAS 9.3 hot fix, you must choose to "save" the hot fix.  After
          downloading the file to the PC, FTP the file to
          your working directory in USS by issuing the following commands:

          NOTE: It is recommended to FTP the file(s) to the default USS
          directory  <SASHOME>/InstallMisc/HotFixes/New.  If this
          USS directory does not exist on your system, you should create
          it before beginning the FTP process.

          put /uss_directory/

Option 2) From z/OS, FTP to using userid=anonymous and

          Once you are logged on, "cd" to the following directory:

          Issue the following commands to place the ZIP file in your working
          directory in USS:

          get /uss_directory/

Option 3) From z/OS, submit a batch job to FTP to using using
          userid=anonymous and

          See sample JCL:

			 //SYSIN     DD * (exit
			 cd /techsup/download/hotfix/HF2/I/I25/I25001/xx/mvs
			 get /uss_directory/ (repl


The I25001 hot fix for SAS Web Report Studio Help and Documentation 4.31_M1 will be installed using the SAS Deployment
Manager (SDM). By default, the SDM will search in the <SASHOME>/InstallMisc/HotFixes/New
directory for hot fixes to be applied, but will also prompt for a location if you have
downloaded hot fixes to a different directory.

After downloading, follow the instructions for applying hot fixes in the
SAS Deployment Wizard and SAS Deployment Manager 9.3: Userís Guide.


This hot fix requires post-installation steps that will update the web application deployed to your application server.

Step 1: Re-build Web Applications

In order for this step to execute correctly, the Metadata Server must be running.

1.1 Set the DISPLAY environment variable, for example

$ export DISPLAY=<displayname>:0

1.2 Invoke the SAS Deployment Manager 9.3

From the SASDeploymentManager directory launch sasdm.exe, for example

$ cd <SASHOME>/SASDeploymentManager/9.3
$ ./

1.3 Select a language in the Choose Language box

1.4 Select Rebuild Web Applications

1.5 Select Configuration Directory or Enter the Configuration Directory and Level that needs to be updated

1.6 Specify Connection Information, including the sasadm User ID and Password

1.7 Select Help Viewer for Midtier App 9.3 as the Web Application to Rebuild

1.8 Verify the information on the Summary screen and select Start

1.9 Select Finish when the deployment is complete

This process will update the Help Viewer for Midtier App ear in <CONFIGDIR>/Lev1/Web/Staging and place the updated exploded ear in <CONFIGDIR>/Lev1/Web/Staging/exploded. The Help Viewer for Midtier App ear includes:

A backup of the original ear file will be placed in the Backup directory.

Step 2: Re-deploy Web Applications

2.1 Re-deploy the updated ear listed above to the web application server you are using based on the instructions appropriate for your web application server. See SAS 9.3 Intelligence Platform: Middle-Tier Administration Guide, Third Edition for more details.

This completes the installation of hot fix I25001 on z/OS.