IRIS

International Reinsurance and Insurance System

Version 6.12 Upgrade (AS/400)

Installation Guide

Distribution:IRIS Customers

Applicability:IRIS v6.12

Reference:\\TRPS491\UUW\IRIS Support\New Versions of IRIS\v12\InstallationGuide6.12.doc

Version: 01

Date16th August 2002

Author:Amanda Jenkins

Authorised by: RebusDate: / /

©Copyright Rebus Insurance Systems Ltd. 2002

NOTE

Only signed hard copies and electronic masters of documents will be controlled.

Any other copy may not be current

IRIS Version 6.12 – Upgrade Installation Guide Version 6.12

Document history

Version
No / Date / Amendments / Document
01 / 16th August 2002 / First Edition
Q:\IRIS Support\New Versions of IRIS\v12\
InstallationGuide6.12.doc

-1 –

Document: Q:\IRIS Support\New Versions of IRIS\v12\Installation Guide 6.12.doc

Version: 01

Rebus Insurance Systems Limited

IRIS Version 6.12 – Upgrade Installation Guide Version 6.12

Introduction

Conventions

Throughout this guide the following conventions have been used:

AS/400 commands which are to be entered exactly as shown are displayed with a Bold typeface e.g. CHGLIBL LIBL(QTEMP)

Any commands which require a generic parameter to be substituted by specific parameter are displayed with a Normal Italic typeface enclosed within curly brackets e.g. {IRIS Data Library}, {Tape Device}.

Any AS/400 commands where a parameter needs to be entered where one does not exist are displayed in a Bold Italic typeface. This generally only occurs on AS/400 screen displays where the screen is initially displayed without a parameter and one is selected from a list e.g. *DEV *TAP

On AS/400 screens where the existing parameter requires amendment, the existing parameter is displayed in a Bold Italic typeface and is enclosed in curly brackets e.g. {XUNMSYS}. The value that needs to be substituted is given in the accompanying text.

-1 –

Document: Q:\IRIS Support\New Versions of IRIS\v12\Installation Guide 6.12.doc

Version: 01

Rebus Insurance Systems Limited

IRIS Version 6.12 – Upgrade Installation Guide Version 6.12

CONTENTS

1.Overview......

IRIS Release Naming Convention......

IRIS Upgrade Applicability......

2.Expected Time......

3.Installation Materials......

Enclosed Items......

Other Items Required......

4.Installation Pre-Requisites......

5.Installation Requirements......

Current Version of IRIS......

Exclusivity......

6.Installation Instructions......

General Instructions......

6.1.1Conversion Menu Options......

Installation Application Strategy Options......

6.1.2Environment (Mode)......

Pre-Installation Procedures......

6.1.3IRIS Preparation......

6.1.4Back-up IRIS System......

6.1.5System Preparation (Live Environment only)......

6.1.6Delete SQL Packages......

6.1.7Restoring XUNMTOOLS......

6.1.8Begin Upgrading IRIS to 6.12......

6.1.8.1Option 1: Set Parameters / DataAreas......

6.1.8.2Integrity Checks/Database Locks......

6.1.8.3Option 2: Restore Upgrade Libraries......

6.1.8.4Option 3: End Journalling on Upgrade Libraries......

6.1.8.5Option 4: Re-size Upgrade Files......

6.1.8.6Option 5: Upgrade Data Libraries......

6.1.8.7Option 6: Run Fix Programs......

6.1.8.8Option 7: Restart Journalling......

6.1.8.9Option 8: Update Bureau Message Severities......

6.1.8.10Option 9: Print Upgrade Messages......

7.System Library Changes......

APD Users......

Non-APD Users......

System Library Renaming

8.APD - MENU SYSTEM......

9.User Defined Queries......

10.Post Upgrade Procedures......

Set Printer Files to HOLD if required (only run after a live upgrade)

Installation checks......

Contact Rebus......

11.Data Areas......

12.Assistance Contacts......

13.Files Affected/Updated......

New Database Files......

New Fields

14.IR’s Addressed......

15.IR Release Notes......

16.Fix Programs......

17.Appendix......

Library Naming Convention......

18.Supplement......

Progress Flow Sheets......

1.Overview

IRIS Release Naming Convention

Because of the development of a GUI (Graphical User Interface) version of the IRIS database, it has become necessary to introduce a revised naming convention for the releases of the IRIS software. Previously the naming convention consisted of two parts:

  • a Version number and
  • a Release number

For example e.g. IRIS 8.1.

With the introduction of the GUI version, the naming convention consists of three parts:

  • the GUI Version number,
  • the IRIS version number and
  • a Release number

For example 4.9.1

The last release of the IRIS software was version 5.11.3 The subsequent release of IRIS is version 6.12.0

If the version of IRIS being used is earlier than version 5.11 then the current version of the IRIS software needs to be upgraded to Version 5.11 before proceeding with this upgrade to version 6.12 If you do not have the upgrade instructions or tape for version 5.11, then please contact either your Account Manager or those members of the Rebus staff mentioned in section 13 of this guide.

IRIS Upgrade Applicability

This documentation refers to the installation of the upgrade to IRIS Version 6.12 of IRIS from Version 5.11

The installation is achieved via a central menu, which is provided on the tape supplied. This method of operation promotes ease of use and reduces the possibility for error.

Please read the whole of this documentation thoroughly and decide on the various options presented before undertaking the upgrade installation.

2.Expected Time

To assist with the planning of this installation, estimates of the expected time are provided for each of the major sections of the installation. This includes the preparation time before the actual install is attempted. It should be emphasised that the times provided are only estimates. The processor size of the AS/400 and the quantity of the data within the IRIS database will affect the times stated below.

Pre - Installation preparation / 3.00 / hours
Back-up of IRIS libraries / 1.00 / hours
Restore items from Installation Tape / 1.00 / hours
Apply Installation / 2.00 / hours
Post Installation Procedures / 1.00 / hours
Total / 8.00

3.Installation Materials

Enclosed Items

The following items are enclosed:

Item Type / Title / Received
Tape / Release IRIS Version 6.12 - Upgrade
Documentation / Version 6.12 Installation Guide

If any of the above items are not received or received in a damaged condition then please contact your Account Manager or those personnel listed under Assistance / Contacts

The tapes specified above contain the following items for this installation

Tape / Release IRIS Version 6.12 Upgrade
Contents
Type / Name / Description
Library / XUNMTOOLS / U/W Utility Tools
Library / XUNMDTX012 / IRIS Data Objects
Library / XUNMSYS012 / IRIS Program Objects
Folder/ Document / USYSDOC/ USYSHLP / IRIS Help Text Documents

Other Items Required

The following documentation has been posted onto the web-site and relates to this installation.

Date / Document Identification / Title
29/8/02
29/8/02 / Installation Guide 6.12
V6.12 AS400 Release Notes / Installation guide 6.12
V6.12 AS400 Release Notes

4.Installation Pre-Requisites

This upgrade installation has been prepared on the basis that the following conditions exist on your machine:

  • The AS/400 is currently using Version 3 Release 2 or later of the operating system
  • The person undertaking the Installation has authority equivalent to QSECOFR or QSECADM
  • The User Profile E#UW exists on the AS/400 and has authority to the following commands:

RSTLIB

RSTOBJ

RSTDLO.

If any of the above are either not true or are not available then the upgrade installation will not run. Please contact your Account Manager for guidance.

5.Installation Requirements

Current Version of IRIS

This installation can only be applied to Version 5.11 of IRIS. The current version of IRIS can be found in Data Area ZZPFRZA0. If you are currently on v5.11 of IRIS, this data area should be set to ‘5.11’. The Data area can be accessed through the Data Area Manager option within IRIS. This option is found on the Housekeeping Menu. The data area can be found within the section entitled ‘General Data Area Maintenance’ and is entitled ‘IRIS Release Status’. In the past, this data area was not updated automatically when a system was upgraded, so unless it has been updated manually, it may be misleading.

Exclusivity

The upgrade installation cannot be applied if the IRIS system is in use. Please ensure that Users have been advised in advance of the intended date for the upgrade and that no Users are signed on to IRIS during the installation process.

6.Installation Instructions

General Instructions

Please note that all commands must be entered in upper case unless otherwise indicated. Sign on to the AS/400 using the profile E#UW. This profile must be used to ensure that the correct authority is used when applying Release 6.12

Before the upgrade you should try to obtain a password for one of the User signons. This will be useful for checking accessibility to the IRIS system after the upgrade is completed.

The following section is a description of each of the menu options. This should be read before starting the upgrade on page 12 under the Pre-Installation procedures.

Conversion Menu

6.1.1Conversion Menu Options

Option 1. Set Parameters / Data-areas

This option allows the operator to enter the details of the conversion to be performed. These details are stored and used by the later options on the menu.

Option 2. Restore Upgrade Libraries

This option restores all libraries necessary for the upgrade to Version 6.12 onto your AS/400. The libraries are named according to the standard library naming convention (The naming standards are explained in the Appendix in section 18).

Option 3. End Journalling on Data Libraries

Journalling is ended on the data library to be upgraded.

Option 4. Re-size Upgrade Files

This routine re-sizes all the new or amended physical files being delivered. This ensures that they are big enough to receive all of the data currently held in the equivalent environment to be upgraded IRIS file.

Option 5. Upgrade Data Libraries

This option upgrades the existing data library for the chosen environment on the AS/400 to version 6.12 of IRIS. All current data and data-area settings are retained. The parameters required for the option have already been entered under Option 1 - Set Parameters / Data Areas

If the error report contains one of the following error messages:

  • 'Error occurred while converting IRIS files: see report for details.'
  • 'Error occurred while adding members to currency file: see report for details.'
  • 'Error occurred while deleting unwanted objects: see report for details.'
  • 'Error occurred while running V12.0 fix programs: see report for details.'
  • 'Error occurred while changing authorities to *ALL: see report for details.'
  • 'Error occurred while updating MAXMBRS parameter: see report for details.'
  • 'Error occurred while setting data area values: see report for details.'

then the main data conversion has completed normally, but one of the additional conversion routines has failed. Menu option 5 - Upgrade Data Libraries can be re-run after the error has been corrected. The data conversion routine will continue from the point where the error occurred. The error report will be produced automatically on your spool queue and will help to determine the problem.

The upgrade can be re-started after any error that occurs during the Upgrade Data Libraries option has been corrected. It is not necessary to restore the AS/400 or start the whole upgrade again. The re-start is made available by re-running option 5 on the menu.

Option 6.Run Fix Programs

This option calls the relevant fix programs to be run. There are some fix programs that are run automatically, but there are others that are not run automatically. You need to check the Fix program section on p40 and follow the instructions.

Option 7. Restart Journalling

3Journalling is restarted for the (now upgraded) data library.

Option 8. Update Bureau Message Severities

This resets the Bureau message severities back to your preferred values.

Option 9. Print Update Messages

This option prints a report listing the current situation of the upgrade procedure, the upgraded library names and any outstanding tasks. The option can be run at any time to determine the status of the upgrade. It should be run if any of the options end abnormally.

Option 10.Display Upgrade Status Data-area

This option displays the stage in the upgrade process that has been reached.

Option 11.Tools

This is a new menu consisting of various options designed to reduce the manual work involved in the upgrade. Detail are below.

Conversion Tools Menu (CNVTOL)

This is a new menu that has been added since the 6.12 release to try to reduce the amount of manual job submission for the user. The Menu is accessed from the standard conversion menu. The options on the menu are not designed to be taken in sequence, one after the other, but are to be used when the manual states.

It is important to note that these options will not run unless the parameters have been set for the upgrade. This is explained later in the manual.

The menu is as below:

------

CNVTOL CNVTOL Menu

Select one of the following:

1. Set Spooled files to HOLD

2. Check Scope (parameters must be set for opt1 on Conversion menu)

3. Check for Data Library Lock (parameters must be set for opt1 on Conversion menu)

4. Rename System Library (only after LIVE upgrade)

5. Set Printer Files to HOLD

6. Update Library List

Selection or command

===>

F3=Exit F4=Prompt F9=Retrieve F12=Cancel

F13=Information Assistant F16=AS/400 main menu

------

Option 1. Set spool files to HOLD

It is a good idea to run this first as otherwise any reports produced may print off automatically.

Option 2.Check Scope

This option will submit the integrity checking job, and can only be run if the parameters have been set. The parameters are set using option 1 from the main Conversion menu. (F12 back to this menu if you are currently in the ‘Cnvtol’ menu). You will be asked to enter the name of the data library, journal library etc, and these will be used throughout the upgrade. If files are detailed on the reports produced by the checking job, these will need to be deleted before the upgrade can take place.

Option 3.Check for Data Library Lock

This option will display any users locking the data library. It is essential that no-one is using the data whilst the upgrade takes place, so do not start the upgrade whilst there are locks shown here.

Option 4.Rename System Library (only after LIVE upgrade)

The upgrade will install a new system library on your system, called XUNMSYS012. This option will rename your existing XUNMSYS library to XUNMSYS011, and will rename XUNMSYS012 to XUNMSYS.

This option should only be run following a Live upgrade

Option 5.Set Print files to HOLD

This option will prevent all print files produced by IRIS from printing automatically.

Option 6.Copy Library List

This option will copy ZCSLREP which holds the information necessary for APD into the relevant system library.

Installation Application Strategy Options

Please note that it is important to decide on the strategy to be adopted when applying this upgrade in advance of undertaking the task.

The installation can be performed in a number of ways depending on your current set up and the intended objective. It is important to decide your preferred route in advance. The factors affecting the choice are detailed below.

6.1.2Environment (Mode)

The following options are available for the upgrade of the environments on your system.

  • Upgrade of Test Environment or Training Environment Separately
  • Upgrade of Live Environment Only
  • Upgrade of multiple Environments Simultaneously

Your selection may depend on whether you intend to test the new installation prior to its release to general Users of the system for the live business activities

Pre-Installation Procedures

Ensure you are signed on as E#UW.

6.1.3IRIS Preparation

Before the installation is applied a check must be made to ensure that all batch jobs have completed normally. To check a particular job queue, use the command:

WRKJOBQ QBATCH

In this example QBATCH is the job queue, but you can substitute this for your own specific queue.

It is strongly recommended that a closings update and a post closings are run. Furthermore, any reports scheduled to run during or after the installation should be completed prior to this installation. If any jobs do not finish normally then the problem must be resolved before the installation is attempted.

6.1.4Back-up IRIS System

Before applying Release 6.12, it is imperative that the IRIS system is backed up. This will ensure that the system can be restored to its previous state should the installation fail or an unforeseen event occur whilst the implementation is taking place.

6.1.5System Preparation (Live Environment only)

The installation will proceed more quickly if the following subsystems are ended:

  • QSNADS,
  • QBATCH.

Note: These sub-systems should be ended for a LIVE upgrade, but NOT for a TEST upgrade, since it will affect Users of the LIVE system.

The subsystems can be ended one at a time using the following command:

ENDSBS SBS({name of subsystem})

6.1.6Delete SQL Packages

Please note that you need to delete the SQL packages for QGPL if you are upgrading a test or live system environment. In both test and live upgrades, users will have to be signed off whilst this deletion takes place. They will be able to sign back on to any environment not being upgraded straight after the deletion. For example, if you are upgrading the test system, users will be able to sign back on to live once the sql packages have been deleted.

DLTSQLPKG QGPL/IRIS*

DLTSQLPKG data library/IRIS*

6.1.7Restoring XUNMTOOLS

Firstly, you will need to remove your existing copy of the conversion tools library, XUNMTOOLS, from the library list. This will enable the existing library to be deleted. To remove the library from the library list type:

EDTLIBL

on a command line and press enter. This will display the libraries currently associated with your job. If XUNMTOOLS is displayed simply remove it from the list. Press enter twice to return to the previous screen.

To delete the existing XUNMTOOLS library from the AS/400 enter the following command:

DLTLIB LIB(XUNMTOOLS)

If you receive the error message "Library XUNMTOOLS not found" as a result of the delete library command, then ignore it.

Having deleted the library, the version of the XUNMTOOLS library on the tape can now be restored onto your computer.