Installation Instructions for Hot Fix I25001

z/OS


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:

	https://tshf.sas.com/techsup/download/hotfix/HF2/I25.html#I25001



IMPORTANT NOTES

     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.



DOWNLOAD INSTRUCTIONS

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

Option 1) Download hot fix I25001pt.zip 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 I25001pt.zip 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.

          binary
          put I25001pt.zip /uss_directory/I25001pt.zip
          quit

Option 2) From z/OS, FTP to ftp.sas.com using userid=anonymous and
          password=your.email&address

          Once you are logged on, "cd" to the following directory:
          /techsup/download/hotfix/HF2/I/I25/I25001/xx/mvs

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

          binary
          get I25001pt.zip /uss_directory/I25001pt.zip
          quit

Option 3) From z/OS, submit a batch job to FTP to ftp.sas.com using using
          userid=anonymous and password=your.email&address

          See sample JCL:

			 //FTPFIX     EXEC PGM=FTP
			 //SYSPRINT     DD SYSOUT=D
			 //FTPOUT     DD SYSOUT=D
			 //SYSIN     DD *
			 ftp.sas.com (exit
			 anonymous your.email&address
			 binary
			 cd /techsup/download/hotfix/HF2/I/I25/I25001/xx/mvs
			 get I25001pt.zip /uss_directory/I25001pt.zip (repl
			 quit
			 /*



INSTALLATION INSTRUCTIONS

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 I25001pt.zip, follow the instructions for applying hot fixes in the
SAS Deployment Wizard and SAS Deployment Manager 9.3: User's Guide.


POST-INSTALLATION INSTRUCTIONS

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
$ ./sasdm.sh

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.