Hot fix E80021 addresses the issue(s) in Base SAS 9.3 on z/OS 64-bit as documented in the Issue(s) Addressed section of the hot fix download page: http://ftp.sas.com/techsup/download/hotfix/HF2/E80.html#E80021 IMPORTANT NOTES 1. You must have Base SAS 9.3 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. INSTALLATION INSTRUCTIONS The following instructions describe the steps for downloading the hot fix, moving the hot fix to Unix System Services (USS) on your z/OS 64-bit system and installing the hot fix from USS. STEP 1: FTP E80021z6.zip TO A UNIX FILE SYSTEM DIRECTORY ON z/OS 64-bit This can be done in one of three ways: Option 1) Download hot fix E80021z6.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 E80021z6.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 E80021z6.zip /uss_directory/E80021z6.zip quit Option 2) From z/OS 64-bit, 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/E/E80/E80021/xx/z64 Issue the following commands to place the ZIP file in your working directory in USS: binary get E80021z6.zip /uss_directory/E80021z6.zip quit Option 3) From z/OS 64-bit, 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/E/E80/E80021/xx/z64 get E80021z6.zip /uss_directory/E80021z6.zip (repl quit /* STEP 2: VERIFY EXECUTE PERMISSION ON THE INSTALLATION BINARY 1. "cd" to the working directory in USS where you copied E80021z6.zip 2. Issue a ls -l to view the E80021z6.zip permissions. If you do NOT see: -rwxr-x--x E80021z6.zip then you will need to change the permissions. 3. Use the chmod command to make E80021z6.zip executable: chmod a+x E80021z6.zip 4. Issue a ls -l again to confirm that E80021z6.zip has execute permission. You should now see: -rwxr-x--x E80021z6.zip STEP 3: LOCATE SASHOME AND BACK UP THE SAS DEPLOYMENT REGISTRY It is recommended that you back up the deploymntreg directory prior to installing the hot fix. You can "cd" to your <SASHOME> and issue a command: cp -rf deploymntreg <backup_file_name> STEP 4: LAUNCH THE HOT FIX You can install hot fixes using a launcher script. This is especially useful for line mode installation. The default directory of the launcher script, sashf.rexx, is located in <SASHOME>/SASDeploymentManager/9.3. If you are installing a 64-bit hot fix, sashf.rexx must be followed with a command line option, -z64. Example: sashf.rexx -z64 Note: If your hot fixes are not in the default location, mentioned above, then you must indicate where the hot fix(es) you wish to install are located, using the -hotfixdir command line option described below. Command Line Options for the Launcher Script The following command line options may be used with the launcher script: -silent -headless By default, hot fix installation requires an X11 server. If an X11 server is not available, these options must be provided. Example sashf.rexx -silent -headless -hotfixdir By default, the launcher script will look for the hot fixes in <SASHOME>/InstallMisc/HotFixes/New. -hotfixdir allows you to specify a different directory as the default location for the hot fixes. -hotfixdir must be followed by a directory path to the hot fixes that you wish to apply. Example sashf.rexx -silent -hotfixdir /u/userid/hotfix Note: If you are installing multiple hot fixes on a z/OS 64-bit machine, all hot fixes will be installed to a set of staging hot fix libraries incorporating the name of the first alphanumeric value of the hot fixes. For example, if there are two hot fixes named A01 and B06, the staging name will be A01 with the contents of both A01 and B06 included in that image. -nojobsubmit The hot fix installer will not submit batch jobs to complete the application of your hot fixes. Below are some reasons for using the -nojobsubmit command line option which will allow you to edit and submit the batch jobs yourself: + Your site uses JES3 (not JES2) + Your FTP server is configured for JESINTERFACELEVEL=2 + The SAS installer ID is not authorized to use FTP + You need to make site-specific changes to the JCL or wish to review the JCL before submission + The FTP JES interface’s requirement that the jobname be the user ID performing the install suffixed with a single letter or digit is incompatible with your site’s jobname requirements If any of these conditions apply at your site, you must use the -nojobsubmit command line option. If you use the -nojobsubmit option, the list of hot fix jobs to execute will be written to member JOBINDEX in <high-level-qualifier>.< hotfix id>.INSTALL.CNTL. Submit the first job in the list and the entire set of HOTFIXn jobs will run automatically (each job submits the next job in the chain). The PROMOTE job is not run as part of this sequence. It should not be submitted until you are ready to move the staged datasets into production. Example sashf.rexx -nojobsubmit If your initial SAS 9.3 Basic installation was from cartridge you will have to launch the hot fix using Method B or D . See Usage Note 43707. -skipusercheck The hot fix installer performs a check to ensure that the user ID that performed the initial deployment is also the user ID applying the hot fixes. The -skipusercheck command line forces the hot fix installer to skip that check so that another user ID may be used. Note that the logged in user should have the same permissions as the user that performed the deployment, otherwise permission conflicts may arise. However, if permissions are set appropriately, a different user can update files installed under a different user ID. The user ID installing the hot fix must have the authority to create new data sets with the same high-level qualifier as the existing installation and modify the existing data sets. Also, if the -nojubsubmit command line option (described above) is not used, the hot fix installer automatically runs the install jobs under the original installer ID, based on data (jobcards, user ID, etc) stored in the install.properties file. Example sashf.exe -skipusercheck There are four methods for launching the hot fix script. Select the method appropriate for your environment to install this hot fix. Method A) Line mode, Installation jobs submitted automatically Invoke the Hot Fix Launcher script with the -silent -headless options. The hot fix installation jobs will be automatically submitted for execution. ./sashf.rexx -silent -headless Method B) Line mode, Installation jobs submitted manually Invoke the hot fix installation using -silent -headless mode and manually submit the hot fix jobs. ./sashf.rexx -silent -headless -nojobsubmit Method C) Graphical User Interface (GUI) mode, Installation jobs submitted automatically Invoke the hot fix installation. The hot fix jobs will be automatically submitted for execution. This method requires the use of an X11 server. An installation wizard will be initiated and will guide you through the hot fix installation process. Set your DISPLAY environment variable export DISPLAY=<your_node_name>:0 Using the Hot Fix Launcher script ./sashf.rexx Method D) Graphical User Interface (GUI) mode, Installation jobs submitted manually Invoke the hot fix installation and manually submit the hot fix jobs. This method requires the use of an X11 server. An installation wizard will be initiated and will guide you through the hot fix installation process. Set your DISPLAY environment variable export DISPLAY=<your_node_name>:0 Execute the hot fix package ./sashf.rexx -nojobsubmit A hot fix installation log will be created in the following location <!SASHOME>/InstallMisc/InstallLogs/IT_date-and-time-stamp.log for example /sas93/InstallMisc/InstallLogs/IT_2011-07-19-13.54.19.log Note: Each attempt to install a hot fix results in the creation of a new log file giving detailed information regarding the installation process. STEP 5: TESTING HOT FIXES If you want to test the hot fixes before promoting them to production, you can use the JCL, CLISTs, or REXX execs created in <high-level-qualifier>.<E80021>.PROCLIB, CLIST, or SASRX, respectively. These concatenate the staged data sets before the production data sets. STEP 6: PROMOTING HOT FIXES TO PRODUCTION Note: Before running this promote job see Problem Note 43710. A job named PROMOTE is written to the hot fix install library, for example, SAS.E80021.INSTALL.CNTL(PROMOTE). This job should be submitted when you are ready to move the staged datasets into production. The hot fix installation process for one set of hot fixes must be completed through the PROMOTE step before installing the next set of hot fixes. Note: After the hot fix(es) have been applied, they will be copied to: <SASHOME>/InstallMisc/HotFixes/Installed. You will need to manually delete any hot fixes from <SASHOME>/InstallMisc/HotFixes/New or the location where they were originally saved before apply new hot fix(es). ADDITIONAL NOTES: If the hot fix installation created '&prefix.E80021.LIBRARY' and it contains a SASHOST, SASXAL, or SASXA1 module, and if you set SAS System options by assembling the DEFAULT OPTIONS TABLE using the BAOPTS1 member of the original CNTL data set, then you must re-assemble this table after applying this hot fix. To re-assemble this table do the following: 1. Edit the BAOPTS1 member in the original CNTL data set. 2. Change the SYSLMOD DD in all three LINK EDIT steps to point to the new <high-level-qualifier>.LIBRARY 3. Rerun BAOPTS1 If the hot fix installation created a '&prefix.E80021.LIBRARY' and you run with an entry point of SASLPA then you will need to look in the unloaded library to see if any of the new modules are installed in your LPA. If so, then you will need to replace them with the new modules and refresh LPA. In the configuration guide, the modules recommended for installation in the LPA are: SASXAL SABXSPL SABXDML SABDS SABSCLL SABDBGM SABZPLH SABXGPH Please note that if you use the BNDLSUFX option, you will have to rename the modules appropriately in your LPA. For more information about the LPA bundled configuration and information about using the BNDLSUFX option, please refer to the section entitled "Installing SAS 9.3 Foundation into the LPA/ELPA" in the "Configuration Guide for SAS 9.3 Foundation for z/OS 64-bit". This completes the installation of hot fix E80021 on z/OS 64-bit.