Introduction to ISETUP

FOCUS includes an automated installation and maintenance procedure named ISETUP. You must use this procedure in order to install or apply maintenance to FOCUS.

ISETUP refers to installing a new version of FOCUS as an Install and to upgrading your version of FOCUS as a Refresh.

ISETUP can download files from a cartridge or from an Information Builders FTP site.

Note: In order to download files from the Information Builders FTP site, you must use a z/OS ID that has access to FTP, TSO RECEIVE, and to the production and test FOCUS libraries.

There are aspects of the upgrade or maintenance process that are not handled by ISETUP. These are detailed in this document and still require manual intervention.

Important: ISETUP unloads or downloads the files for all data adapters (Interfaces). Therefore, you do not have to allocate and unload or download the data adapter files manually. However, using the instructions in the relevant Installation Guides for those data adapters, you must reinstall every data adapter to which you want to have access in the installed or refreshed version of FOCUS.

ISETUP asks you for the high-level qualifier for your FOCUS data sets. Based on this qualifier and a list of all of the standard data set names (low level qualifiers), ISETUP installs all the necessary FOCUS libraries. The list of low level qualifiers ISETUP uses is in member FOCSNAME in the F.HOME.DATA data set. If you do not want to use the standard data set names, see Specifying Non-Standard Data Set Names.

How to Choose Between the Install and Refresh Functions

If you are applying maintenance to an existing version of FOCUS, execute the Refresh function of ISETUP.

If you are upgrading to a new version of FOCUS, execute the Install function of ISETUP.

About the ISETUP Procedure

The ISETUP procedure is an interactive process that uses ISPF panels. If you are:

Unloading from a cartridge, the person executing ISETUP must unload only the first data set from the distribution cartridge. This first data set contains the procedure that allocates and unloads the remaining data sets and creates and submits the required JCL for the install or maintenance refresh.
Downloading from an Information Builders FTP site, the person executing ISETUP must first download the HOME.DATA data set from the appropriate FTP site. This first data set contains the procedure and supporting data for allocating and downloading the remaining data sets and for creating and submitting the required JCL for ISETUP.
Note: There are separate domestic and international download sites. The domestic site is named downloadftp.ibi.com, and the international site is named emeaftp.ibi.com. The purpose of having separate sites is to make the download performance efficient for both domestic and international customers. Both sites contain identical files.

Important! You must use the version of ISETUP that comes with your FOCUS release to install FOCUS. For example, if you are installing FOCUS 7.7.03 gen 771, you cannot reuse the F.HOME.DATA library that you used to install gen 770.

Installing without the use of ISETUP is no longer supported. Additionally, you cannot use previous versions of your installation JCL to install FOCUS 7.7.x.

You must execute ISETUP from the ISPF command shell.

You should not use ISETUP to overwrite your current production FOCUS data sets with new versions.

Overview of the ISETUP Procedure

In this section:

The initial steps differ depending on whether you are unloading from a cartridge or downloading from an FTP site.

Top of page

Overview of the Electronic Download Process

The following is a high level summary of how to receive the FOCUS release or maintenance electronically:

The following two steps to FTP GET and TSO RECEIVE the HOME.DATA library can be done in a batch job or interactively at the TSO Ready prompt. If you chose to use the batch job, it should take approximately one minute of run time to complete.
- FTP the HOME.DATA file to your system.
- RECEIVE the file to a PDS.
Execute the ISETUP procedure from the ISPF command shell.
1. Fill in the information requested on the screens displayed by ISETUP.
2. Submit the JCL created by ISETUP when ready to proceed.
  Note: The FOCUS installation batch job created by ISETUP should take approximately 15 to 30 minutes of run time to complete.
3. Verify that the ISETUP job was successful by examining the completion codes for each step.
When this is complete, you have a basic test environment with the FOCUS installation or maintenance applied which is ready to be tested using the verification standards of your site.
After successful testing of the FOCUS release or maintenance, move the test environment to production according to the standards of your site.

Top of page

Overview of ISETUP When Unloading From a Cartridge

The following is a high level summary of how to execute ISETUP:

Mount the distribution cartridge.
Create the JCL to unload the first data set from the distribution cartridge using the sample JCL provided in Unload HOME.DATA From the Distribution Cartridge. This data set contains the ISETUP procedure.
Execute the ISETUP procedure from the ISPF command shell.
Fill in the information requested on the screens displayed by ISETUP.
Submit the JCL created by ISETUP when ready to proceed.
Verify that the job created by ISETUP was successful by examining the completion codes for each step.
When this is complete, you have a test environment with the installed or refreshed version of FOCUS, which is ready to be tested using the verification standards of your site.
After successful testing of this environment, move the test environment to production according to the standards of your site.

Top of page

Overview of Manual Steps Following ISETUP

The following features are not installed or refreshed by ISETUP. For these features, you must follow the instructions in the FOCUS Installation Guide for your current production version of FOCUS:

The number of cache pages.
FOCCALC (without the graphics facility).
FOCPARM Assembler CSECT.
FOCPARM member of ERRNLS.DATA data set.
FOCPROF member of ERRNLS.DATA data set.
IBITABLA member of FOCCTL.DATA data set.
The FOCUS Menu.
The FOCUS Toolkit.
Simultaneous Usage facility (SU).
User Exits.
IBI Subsystem (the Subsystem name, however, is preserved).
FOCCALC (with the graphics facility).
HiperBudget.
CA-ACF2 Interface.
SU Security Interface (SUSI).
NLS configuration.
Maximum number of data exceptions.
Data Adapters (Interfaces, for example, DB2 or ADABAS).
Important: ISETUP unloads or downloads the files for all data adapters. Therefore, you do not have to allocate and unload or download the data adapter files manually. However, using the instructions in the relevant Installation Guides for those data adapters, you must reinstall every data adapter to which you want to have access in the installed or refreshed version of FOCUS.

If you run FOCUS out of LPA libraries, you must do the following:

Copy all the reentrant modules back into FOCLIB.LOAD from FOCLPA.LOAD. (Use JOB JFSCPBCK. It is recommended that you compress FOCLIB.LOAD before you perform the copy.)
Run ISETUP.
Copy the reentrant modules from FOCLIB.LOAD back into FOCLPA.LOAD. (Repeat JOB JFSCPLPA. It is recommended that you compress FOCLPA.LOAD before you perform the copy.)
Delete the reentrant modules FROM FOCLIB.LOAD. (Repeat JOB JFSDELPA.)