# LANSA for iSeries Hot Fix - HF131105

Date: 2014-02-07

Product | LANSA for iSeries
Version | 13SP1
Pre-Requisite Details | IBM supported IBM i operating systems
Related Products | LANSA for iSeries
Full Distribution In | Next EPC or Next release
User Action | Download the zipped file HF131105.ZIP and choose a method that is described below to load as an IBM i Save file to IBM i

### Disclaimer and Important reminder

### LANSA's policy in regard to providing hotfixes (also referred to as 'patches') is that an expedited fix for the testcase/problem reported to LANSA Technical support can be provided on request. Requesting and applying a hotfix imples implicit understanding of and agreement with the following points:
- LANSA only performs quick sanity testing of the hotfix using the testcase or problem report provided.
- Prior to deploying a hotfix, you are advised to fully test the hotfix in the environments that you expect at production time.
- If you encounter any issues with the hotfix, you should backout the hotfix and contact LANSA Technical support
- If you cannot perform an adequate level of testing, LANSA recommends not deploying the hotfix but instead, waiting for the fully tested delivery of the fix (Refer to 'Full Distribution In' above)
- The upside of this policy is speed of getting a fix; the downside is limited testing.

### Description

This FIX delivers fixes for LANSA products.

### IBM i Components:

Object name | Object type | Library
--- | --- | ---
X_DBM | *SRVPGM | LANSA program library

### HF131105.ZIP file contains:

- IBM i Save file - HF131105.savf
- This document - HF131105.htm

### Pre-Requisite details for IBM i

- These instructions have been abbreviated for experienced LANSA and IBM i users. If you need assistance with installing the FIX contact LANSA support in your region.
- It is a good practice to back up all the objects that are listed.
- You need exclusive use of the LANSA system before applying the FIX.
- End the Listener, Host Monitor and Web server for the LANSA system and run the LANSA for Web cleanup program.
- Use user profile QSECOFR or a profile that is part of QSECOFR group, or a profile that has *ALLOBJ and *SECADM special authorities.
- The system value QFRCCVNRST must be '0' or '1'.
- The IBM i System must have the latest IBM i PTF applied.
- If your IBM i is V5R4M0, then the following PTFs must be applied before restore the Save file
  - MF40520, delayed PTF to be applied at IPL.
  - S127294. apply immediate or delayed

### Download zipped file

1. Download the zipped file to your PC.
2. Unzip the file into a directory on your PC using your preferred unzip tool
For example:
UNZIP HF131105.ZIP

### Method 1 - Transfer the Downloaded Save File to your IBM i Server via Your PC

1. Transfer the Save file to your IBM i system via FTP. Ensure the IBM i FTP server is running.The FTP server can be started by running the command STRTCPSVR *FTP, but you must have authority to use the command.
2. Start a command prompt window on the PC.
3. Change to the directory containing the unzipped Save file.
4. Start FTP to your IBM i and transfer the Save file by issuing the following commands, replacing the words
   [host-system], [user-profile], and [password] with appropriate values for your environment.
FTP [host-system] [user-profile] [password] quote site namefmt 1 cd /QSYS.LIB/QGPL.LIB bin prompt put HF131105.savf quit

### Method 2 - Transfer the Downloaded Save File to your IBM i Server via IFS file system

1. Copy the unzipped file HF131105.savf to an IFS directory, for example /temp
2. Use the Copy From Stream File (CPYFRMSTMF) command to copy the data in the stream file to an IBM i Save file.
CPYFRMSTMF FROMSTMF('/temp/HF131105.savf') TOMBR('/qsys.lib/qgpl.lib/HF131105.file') MBROPT(*REPLACE)

### Installing the HF131105

1. Run the following IBM i command to restore all the objects in the Save file to QTEMP library:
RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/HF131105) RSTLIB(QTEMP)
2. Make QTEMP first in the library list.
RMVLIBLE QTEMP ADDLIBLE QTEMP
3. Run the command LOADFIX from QTEMP library as follow:
NOTE: LANSA systems that using IAPSs.
Set the correct IASP by using SETASPGRP command
For LANSA System: LOADFIX PCHNUM(HF131105) SELECT(LANSA_SYSTEM) PGMLIB([PGMLIB]) Where: PCHNUM is the fix number for this FIX. SELECT is the LANSA product(s) to which this fix will be applied Valid values are: LANSA_SYSTEM is the LANSA Base Software. LANSA_WEB_SERVER is the LANSA Web server. PGMLIB is the LANSA library name [PGMLIB]. This is valid only if SELECT = LANSA_SYSTEM ADMLIB is the LANSA Web server library name. This is only valid only is SELECT = LANSA_WEB_SERVER Note: A backup Save file is created in the [PGMLIB] library. The name of the Save file is HF131105xx. This Save file is deleted during next upgrade/EPC to the LANSA system.

### Verify The Installation

1. From a command line type [PGMLIB]/LANSA ABOUT.
2. From the LANSA ABOUT screen select F10 [EPC log] to display the LANSA LOG screen.
3. From the LANSA LOG screen take F11 [EPC log] to display all EPC and Fixes for the LANSA system.
4. If the FIX was installed successfully you will see a record with PCH and Fix number(131105).

### Clean up

1. Delete the Save file (HF131105) from the QGPL.
DLTF QGPL/HF131105
2. If you used Method 2 delete the stream file (/temp/HF131105.savf) from the IFS
DEL OBJLNK('/temp/HF131105.savf')

© LANSA