Installing FOCUS Using ISETUP

In this section:

ISETUP provides three ways to install FOCUS:

The ISETUP panels consist of input fields in which you can enter information and display fields in which you cannot enter information. Input fields have a red background and display fields have a white background.

Note: The ISETUP procedure is in a library named HOME.DATA. You should download all data sets to a name that keeps the existing low-level qualifiers and prefixes them with a high-level qualifier of your choice, followed by a required FOCUS qualifier consisting of the letter F. For example, HOME.DATA will become new_hql.F.HOME.DATA.

After the ISETUP procedure has executed, all of your HOME libraries will have names of the form new_hlq.F.HOME.suffix, where new_hlq is the high-level qualifier you specify on the ISETUP panels. For example, if you specify the high-level qualifier FOCUS.7709, ISETUP will create a data set called FOCUS.7709.F.HOME.LOAD.

The following sections describe all of the installation options. Each option builds and, optionally, executes the JCL needed to install FOCUS.

Note that when a screen opens, its input fields may be populated with the values from a previous install. When you change any values, you must press Enter once to register the changes and then press Enter again to proceed to the next panel.

If you decide you are not satisfied with the values you entered and you want to change them, press PF3 to return to the previous panel.

ISETUP Processing Flow

After you download and receive the HOME.DATA library, you have the ISETUP installation utility on your system. When you execute ISETUP:

To run the newly installed release of FOCUS, you can use your CLIST or JCL from a prior release of FOCUS by changing the high-level qualifier to the one you just installed. You do not have to modify the CLIST or JCL to allocate any CONF or HOME libraries. This is the reason the alias libraries were created.

Note: There is a sample CLIST (member FOCUSC), JCL (member FOCUS), and alias creation job (member ALIAS) in the CONF.DATA library.

Installing FOCUS Using the FTP Option

In this section:

This section describes how to install FOCUS by downloading the distribution files from an Information Builders FTP site.

You can download the distribution files automatically or manually. The manual option is available for cases in which the automatic download cannot be completed. For more information, see Download the Installation Libraries Manually.

Download HOME.DATA Automatically and RECEIVE it to a PDS

In this section:

How to:

Prior to executing this step, you must know the FTP site, user ID, password, and directory path to the install folder. Information Builders will send you an email with this information when you order the install.

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.

You have two choices for downloading and receiving the HOME.DATA library:

  • You can do the download and receive steps in a batch job. This method is preferred because once you edit the JCL for one release of FOCUS 7.7, you can edit a few parameters and run the same JCL for any other release of FOCUS 7.7.
  • You can do the download and receive steps interactively at the TSO Ready prompt. This method requires constant monitoring and responding to prompts and is prone to typographical errors. It is also a slower process than running the batch job.

Downloading and Receiving HOME.DATA in a Batch Job

How to:

The JCL illustrated in this section will FTP GET the HOME.DATA library and TSO RECEIVE it into a PDS on your system. You must provide certain parameters to the job, but no other changes are necessary to reuse it for a new FOCUS release. The parameters needed for each execution of the job are provided in the download letter you receive with each release of FOCUS.

JCL created by ISETUP is supported in JES2 but not in JES3 environments. Those customers running JES3 will have to tailor the JCL to satisfy the JES3 (job submission) rules of their company.

For example, you may have to pre-allocate the libraries created by ISETUP in the JCL member ISETUPJ1 located in the library install_HLQ_CONF.DATA.

In order to create the ISETUPJ1 JCL, you have to invoke the ISETUP utility and fill in the appropriate input fields In the ISPF panels. On the confirmation panel, enter N (NO) to create the JCL but not submit the JCL.

Note: The batch job to download and receive the HOME.DATA library should take approximately one minute of run time to complete.

Procedure: How to Create and Run the Batch Job to Download and Receive HOME.DATA

This section provides sample JCL that you can copy into your JCL library and edit in order to create the download and receive job for the HOME.DATA library.

  1. Copy the following JCL into a member named RECHOME in your JCL library:
    //job card goes here
//*************************************************************
//*    JCL to FTP GET and TSO RECEIVE the HOME.DATA library
//*         for the purpose of installing FOCUS 7.7.x.
//*
//*
//*                  Runtime Instructions
//* Please add an appropriate JOBCARD, a valid HLQ, a valid 
//* userid, password, folder path (obtained from the download
//* instructions letter),an appropriate temporary DSNAME, and a
//* permanent DSNAME for the receive step. Then submit the JCL.
//*************************************************************
//STEP1    EXEC PGM=IKJEFT01,REGION=0M,DYNAMNBR=50
//SYSTSIN  DD *
ftp ftpsitename                 
//SYSTSPRT DD SYSOUT=*
//SYSTSOUT DD SYSOUT=*
//SYSIN  DD * ftpsiteuserid ftpsitepassword   
LOCSITE CYLINDERS PRI=10 SEC=1
LOCSITE LRECL=80 RECFM=FB BLKSIZE=27920
cd /path_to_service_pack_folder        
BIN
GET HOME.DATA 'new_hlq.HOME.DATA.RECV' (REPLACE
quit
LOGOFF
//*
//* Receive the temporary HOME.DATA.RECV file into a PDS library
//*
//RECHD    EXEC PGM=IKJEFT01
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//SYSIN    DD *
RECEIVE INDATASET('new_hlq.HOME.DATA.RECV')
SPACE(10 1) CYL DSNAME('new_hlq.F.HOME.DATA')
//*
/*

    where you must add a valid job card, copy the parameters to be substituted from the download instruction letter, and paste them into column 1 of the appropriate lines of the JCL, without extraneous characters or spaces:

    ftpsitename

    Is the name of the FTP site provided to you by Information Builders in the download instructions e-mail.

    ftpsiteuserid

    Is the user ID provided to you by Information Builders in the download instructions e-mail.

    Note: The FTPSITE user ID will expire in 7 days.

    The FTPSITE user ID is case-sensitive.

    ftpsitepassword

    Is the password provided to you by Information Builders in the download instructions e‑mail.

    Note: The FTPSITE password will expire in 7 days.

    The FTPSITE password is case-sensitive.

    path_to_service_pack_folder

    Is the path to the download folder provided to you by Information Builders in the download instructions e‑mail.

    new_hlq

    Is the high-level qualifier under which the new release of FOCUS will be installed.

Example: Sample JCL For Downloading and Receiving HOME.DATA

The following JCL has sample values substituted for the parameters that need to be input. The high-level qualifier is user-defined. In this case, HOME.DATA will be downloaded to data sets under the high-level qualifier SYSADMIN1. In an actual install, you should use the same high-level qualifier under which you will install FOCUS: 

//SYSADMIN1  JOB (ISETUP),MSGCLASS=X,CLASS=A,NOTIFY=SYSADMIN1,MSGLEVEL=(1,1)       
//*************************************************************
//*    JCL to FTP GET and TSO RECEIVE the HOME.DATA library
//*         for the purpose of installing FOCUS 7.7.x.
//*
//*
//*                  Runtime Instructions
//* Please add an appropriate JOBCARD, a valid HLQ, a valid 
//* userid, password, folder path (obtained from the download
//* instructions letter),an appropriate temporary DSNAME, and a
//* permanent DSNAME for the receive step. Then submit the JCL.
//*************************************************************
//STEP1    EXEC PGM=IKJEFT01,REGION=0M,DYNAMNBR=50
//SYSTSIN  DD * 
ftp downloadftp.ibi.com           
//SYSTSPRT DD SYSOUT=*
//SYSTSOUT DD SYSOUT=*
//SYSIN  DD *  
FOzI552015@ibi.com
Qm4MRAe    
LOCSITE CYLINDERS PRI=10 SEC=1
LOCSITE LRECL=80 RECFM=FB BLKSIZE=27920
cd /FOCUS/77/zOS_2_1_and_up_zSeries_64bit/7709M/Prod_1544           
BIN
GET HOME.DATA 'SYSADMIN1.HOME.DATA.RECV' (REPLACE
quit
LOGOFF
//*
//* Receive the temporary HOME.DATA.RECV file into a PDS library
//*
//RECHD    EXEC PGM=IKJEFT01
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//SYSIN    DD *
RECEIVE INDATASET('SYSADMIN1.HOME.DATA.RECV')
SPACE(10 1) CYL DSNAME('SYSADMIN1.F.HOME.DATA')
//*
/*

Downloading and Receiving HOME.DATA Interactively

This section describes how to download and receive the HOME.DATA library interactively at the TSO Ready prompt.

Procedure: How to FTP the HOME.DATA File to Your System

  1. Issue the following command from the ISPF Command Shell (option 6) to FTP the HOME.DATA file:
    FTP ftpsitename 

    where:

    ftpsitename

    Is the name of the FTP site provided to you by Information Builders in the download instructions e‑mail.

  2. Enter the user ID supplied by Information Builders when prompted by the following messages:
    EZA1459I NAME (ftpsiteuserid): 
EZA1701I >>> USER

    where:

    ftpsiteuserid

    Is the user ID provided to you by Information Builders in the download instructions e‑mail.

    Note: The FTPSITE user ID will expire in 7 days.

    The FTPSITE user ID is case-sensitive.

  3. Enter the password supplied by Information Builders when prompted by the following messages (the password will not display):
    331 Password required for userid. 
EZA1789I PASSWORD:

    where:

    ftpsitepassword

    Is the password provided to you by Information Builders in the download instructions e‑mail.

    Note: The FTPSITE password will expire in 7 days.

    The FTPSITE password is case-sensitive.

    The following messages indicate that you have successfully logged into the FTP site and can issue FTP commands: 

    230 User userid logged in.
EZA1460I Command:
  4. Change directories to the folder that contains the install and establish binary mode transfer:
    CD /path_to_download_folder
BINARY

    where:

    path_to_download_folder

    Is the path to the download folder provided to you by Information Builders in the download instructions e‑mail.

    The following messages indicate that binary mode has been established, and FTP is waiting for a command: 

    EZA1701I >>> TYPE I
200 Type set to I.
EZA1460I Command:
  5. Set the space and DCB parameters for the HOME.DATA file to be transferred:
    LOCSITE RECFM=FB LRECL=80 BLKSIZE=27920 PRIMARY=10 SECONDARY=1 CYLINDERS

    The following message indicates that FTP is waiting for another command: 

    EZA1460I Command:
  6. Transfer HOME.DATA to your system:
    GET HOME.DATA 'new_hlq.HOME.DATA.RECV'

    The high-level qualifier, new_hlq, is recommended to be the same high-level qualifier under which ISETUP will create the installed version of FOCUS.

    Messages similar to the following indicate that the transfer was successful: 

    150 Opening BINARY mode data connection for HOME.DATA(1991120
bytes).
226 Transfer complete.
EZA1617I 1991120 bytes transferred in 0.440 seconds.  Transfer rate
4525.27 Kbytes/sec.
EZA1460I Command:
  7. Exit the FTP session:
    QUIT

Procedure: How to RECEIVE the HOME.DATA.RECV File to a PDS

The HOME.DATA.RECV file is on your system in compressed format. You must issue the RECEIVE command to convert it to a PDS. The PDS will have the high-level qualifier of your choice (new_hlq) and the required FOCUS qualifier that consists of the letter F.

  1. Issue the following command from the ISPF Command Shell (option 6) to RECEIVE the HOME.DATA.RECV file:
    RECEIVE INDATASET('new_hlq.HOME.DATA.RECV')

    where:

    'new_hlq.HOME.DATA.RECV'

    Is the file you transferred to your system in How to FTP the HOME.DATA File to Your System.

    The following messages display indicating the data set name of the PDS that is being created: 

    INMR901I Dataset userid.DDNAME.XMITIN from userid on lpar  
INMR906A Enter restore parameters or 'DELETE' or 'END' +
  2. Enter the following space parameters:
    SPACE(10 1) CYL DSNAME('new_hlq.F.HOME.DATA')

    Note that the required FOCUS qualifier (F) has been added to the library name following your high-level qualifier.

    Note: If you have additional required parameters, such as VOLSER, please refer to the TSO HELP RECEIVE information or the IBM Communications Server documentation for RECEIVE.

Download the Installation Libraries Manually

How to:

Reference:

In the event the Mainframe firewall at your site prevents you from running the ISETUP FTP option, you can use the following procedure to manually download the ISETUP libraries to a non-mainframe platform and then upload the libraries to the mainframe platform.

This procedure will transfer the ISETUP libraries necessary to install FOCUS on the mainframe. After the libraries have been transferred, you will use the ISETUP DISK option to complete the installation.

You should only run this procedure after getting approval from your management and security team so that you do not violate the mainframe security policies at your site.

Prior to executing this step, you must know the FTP site, user ID, password, and directory path to the installation folder. Information Builders will send you an email with this information when you order the FOCUS release.

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.

Reference: Overview of Manual Download Steps

The following is a high-level overview of the manual download process:

  • Log on to your non-mainframe platform.
  • Connect to the FTP site specified in the download instructions letter you received and download the files. Remain in the directory with the downloaded files.
  • Log on to your z/OS platform and allocate temporary data sets.
  • FTP the downloaded files from your non-mainframe platform to the temporary data sets on z/OS.
  • RECEIVE the files into the appropriate PDS libraries.

Procedure: How to Download The Libraries Manually

First, you have to download to your preferred non-mainframe platform, then FTP the files to z/OS.

  1. Log on to your non-mainframe platform.
  2. Create a download directory (if necessary).
  3. Connect to the FTP site specified in the download instructions letter:
    ftp ftpsitename
  4. Enter your user ID and password from the download instructions letter when prompted.
  5. Enter binary mode by issuing the following command:
    binary
  6. On the local machine, change to the directory to which you will FTP the files:
    lcd downloaddirectory
  7. On the FTP site, change to the directory with the download files, as instructed in the download email:
    cd path_to_download_folder
  8. Retrieve the download libraries:
    get HOME.DATA
get HOME.ETC
get HOME.BIN
get HOME.ACX
get HOME.FEX
get HOME.MAS
get HOME.ERR
get HOME.LOAD
  9. Terminate your FTP connection:
    quit

Procedure: How to Allocate Temporary Libraries on z/OS

You have downloaded the files to a non-mainframe platform. Now you must log on to z/OS and allocate temporary data sets.

Log on to TSO and allocate temporary sequential files using the preferred method for allocating files at your site, either ISPF or JCL. The temporary data sets should have the following suggested names and DCB attributes of XMIT formatted (compressed) files:

Data Set Name

DCB Attributes

 
new_hlq.HOME.DATA.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(10,2))
 
new_hlq.HOME.ETC.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(50,5))
 
new_hlq.HOME.BIN.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(500,50))
 
new_hlq.HOME.ACX.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(5,1))
 
new_hlq.HOME.FEX.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(25,5))
 
new_hlq.HOME.MAS.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(10,1))
 
new_hlq.HOME.ERR.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(90,10))
 
new_hlq.HOME.LOAD.TEMP
 
LRECL(80),RECFM(F,B),BLKSIZE(3120),SPACE=(CYL,(350,50))

Procedure: How to FTP the Files to z/OS

On your non-mainframe platform, you are in the directory that contains the files you downloaded. On z/OS, you are still logged into your TSO ID.

  1. FTP to your z/OS platform:
    ftp zosdomain
  2. Establish binary mode transfer by issuing the following command:
    binary
  3. Retrieve the libraries to z/OS:
    put HOME.DATA 'new_hlq.HOME.DATA.TEMP' (replace
put HOME.ETC  'new_hlq.HOME.ETC.TEMP' (replace
put HOME.BIN  'new_hlq.HOME.BIN.TEMP' (replace
put HOME.ACX  'new_hlq.HOME.ACX.TEMP' (replace
put HOME.FEX  'new_hlq.HOME.FEX.TEMP' (replace
put HOME.MAS  'new_hlq.HOME.MAS.TEMP' (replace
put HOME.ERR  'new_hlq.HOME.ERR.TEMP' (replace
put HOME.LOAD 'new_hlq.HOME.LOAD.TEMP' (replace

Procedure: How to RECEIVE Each File to the Appropriate PDS

The files have been transferred to z/OS into the temporary PDS libraries you allocated previously. Now you must RECEIVE them (uncompress them) into the permanent PDS installation libraries.

  1. Using TSO, expand the files retrieved in the FTP step into PDSs using the following command for each temporary data set. For example:
    RECEIVE INDSN('new_hlq.HOME.DATA.TEMP')
  2. Reply to the restore prompt with the name of the receiving data set. The receiving data set has the character F after the high-level qualifier and does not have the .TEMP suffix. For example: 
    DSNAME('new_hlq.F.HOME.DATA')

The comlete list of data sets after they are uncompressed follows: 

 new_hlq.F.HOME.DATA
 new_hlq.F.HOME.ETC  
 new_hlq.F.HOME.BIN  
 new_hlq.F.HOME.ACX  
 new_hlq.F.HOME.FEX  
 new_hlq.F.HOME.MAS
 new_hlq.F.HOME.ERR  
 new_hlq.F.HOME.LOAD

At the end of this process, you have created the product installation libraries. Proceed with installation using the DISK option, as described in Installing FOCUS Using the Disk Option.

The temporary data sets (.TEMP files) should be deleted after the installation is complete and has been tested.

Optionally, Specify Non-Standard Data Set Names

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.

Invoke ISETUP to Install FOCUS With the FTP Option

How to:

Now that the F.HOME.DATA data set resides on your system, you can run the ISETUP procedure to install FOCUS.

JCL created by ISETUP is supported in JES2 but not in JES3 environments. Those customers running JES3 will have to tailor the JCL to satisfy the JES3 (job submission) rules of their company.

For example, you may have to pre-allocate the libraries created by ISETUP in the JCL member ISETUPJ1 located in the library install_HLQ_CONF.DATA.

In order to create the ISETUPJ1 JCL, you have to invoke the ISETUP utility and fill in the appropriate input fields In the ISPF panels. On the confirmation panel, enter N (NO) to create the JCL but not submit the JCL.

Procedure: How to Invoke ISETUP to Install FOCUS With the FTP Option

  1. Invoke ISETUP by executing the CLIST contained in member ISETUP of the new_hlq.F.HOME.DATA data set, where new_hlq is the high-level qualifier for the downloaded version of HOME.DATA.

    Note: You must use the version of ISETUP that you just downloaded with the new FOCUS data sets. You cannot use an older version of ISETUP.

    You must execute this CLIST from the ISPF command shell (option 6): 

    EXEC 'new_hlq.F.HOME.DATA(ISETUP)'

    The ISETUP Main Menu opens: 

    Information Builders    Installation and Configuration     Mainframe FOCUS
Command ===>                                                       F0

Please select one of the following options:

         1. Mainframe FOCUS Installation

            . Install FOCUS into standard MVS libraries.




Enter selection (Default=1) ===> 1

Press Enter to continue, PF3 to END                        Version: 7703
  2. Choose Option 1 for the Core FOCUS installation, and press Enter to register this choice.

    Press Enter again to proceed to the next panel.

    The FOCUS Installation and Configuration panel opens. 

    Information Builders   Installation and Configuration      Mainframe FOCUS
Command ===>                                                       F1

Please select one of the following options:

         1. Install and Configure
         2. Refresh Installation (Reinstall, Keep Configurations)


Enter selection (Default=1) ===> 1
Input source                ===> D                  (T)ape,(D)isk or (F)tp
Installation Userid         ===> USERID1               Logged on Userid


Enter Job Card information               Override JOB name checking ===> N
===> // JOB (ACCT INFO),__________________________________________________
===> //*__________________________________________________________________
===> //*__________________________________________________________________
Press Enter to continue, PF3 to END
  3. Select Option 1 (Install and Configure, the default).

    The Input source value will be filled in with default options. The Installation Userid field will contain your logon ID.

  4. Change the Input source option to F (files are to be downloaded), and create a valid JOB card according to the specifications of your site.
    Note: Your JOB card must have a REGION parameter that specifies at least 4M. For example:
    //FOCUSER1 JOB (PDSINSTL,USR),'J.USERNME',NOTIFY=FOCUSER1,REGION=4M
    If you get messages similar to the following, the region size is not large enough to run ISETUP. In that case, change the REGION parameter to specify 0M and rerun ISETUP.
    13.13.10 JOB12752  IEA705I ERROR DURING GETMAIN SYS CODE = 878-10 QCSJLDPI CO 
   .
   .
   .
13.13.10 JOB12752  IEF450I QCSJLDPI COPY01 IFOCINST - ABEND=S878 U0000 REASON=0

    Press Enter.

    Press Enter again to proceed to the next panel.

    The New Installation FTP Download panel opens. 

    Information Builders   Installation and Configuration      Mainframe FOCUS
Command ===>                                                       FA
                                 New Installation

 Please enter the following information for Mainframe FOCUS

  Input FTP user information

   FTP Userid                ===>

   FTP Password              ===>

  Output Libraries

   Output Libraries HLQ      ===>

                        Unit ===> SYSDA       Volume ===>



   Installation JCL Library  ===> INSTALLED_HLQ.CONF.DATA

 Press Enter to continue, PF3 to return to previous menu
  5. Tab to the input fields and enter the values for FTP user ID, FTP password, and your output library high-level qualifier.

    You can change the following input fields:

    • FTP Userid. Enter the user ID for the FTP site from the Information Builders email.
    • FTP Password. Enter the password for the FTP site from the Information Builders email.
    • Output Libraries HLQ. Enter the high-level qualifier for the FOCUS libraries.

      Note: You must make sure that the combination of your high-level qualifier and the FOCUS library names is less than or equal to 44 characters, the maximum name length supported on z/OS.

    • Unit. By default, the Unit value is SYSDA. SYSDA is defined by your systems programming group to be a type of DASD device. FOCUS must be installed into PDSE libraries on a 3390 device type. If the SYSDA definition at your site does not comply with these requirements, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDSE library.
    • Volume. This is an optional input value that can be used to place the FOCUS libraries on a specific volume.

    When you are finished, press Enter.

    Press Enter again to proceed to the next panel.

    The New Installation FTP Confirmation panel opens: 

    Information Builders    Installation and Configuration     Mainframe FOCUS
Command ===>                                                               FB
                                 New Installation

 Please confirm the following information for Mainframe FOCUS

  Input FTP user information
   FTP Userid                 ===>    FTPUSERID@ibi.com

    FTP Password                    ===>    FTPpassword

  Product Configuration parameters
   Output Libraries HLQ       ===> NEW_HLQ

                        Unit  ===> SYSDA       Volume ===>
  (Above will be used for all output libraries)


   Installation JCL Library   ===> NEW_HLQ.CONF.DATA
   Preview output allocations ===> N

 Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> s   (Enter N, C or S)
 Press Enter to continue, PF3 to return to previous menu

    Note: The FOCUS installation batch job created by ISETUP should take approximately 15 to 30 minutes of run time to complete.

  6. Confirm the options that you entered on previous panels.

    You can see what the installation process will allocate on your behalf by changing the Preview output allocations field from N to Y and pressing Enter.

    If you changed Preview output allocations to Y, the preview panels will display before ISETUP creates the installation JCL. While you examine the Preview panels, if you see one or more values you want to correct, press PF3 as many times as necessary to return to the panel that you want to modify.

    There may be several Preview panels. You can navigate between them using the following keys:

    • To continue to the next preview panel, press PF8.
    • To return to the previous preview panel, press PF7.
    • To exit the preview panels and return to the Confirmation panel, press Enter or PF3.

    After you return from the preview panels to the Confirmation panel, the Preview output allocations field is reset to N.

    The following are sample preview panels:

    Information Builders      Installation and Configuration     Row 1 to 17 of 99
Command ===>                                                  SCROLL ===> PAGE

 Datasets to be allocated (Listed by functional area)

   Function    Action      DSN
   --------    ------      ---
   HOME        CREATE      NEW_HLQ.F.HOME.ETC
   HOME        CREATE      NEW_HLQ.F.HOME.ACX
   HOME        CREATE      NEW_HLQ.F.HOME.FEX
   HOME        CREATE      NEW_HLQ.F.HOME.MAS
   HOME        CREATE      NEW_HLQ.F.HOME.BIN
   HOME        CREATE      NEW_HLQ.F.HOME.ERR
   HOME        CREATE      NEW_HLQ.F.HOME.LOAD
   CONF        CREATE      NEW_HLQ.CONF.CFG
   CONF        CREATE      NEW_HLQ.CONF.ACX
   CONF        CREATE      NEW_HLQ.CONF.MAS
   CONF        CREATE      NEW_HLQ.CONF.PRF
   ALIAS       CREATE      NEW_HLQ.ADABAS.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.ADABAS.LOAD
   RELATED     -->         NEW_HLQ.F.HOME.LOAD
    Information Builders   Installation and Configuration    Row 18 to 34 of 99
Command ===>                                               SCROLL ===> PAGE
                                                                         DD
 Datasets to be allocated (Listed by functional area)

   Function    Action      DSN
   --------    ------      ---

   ALIAS       CREATE      NEW_HLQ.DATACOM.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.DATACOM.LOAD
   RELATED     -->         NEW_HLQ.F.HOME.LOAD

   ALIAS       CREATE      NEW_HLQ.ERRNLS.DATA
   RELATED     -->         NEW_HLQ.F.HOME.ERR

   ALIAS       CREATE      NEW_HLQ.ERRORS.DATA
   RELATED     -->         NEW_HLQ.CONF.CFG

   ALIAS       CREATE      NEW_HLQ.FOCCTL.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.FOCDBC.DATA
  7. When you have verified your choices on the Confirmation panel, you must choose a continuation option:
    • The default option is N, which cancels the process and returns to the FOCUS Installation panel.
    • Option C creates the installation JCL and saves it to member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set. You can review, edit, update, or submit it manually without re-invoking ISETUP:
      ISETUP - Allocating file 'NEW_HLQ.CONF.DATA'
ISETUP - Creating installation options file ISOPTS1
ISETUP - Creating main JCL ISETUPJ1
ISETUP - JCL created in NEW_HLQ.CONF.DATA but not submitted
ISETUP - You can manually submit the following JCL to complete install
ISETUP - NEW_HLQ.CONF.DATA(ISETUPJ1)
***
    • Option S creates the installation JCL, saves it to member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set, and submits the job directly to the system for processing:
      ISETUP - Deleting file  'NEW_HLQ.CONF.DATA'
IDC0550I ENTRY (A) NEW_HLQ.CONF.DATA DELETED
ISETUP - Allocating file 'NEW_HLQ.CONF.DATA'
ISETUP - Creating installation options file ISOPTS1
ISETUP - Creating main JCL ISETUPJ1
ISETUP - Submitting JCL, use SDSF (or site standard) to monitor job
IKJ56250I JOB USERID1I(JOB28173) SUBMITTED
***

    To register your choice, press Enter.

    To execute the option you chose, press Enter again.

Example: Sample FOCUS FTP Installation

Execute the ISETUP CLIST from the ISPF command shell (option 6).

Assume your new installed libraries will be under the high-level qualifier NEW_HLQ, that you downloaded the HOME.DATA library under this same high-level qualifier, and that your userid is FOCUSER1: 

EXEC 'NEW_HLQ.F.HOME.DATA(ISETUP)'

The ISETUP Main Menu opens:

Information Builders       Installation and Configuration       Mainframe FOCUS
Command ===>                                                                 F0


 Please select one of the following options:

          1. Mainframe FOCUS Installation

             . Install FOCUS into standard MVS libraries.



                                                                                
 Enter selection (Default=1) ===> 1

 Press Enter to continue, PF3 to END                             Version: 7703

Choose Option 1 for the Core FOCUS installation, and press Enter to register this choice.

Press Enter again to proceed to the next panel.

The FOCUS FTP Installation and Configuration panel opens. 

Information Builders      Installation and Configuration        Mainframe FOCUS
Command ===>                                                                 F1


 Please select one of the following options:


          1. Install and Configure
          2. Refresh Installation (Reinstall, Keep Configurations)



 Enter selection (Default=1) ===> 1
 Input source                ===> F                      (T)ape,(D)isk or (F)tp
 Installation Userid         ===> FOCUSER1               Logged on Userid


 Enter Job Card information                 Override JOB name checking ===> N
 ===> //FOCUSER1 JOB (PDSINSTL,USR),'J.USERNME',NOTIFY=FOCUSER1,REGION=4M_____
 ===> //*____________________________________________________________________
 ===> //*____________________________________________________________________
 Press Enter to continue, PF3 to END

Change the Input Source option to F (files will be downloaded using FTP), and press Enter.

Press Enter again to proceed to the next panel.

The New Installation FTP Download panel opens. 

Information Builders      Installation and Configuration        Mainframe FOCUS
Command ===>                                                                 FA
                                 New Installation

 Please enter the following information for Mainframe FOCUS

  Input FTP user information

   FTP Userid                ===>   FTPuserid@ibi.com

   FTP Password                ===>    FTPpassword

  Output Libraries

   Output Libraries HLQ      ===> NEW_HLQ

                        Unit ===> SYSDA       Volume ===>



   Installation JCL Library  ===> NEW_HLQ.CONF.DATA

 Press Enter to continue, PF3 to return to previous menu

Change the following input fields:

  • FTP Userid. Enter the user ID supplied in the email from Information Builders.
  • FTP Password. Enter the password supplied in the email from Information Builders.
  • Output Libraries HLQ. Enter NEW_HLQ.

    Note: You must make sure that the combination of your high-level qualifier and the FOCUS library names is less than or equal to 44 characters, the maximum name length supported on z/OS.

  • Unit. If SYSDA does not define a 3390 PDSE library, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDSE library.

When you are finished, press Enter.

Press Enter again to proceed to the next panel.

The FTP Confirmation panel opens:

Information Builders      Installation and Configuration        Mainframe FOCUS
Command ===>                                                                 FB
                                 New Installation

 Please confirm the following information for Mainframe FOCUS

  Input FTP user information
   FTP Userid                 ===>   FTPuserid@ibi.com

   FTP Password               ===>    FTPpassword

  Product Configuration parameters
   Output Libraries HLQ       ===> NEW_HLQ

                        Unit  ===> SYSDA       Volume ===>
  (Above will be used for all output libraries)


   Installation JCL Library   ===> NEW_HLQ.CONF.DATA
   Preview output allocations ===> N

 Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> s   (Enter N, C or S)
 Press Enter to continue, PF3 to return to previous menu

Confirm the options that you entered on previous panels.

When you have verified your choices, enter C to create the installation JCL in member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set.

Press Enter to execute this option.

Installing FOCUS Using the Disk Option

In this section:

This section describes how to install FOCUS using distribution files already on your system (Option D).

Note: Option D can only be used if you have previously downloaded the installation libraries to your system. For example, you may have downloaded the installation libraries according to the instructions in Download HOME.DATA Automatically and RECEIVE it to a PDS or Download the Installation Libraries Manually.

Option D enables you to create a new environment without having to download the FOCUS files again. For example, you may want to replicate a test environment under another high-level qualifier or replicate a production environment to move to another location.

Optionally, Specify Non-Standard Data Set Names

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.

Invoke ISETUP to Install FOCUS With the Disk Option

How to:

Now you can invoke the ISETUP procedure to create a new instance of FOCUS using your previously installed version of FOCUS.

Procedure: How to Invoke ISETUP to Install FOCUS With the Disk Option

Invoke ISETUP by executing the CLIST contained in member ISETUP of the installed_hlq.F.HOME.DATA data set, where installed_hlq is the high-level qualifier for the previously unloaded or downloaded version of HOME.DATA.

Note: You must use the version of ISETUP that you downloaded or unloaded with the FOCUS data sets from which you are creating the new instance. You cannot use an older version of ISETUP.

  1. You must execute this CLIST from the ISPF command shell (option 6):
    EXEC 'installed_hlq.F.HOME.DATA(ISETUP)'

    The ISETUP Main Menu opens: 

    Information Builders     Installation and Configuration    Mainframe FOCUS
Command ===>                                                              F0


Please select one of the following options:

         1. Mainframe FOCUS Installation

            . Install FOCUS into standard MVS libraries.



Enter selection (Default=1) ===> 1

Press Enter to continue, PF3 to END                         Version: 7703
  2. Choose Option 1 for the Core FOCUS installation, and press Enter to register this choice.

    Press Enter again to proceed to the next panel.

    The FOCUS Installation and Configuration panel opens. 

    Information Builders    Installation and Configuration     Mainframe FOCUS
 Command ===>                                                             F1


 Please select one of the following options:

          1. Install and Configure
          2. Refresh Installation (Reinstall, Keep Configurations)


 Enter selection (Default=1) ===> 1
 Input source                ===> T                   (T)ape,(D)isk or (F)tp
 Installation Userid         ===> USERID1              Logged on Userid


 Enter Job Card information               Override JOB name checking ===> N
 ===> // USERID1I JOB (PDSSERVE,PDS),NOTIFY=USERID1,REGION=4M_______________
 ===> //*___________________________________________________________________
 ===> //*___________________________________________________________________
 Press Enter to continue, PF3 to END
  3. Select Option 1 (Install and Configure, the default).

    The Input Source value and job card information will be filled in the options used in your previous install, and the Installation Userid field will contain your logon ID:

  4. Change the Input Source option to D (files reside on your system), and supply a valid JOB card.

    Note: Your JOB card must have a REGION parameter that specifies at least 4M. If you get messages similar to the following, the region size is not large enough to run ISETUP. In that case, change the REGION parameter to specify 0M and rerun ISETUP.

    Press Enter.

    Press Enter again to proceed to the next panel.

    The New Installation FOCUS Library Definitions panel opens.

    The input and output libraries will be the values used in your previous install: 

    Information Builders    Installation and Configuration     Mainframe FOCUS
Command ===>                                                              F6
                                New Installation

Please enter the following information for Mainframe FOCUS

  Input Libraries HLQ       ===> INSTALLED_HLQ


 Output Libraries (blank any field for default)

  Output Libraries HLQ      ===> NEW_HLQ

                       Unit ===> SYSDA       Volume ===>



  Installation JCL Library  ===>NEW_HLQ.CONF.DATA


Press Enter to continue, PF3 to return to previous menu
  5. Tab to the input fields and enter the high-level qualifier for the output libraries that will be created by ISETUP.

    You can change the following input fields:

    • Input Libraries HLQ. Enter the high-level qualifier of the installed FOCUS libraries.
    • Output Libraries HLQ. Enter the high-level qualifier for the additional set of FOCUS libraries.

      Note: You must make sure that the combination of your high-level qualifier and the FOCUS library names is less than or equal to 44 characters, the maximum name length supported on z/OS.

    • Unit. By default, the Unit value is SYSDA. SYSDA is defined by your systems programming group to be a type of DASD device. FOCUS must be installed into PDSE libraries on a 3390 device type. If the SYSDA definition at your site does not comply with these requirements, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDSE library.
    • Volume. This is an optional input value that can be used to place the new FOCUS libraries on a specific volume.

    When you are finished, press Enter.

    Press Enter again to proceed to the next panel.

    The New Installation FOCUS Library Confirmation panel opens: 

    Information Builders    Installation and Configuration     Mainframe FOCUS
Command ===>                                                              F9
                                New Installation

 Please confirm the following information for Mainframe FOCUS
  Input Media

   Input Libraries HLQ        ===> INSTALLED_HLQ


  Product Configuration parameters

   Output Libraries HLQ       ===> NEW_HLQ

                         Unit ===> SYSDA    Volume ===>
  (Above will be used for all output libraries)


   Installation JCL Library   ===> NEW_HLQ.CONF.DATA
   Preview output allocations ===> N

 Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> N (Enter N, C or S)
 Press Enter to process, PF3 to return to previous menu
  6. Confirm the options that you entered on previous panels.

    You can see what the installation process will allocate on your behalf by changing the Preview output allocations field from N to Y and pressing Enter.

    If you changed Preview output allocations to Y, the preview panels will display before ISETUP creates the installation JCL. While you examine the Preview panels, if you see one or more values you want to correct, press PF3 as many times as necessary to return to the panel that you want to modify.

    There may be several preview panels. You can navigate between them using the following keys:

    • To continue to the next preview panel, press PF8.
    • To return to the previous preview panel, press PF7.
    • To exit the preview panels and return to the Confirmation panel, press Enter or PF3.

    After you return from the preview panels to the Confirmation panel, the Preview output allocations field is reset to N.

    The following are sample preview panels:

    Information Builders      Installation and Configuration     Row 1 to 17 of 99
Command ===>                                                  SCROLL ===> PAGE

 Datasets to be allocated (Listed by functional area)

   Function    Action      DSN
   --------    ------      ---
   HOME        CREATE      NEW_HLQ.F.HOME.ETC
   HOME        CREATE      NEW_HLQ.F.HOME.ACX
   HOME        CREATE      NEW_HLQ.F.HOME.FEX
   HOME        CREATE      NEW_HLQ.F.HOME.MAS
   HOME        CREATE      NEW_HLQ.F.HOME.BIN
   HOME        CREATE      NEW_HLQ.F.HOME.ERR
   HOME        CREATE      NEW_HLQ.F.HOME.LOAD
   CONF        CREATE      NEW_HLQ.CONF.CFG
   CONF        CREATE      NEW_HLQ.CONF.ACX
   CONF        CREATE      NEW_HLQ.CONF.MAS
   CONF        CREATE      NEW_HLQ.CONF.PRF
   ALIAS       CREATE      NEW_HLQ.ADABAS.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.ADABAS.LOAD
   RELATED     -->         NEW_HLQ.F.HOME.LOAD
    Information Builders   Installation and Configuration    Row 18 to 34 of 99
Command ===>                                                SCROLL ===> PAGE
                                                                        DD
 Datasets to be allocated (Listed by functional area)

   Function    Action      DSN
   --------    ------      ---

   ALIAS       CREATE      NEW_HLQ.DATACOM.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.DATACOM.LOAD
   RELATED     -->         NEW_HLQ.F.HOME.LOAD

   ALIAS       CREATE      NEW_HLQ.ERRNLS.DATA
   RELATED     -->         NEW_HLQ.F.HOME.ERR

   ALIAS       CREATE      NEW_HLQ.ERRORS.DATA
   RELATED     -->         NEW_HLQ.CONF.CFG

   ALIAS       CREATE      NEW_HLQ.FOCCTL.DATA
   RELATED     -->         NEW_HLQ.F.HOME.DATA

   ALIAS       CREATE      NEW_HLQ.FOCDBC.DATA
  7. When you have verified your choices on the Confirmation panel, you must choose a continuation option:
    • The default option is N, which cancels the process and returns to the FOCUS Library Installation panel.
    • Option C creates the installation JCL and saves it to member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set. You can review, edit, update, or submit it manually without reinvoking ISETUP:
      ISETUP - Allocating file 'NEW_HLQ.CONF.DATA'
ISETUP - Creating installation options file ISOPTS1
ISETUP - Creating main JCL ISETUPJ1
ISETUP - JCL created in NEW_HLQ.CONF.DATA but not submitted
ISETUP - You can manually submit the following JCL to complete install
ISETUP - NEW_HLQ.CONF.DATA(ISETUPJ1)
***
    • Option S creates the installation JCL, saves it to member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set, and submits the job directly to the system for processing:
      ISETUP - Deleting file  'NEW_HLQ.CONF.DATA'
IDC0550I ENTRY (A) NEW_HLQ.CONF.DATA DELETED
ISETUP - Allocating file 'NEW_HLQ.CONF.DATA'
ISETUP - Creating installation options file ISOPTS1
ISETUP - Creating main JCL ISETUPJ1
ISETUP - Submitting JCL, use SDSF (or site standard) to monitor job
IKJ56250I JOB USERID1I(JOB28173) SUBMITTED
***

    To register your choice, press Enter.

    To execute the option you chose, press Enter again.

Example: Sample FOCUS Disk Installation

Execute the ISETUP CLIST from the ISPF command shell (option 6).

Assume your installed high-level qualifier is OLD_HLQ, your new installed libraries will be under the high-level qualifier NEW_HLQ, and your userid is FOCUSER1: 

EXEC 'OLD_HLQ.F.HOME.DATA(ISETUP)'

The ISETUP Main Menu opens:

Information Builders     Installation and Configuration     Mainframe FOCUS
Command ===>                                                               F0


Please select one of the following options:

         1. Mainframe FOCUS Installation

            . Install FOCUS into standard MVS libraries.



Enter selection (Default=1) ===> 1

Press Enter to continue, PF3 to END                           Version: 7703

Choose Option 1 for the Core FOCUS installation, and press Enter to register this choice.

Press Enter again to proceed to the next panel.

The FOCUS Library Installation panel opens. 

Information Builders    Installation and Configuration      Mainframe FOCUS
Command ===> 1                                                             F1


Please select one of the following options:

         1. Install and Configure
         2. Refresh Installation (Reinstall, Keep Configurations)



Enter selection (Default=1) ===> 1
Input source                ===> D                   (T)ape,(D)isk or (F)tp
Installation Userid         ===> FOCUSER1            Logged on Userid


Enter Job Card information                 Override JOB name checking ===> N
===> // FOCUSER1I JOB (PDSSERVE,PDS),NOTIFY=FOCUSER1,REGION=4M______________
===> //*____________________________________________________________________
===> //*____________________________________________________________________
Press Enter to continue, PF3 to END

Change the Input Source option to D (files exist on your system), and press Enter.

Press Enter again to proceed to the next panel.

The FOCUS Library Definitions panel opens.

Change the following input fields:

  • Input Libraries HLQ. Enter OLD_HLQ.
  • Output Libraries HLQ. Enter NEW_HLQ.
  • Unit. If SYSDA does not define a 3390 PDSE library, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDSE library. 
Information Builders    Installation and Configuration      Mainframe FOCUS
Command ===> 1                                                             F6
                                New Installation

Please enter the following information for Mainframe FOCUS

  Input Libraries HLQ       ===> OLD_HLQ



 Output Libraries (blank any field for default)

  Output Libraries HLQ      ===> NEW_HLQ

                       Unit ===> SYSDA       Volume ===>



  Installation JCL Library  ===> NEW_HLQ.CONF.DATA

Press Enter to continue, PF3 to return to previous menu

When you are finished, press Enter.

Press Enter again to proceed to the next panel.

The New Installation FOCUS Library Confirmation panel opens: 

Information Builders    Installation and Configuration      Mainframe FOCUS
Command ===> 1                                                             F9
                               New Installation

Please confirm the following information for Mainframe FOCUS
 Input Media

  Input Libraries HLQ        ===> OLD_HLQ


 Product Configuration parameters

  Output Libraries HLQ       ===> NEW_HLQ

                        Unit ===> SYSDA    Volume ===>
 (Above will be used for all output libraries)


  Installation JCL Library   ===> NEW_HLQ.CONF.DATA
  Preview output allocations ===> N

Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> N (Enter N, C or S)
Press Enter to process, PF3 to return to previous menu

Confirm the options that you entered on previous panels.

When you have verified your choices, enter C to create the installation JCL in member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set.

Press Enter to execute this option.

 Information Builders