INSTALLATION INSTRUCTIONS FOR HOT FIX 10LM02 ON OS/390 BEFORE DOWNLOADING: The hot fix 10LM02 addresses the issue(s) in Release 1.0 of SAS IT Service Level Management software on OS/390 as documented in the "Issue(s) Addressed" section of the hot fix download page: http://ftp.sas.com/techsup/download/hotfix/itslm10.html The following file(s) will be installed: * 10lm02os.xmit CNTL PDS in XMIT format. It contains all of the XMIT code necessary to apply the hotfix. * 10lm02wn_c.exe client component of the hot fix to be applied to your ITSLM Windows clients. IMPORTANT NOTE(S): 1. You must have SAS IT Service Level Management 1.0 installed on your system before applying this hot fix. 2. You must stop your SAS IT Service Level Management server before applying the hot fix. 3. See STEP 7 for instructions on installing the SAS IT Service Level Management 1.0 client hot fix on your client machines and STEP 8 for instructions on updating samples. 4. Before proceeding with STEP 5 of the INSTALLATION INSTRUCTIONS, insure no Version 8.2 SAS jobs are running because this step requires exclusive access to the SASHELP library. INSTALLATION INSTRUCTIONS: The following instructions describe the steps for extracting the contents of the downloaded file, moving the files to your OS/390 system and installing the hot fix. Please be sure to read the 'ADDITIONAL NOTES' section for situations where additional actions may be required. STEP 1: PRE-ALLOCATE THE XMIT FILE ON MVS Pre-allocate a file on MVS with the following DCB. Be sure to check the space requirement on the download page: Organization : PS Record format : FB Record length : 80 Block size : 3120 STEP 2: FTP THE XMIT FILE TO MVS FTP the XMIT file into this newly created file. This can be done in one of 2 ways: Method 1) Download the packaged hot fix to your PC. The packaged hot fix is a is a self extracting executable. Launching the executable will extract the OS/390 files to a default location example: C:\os390\10lm02os You will be prompted during the extraction process to accept or overwrite the default unzip location. The remaining steps in these installation instructions assume that you have unzipped the files to the default location After extracting the file, FTP the 10lm02os.xmit file to your MVS system doing a BINARY upload into the preallocated file created in step 1. Method 2) From MVS, FTP to ftp.sas.com using userid=anonymous and password=your.email@address Once you're logged on, cd into the following directory: /techsup/download/hotfix/ITSLM/10lm02/mvs Issue the following commands where 'sas.hotfix.xmit' is the filename you created in step 1. binary get 10lm02os.xmit 'sas.hotfix.xmit' (rep STEP 3: RECEIVE THE XMIT FILE TO CREATE THE CNTL PDS On MVS do a RECEIVE command on the uploaded XMIT file as follows where 'sas.hotfix.xmit' is the preallocated file in step 1. receive indataset('sas.hotfix.xmit') After doing this you will be prompted with something similar to the following: INMR901I Dataset DATA.SET.NAME from USERID on ???????? INMR906A Enter restore parameters or 'DELETE' or 'END' + at this prompt you sould enter: DA('sas.hotfix.cntl') ... where sas.hotfix.cntl will be a new PDS that contains all of the parts necessary to apply this hot fix. STEP 4: EXECUTE THE REXX EXEC In your new CNTL data set is a REXX exec that will, if applicable, create any new load libraries and, if applicable, generate any JCL required to modify SAS catalogs in your SAS system. Execute this REXX exec from ISPF prompt: ex 'sas.hotfix.cntl(rexx)' STEP 5: RUN ANY GENERATED JCL If the REXX exec generated any JCLxxxxx members in your CNTL dataset you will need to edit the JCL to make any site specific modifications and then run the JCL. Note that the output data sets in this JCL requires DISP=OLD, so you will have to run it at a time when this would be possible. STEP 6: MERGE GENERATED LIBRARIES WITH SAS If the REXX exec created: * '&prefix.HF10LM02.LIBRARY' then you will need to replace the like-named modules in your current Release 8.2 (TS2M0) installation library with the modules loaded to '&prefix.HF10LM02.LIBRARY'. We suggest you rename the modules in the current Release 8.2 (TS2M0) installation library before replacing. * '&prefix.HF10LM02.DBCS.LIBRARY' then you will need to replace the like-named modules in your current Release 8.2 (TS2M0) installation DBCS library with the modules loaded to '&prefix.HF10LM02.DBCS.LIBRARY'. We suggest you rename the modules in the current Release 8.2 (TS2M0) installation library before replacing. * '&prefix.HF10LM02.SASMSG' then you will need to replace the like-named members in your current Release 8.2 (TS2M0) installation SASMSG library with the members loaded to '&prefix.HF10LM02.SASMSG'. We suggest you rename the members in the current Release 8.2 (TS2M0) installation SASMSG library before replacing. * '&prefix.HF10LM02.AUTOLIB' then you will need to replace the like-named members in your current Release 8.2 (TS2M0) installation AUTOLIB library with the members loaded to '&prefix.HF10LM02.AUTOLIB'. We suggest you rename the members in the current Release 8.2 (TS2M0) installation AUTOLIB library before replacing. * '&prefix.HF10LM02.ITSV.CPMISC' then you will need to replace the like-named members in your current Release 8.2 (TS2M0) installation CPMISC library with the members loaded to '&prefix.HF10LM02.ITSV.CPMISC'. We suggest you rename the members in the current Release 8.2 (TS2M0) installation CPMISC library before replacing. STEP 7: INSTALL ITSLM WINDOWS CLIENT You must also apply a client component of the hot fix to your ITSLM Windows clients. The Windows SAS IT Service Level Management client hot fix archive is placed in the C:\os390\10lm02os directory created in STEP 2 (Method 1). This client component can also be accessed via STEP 2 (Method 2). The client hot fix is also a self-extracting executable, 10lm02wn_c.exe. Copy this file to all your ITSLM client systems using a file transfer program such as FTP. Extract the archive into the directory where you have installed the SAS IT Service Level Management client. Launching 10lm02wn_c.exe will initiate the install wizard, which will guide you through the setup process. If you installed to a path other than the default path of C:\Program Files\SAS\SAS\SAS IT Service Level Management\1.0 then specify the correct path in the Directory Location field before continuing the installation. STEP 8: Update documentation The Windows client executable includes the file 10lm02wn_doc.exe which is placed in the directory where you installed SAS IT Service Level Management client. Launching 10lm02wn_doc.exe will install all of the documentation associated with the 10LM02 hot fix. STEP 9: UPDATE SAMPLES The Windows client executable also includes a zip file of updated samples called samples.zip. When extracted it provides a complete set of samples, which inlcudes 2 contract databases, 1 environment, 3 report folders, 1 Enterprise Guide project, and two SAS programs for importing the contract databases and environment. These samples supercede the samples provided on your SAS IT Service Level Management 1.0 Client CD. If you wish to install these samples, then unzip samples.zip to a location of your choice. Then refer to your SAS IT Service Level Management 1.0 Installation documentation for more information on working with the samples. The extracted zip file uses 65Meg of disk storage space. ADDITIONAL NOTES: * If the REXX exec created a '&prefix.HF10LM02.LIBRARY' that contains a SASHELP, 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 REXX exec created a '&prefix.HF10LM02.LIBRARY' and you run with an entry point of SASXAL 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. In the installation guide, the modules recommended for installation in the LPA are SASXAL SASXAL2 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 The SAS System Into The LPA" in the "Installation Instructions and System Manager's Guide" appropriate to the Version and maintenance level for your SAS System. This completes the installation of hot fix 10LM02 on OS/390.