Hot fix B25015 addresses the issue(s) in Base SAS 9.21_M3 on z/OS as documented
in the Issue(s) Addressed section of the hot fix download page:
http://ftp.sas.com/techsup/download/hotfix/HF2/B25.html#B25015
See the Maintenance Installation Tool (MIT) documentation for more details
on the installation of hot fixes.
IMPORTANT NOTES
1. You must have Base SAS 9.21_M3 installed on your system before
applying this hot fix. Refer to SN-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. This hot fix must be installed using the same userid which performed
the initial software installation.
4. 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.
5. Before proceeding with the execution of the hot fix binary, ensure that
there are no SAS 9.2 jobs running because this step requires exclusive
access to the SASHELP library.
6. 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.
7. The hotfix CLIST or PROC jcl will be customized with the concatenate hotfix
datasets.
INSTALLATION INSTRUCTIONS
The following instructions describe the steps for extracting the contents of
the downloaded hot fix file, moving the files to Unix System Services (USS) on
your z/OS system and installing the hot fix from USS.
STEP 1: FTP B25015os.bin TO A UNIX FILE SYSTEM DIRECTORY ON Z/OS
This can be done in one of two ways:
Method 1) Download hot fix B25015os.bin to your PC. When downloading a
SAS 9.2 hot fix, you must choose to "save" the hot fix.
**Note: Selecting "find a program online to open it" will
result in an error.
After downloading the file to the PC, FTP the B25015os.bin file
to your working directory in USS by issuing the following commands:
binary
put B25015os.bin /uss_directory/B25015os.bin
quit
Method 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/B/B25/B25015/xx/mvs
Issue the following commands to place the BIN file in your
working directory in USS:
binary
get B25015os.bin /uss_directory/B25015os.bin
quit
STEP 2: VERIFY EXECUTE PERMISSION ON THE INSTALLATION BINARY
1. "cd" to the working directory in USS where you copied B25015os.bin
2. Issue a ls -l to view the B25015os.bin permissions. If you do NOT see:
-rwxr-xr-x B25015os.bin
then you will need to change the permissions.
3. Use the chmod command to make B25015os.bin executable:
chmod 755 B25015os.bin
4. Issue a ls -l again to confirm that B25015os.bin has execute permission.
You should now see:
-rwxr-xr-x B25015os.bin
STEP 3: LOCATE SASHOME AND BACK UP THE DEPLOYMENT REGISTRY
During the hot fix installation you will need to provide the <SASHOME>
location to be updated. You should provide the path to the top level SAS
directory where the deploymntreg directory exists.
It is recommended that you back up the deploymntreg directory prior to
executing the hot fix binary. You can "cd" to your <SASHOME> and
issue a command:
cp -rf deploymntreg <backup_file_name>
STEP 4: EXECUTE THE HOT FIX BINARY
There are four methods for executing the hot fix binary. Select the method
appropriate for your environment to install this hot fix.
Note: Method B and Method D use -nojobsubmit. Below are some of the reasons for
using the -nojobsubmit command line option which will allow you to edit and submit
the batch jobs yourself:
Method A) Line mode, Installation jobs submitted automatically
Invoke the hot fix installation using the -silent option. The hot fix
jobs will be automatically submitted for execution.
./B25015os.bin -- -silent
Note: -- (represents two dashes)
Method B) Line mode, Installation jobs submitted manually
Invoke the hot fix installation using -silent mode and manually submit
the hot fix jobs.
./B25015os.bin --keep -- -silent -nojobsubmit
After you have manually submitted all the jobs you must re-launch the
hot fix binary with the -finalizeinstall parameter:
./B25015os.bin -- -finalizeinstall
NOTE (1): The installation job "Hotfix0" will automatically submit the
MKSASINS job. When this job is completed, you can submit the next job which
is "Hotfix1".
NOTE (2): Only one hot fix can be installed at a time. You must install the
hot fix, manually submit the install jobs and execute the -finalizeinstall
step for one hot fix before beginning the installation of another hot fix.
NOTE (3): This method creates a temporary directory XX_V1 in your working
directory in USS. Once you have verified the hotfix, you can remove
this directory to free up space.
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
Execute the hot fix package
./B25015os.bin
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
./B25015os.bin --keep -- -nojobsubmit
After you have manually submitted all the jobs you must re-launch the
hot fix binary with the -finalizeinstall parameter:
./B25015os.bin -- -finalizeinstall
NOTE (1): The installation job "Hotfix0" will automatically submit the
MKSASINS job. When this job is completed, you can submit the next job which
is "Hotfix1".
NOTE (2): Only one hot fix can be installed at a time. You must install the
hot fix, manually submit the install jobs and execute the -finalizeinstall
step for one hot fix before beginning the installation of another hot fix.
NOTE (3): This method creates a temporary directory XX_V1 in your working
directory in USS. Once you have verified the hotfix, you can remove
this directory to free up space.
A hot fix installation log will be created in the following location:
<!SASHOME>/InstallMisc/InstallLogs/Maintenance/MIT_date-and-time-stamp.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: PERFORM MANUAL STEPS REQUIRED TO ENABLE NEW FUNCTIONALITY DELIVERED IN THIS HOT FIX
Follow the instructions in
Problem Note 40451 Setup instructions to enable the use of authorized TSO commands for
SAS 9.2 Spawners in the z/OS environment
to implement the new functionality.
STEP 6: PROMOTING HOT FIXES TO PRODUCTION
There are several different types of files that a hot fix may update. The following files
are updated by this hot fix and should be promoted to production as appropriate for your
site using the instructions below.
<HLQ>.B25015.LIBRARY(TKELS)
<HLQ>.B25015.BAMISC(SPNCSHEL)
<HLQ>.B25015.SASRX(SASTREXX)
* '&prefix.B25015.LIBRARY'
you will need to replace the TKELS in your current
SAS 9.2 (9.2 TS2Mx) installation library with the
module loaded to '&prefix.B25015.LIBRARY'.
We suggest you rename the modules in the current SAS 9.2
(9.2 TS2Mx) installation library before replacing, or
make a backup copy of the original module.
* '&prefix.B25015.BAMISC'
you will need to replace member SPNCSHEL in your current
SAS 9.2 (9.2 TS2Mx) installation library with the
new copy in '&prefix.B25015.BAMISC.
We suggest you rename the member in the current SAS 9.2
(9.2 TS2Mx) installation library before replacing, or
make a backup copy of the original member.
* '&prefix.B25015.SASRX
you will need to replace member SASTREXX in your current
SAS 9.2 (9.2 TS2Mx) installation library with the
new copy in '&prefix.B25015.SASRX.
We suggest you rename the member in the current SAS 9.2
(9.2 TS2Mx) installation library before replacing, or
make a backup copy of the original member.
ADDITIONAL NOTES:
* If the hot fix installation created '&prefix.B25015.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 HLQ.LIBRARY
3) rerun BAOPTS1.
* If the hot fix installation created a '&prefix.B25015.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.2 Foundation Into The
LPA/ELPA" in the "Configuration Guide for SAS 9.2 Foundation
for z/OS".
This completes the installation of hot fix B25015 on z/OS.