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 or unload 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.7703, ISETUP will create a data set called FOCUS.7703.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 or refresh. 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.


Top of page

x
ISETUP Processing Flow

After you unload or 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.


Top of page

x
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.



x
Download HOME.DATA Automatically and RECEIVE it to a PDS

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:



x
Downloading and Receiving HOME.DATA in a Batch Job

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.



x
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_1_9_and_up_zSeries_32on64bit/7703M/Prod_703           
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')
//*
/*


x
Downloading and Receiving HOME.DATA Interactively

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



x
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 or refreshed 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


x
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) CYLS 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.



x
Download the Installation Libraries Manually

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 77.03 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.



x
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.


x
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


x
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,(127,10))
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))


x
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


x
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.



x
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.



x
Invoke ISETUP to Install FOCUS With the FTP Option

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.



x
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. 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 PDS 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 PDS 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 PDS library, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDS 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.


Top of page

x
Installing FOCUS Using the Tape Option

In this section:

This section describes how to install FOCUS by unloading the distribution files from a cartridge.



x
Unload HOME.DATA From the Distribution Cartridge

Use the following JCL as a model for unloading the first data set (HOME.DATA) from the distribution cartridge The downloaded data set will have the same low level qualifiers and a new high-level qualifier of your choice followed by another qualifier consisting of the letter F.

//job card goes here
//* unload HOME.DATA from first file on the volume 1 cartridge
//ISETUNLD EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//SYSUT1   DD DISP=OLD,DSN=HOME.DATA,
//            UNIT=unit,LABEL=(1,SL),VOL=SER=volser 
//SYSUT2   DD DISP=(NEW,CATLG),DSN=new_hlq.F.HOME.DATA,
//            SPACE=(CYL,(10,1,15)),UNIT=SYSDA,
//            DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=27920)
//SYSIN    DD DUMMY
//

where:

new_hlq

Is the high-level qualifier that will be used for the new FOCUS data sets created by ISETUP.

volser

Is the volume serial number of the distribution cartridge. This value can be found on the label affixed to the front of the distribution cartridge.

unit

Is a valid unit for the distribution cartridge. As of January 1, 2015, 3590 is the only supported tape media type.



x
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.



x
Invoke ISETUP to Install FOCUS With the Tape Option

If you unloaded ISETUP from a cartridge, prior to executing ISETUP request that the distribution cartridge be given SYSTEM MOUNTED status by your operations staff.



x
Procedure: How to Invoke ISETUP to Install FOCUS With the Tape Option

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 unloaded version of F.HOME.DATA and the new FOCUS data sets it will create. You must execute this CLIST from the ISPF command shell (option 6).

Note: You must use the version of ISETUP that you just unloaded with the new FOCUS data sets. You cannot use an older version of ISETUP from an ISETUP library from an older release or gen.

  1. Issue the following command to execute ISETUP:
    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                ===> 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 will be filled in with default options. The Installation Userid field will contain your logon ID.

  4. Change the Input Source option to T (files will be unloaded from the distribution cartridge), 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 Tape Definitions panel opens.

    Information Builders      Installation and Configuration        Mainframe FOCUS
    Command ===>                                                                 F2
                                    New Installation                               
                                                                                   
    Please enter the following information for Mainframe FOCUS                     
                                                                                   
    (blank any field for default)                                                  
                                                                                   
     Input Media                                                                   
                                                                                   
      Volume serial number      ===> Txxxxx      Unit type ===> 3590               
      Work unit type            ===> SYSDA                                         
                                                                                   
     Output Libraries                                                              
      Output Libraries HLQ      ===> NEW_HLQ                                
                           Unit ===> 3390        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 cartridge parameters and a high-level qualifier for the output libraries that will be created by ISETUP.

    You can change the following input fields:

    • Volume serial number. Enter the volume serial number for the distribution cartridge.
    • Unit type. Enter the media type of the distribution cartridge.
    • Work unit type. Enter the unit type on which the distribution cartridge is mounted.
    • Output Libraries HLQ. Enter the high-level qualifier for the new 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 PDS 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 PDS 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 Tape Confirmation panel opens:

    Information Builders      Installation and Configuration        Mainframe FOCUS
     Command ===>                                                                 F5
                                    New Installation                                
                                                                                    
     Please confirm the following information for Mainframe FOCUS                   
      Input Media                                                                   
                                                                                    
       Volume serial number       ===> Txxxxx   Unit type ===> 3590                 
       Work unit type             ===> SYSDA                                        
                                                                                    
      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         Y or N                             
                                                                                    
     Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> s   (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 Tape Installation

Assume you unloaded the HOME.DATA data set under high-level qualifier NEW_HLQ.

Issue the following command 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   

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          

Change the Input Source option to T (files will be unloaded from the distribution cartridge), and supply a valid JOB card.

Press Enter.

Press Enter again to proceed to the next panel.

The FOCUS Tape Definitions panel opens.

Tab to the input fields and enter the following parameters:

  • Volume serial number. Enter the volume serial number for the distribution cartridge, T7703B.
  • Unit type. Enter the media type of the distribution cartridge, 3590. As of January 1, 2015, this is the only supported tape media type.
  • Work unit type. Enter the unit type on which the distribution cartridge is mounted, SYSDA.
  • Output Libraries HLQ. Enter the high-level qualifier for the new FOCUS libraries 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. 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 PDS 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 PDS library.
Information Builders      Installation and Configuration        Mainframe FOCUS
Command ===>                                                                 F2
                                New Installation                               
                                                                               
Please enter the following information for Mainframe FOCUS                     
                                                                               
(blank any field for default)                                                  
                                                                               
 Input Media                                                                   
                                                                               
  Volume serial number      ===> T7703B      Unit type ===> 3590               
  Work unit type            ===> SYSDA                                         
                                                                               
 Output Libraries                                                              
  Output Libraries HLQ      ===> NEW_HLQ                                
                       Unit ===> 3390        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 Tape Confirmation panel opens:

Information Builders      Installation and Configuration        Mainframe FOCUS
 Command ===>                                                                 F5
                                New Installation                                
                                                                                
 Please confirm the following information for Mainframe FOCUS                   
  Input Media                                                                   
                                                                                
   Volume serial number       ===> Txxxxx   Unit type ===> 3590                 
   Work unit type             ===> SYSDA                                        
                                                                                
  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         Y or N                             
                                                                                
 Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL  ===> s   (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.


Top of page

x
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 or unloaded 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 or unload 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.



x
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.



x
Invoke ISETUP to Install FOCUS With the Disk Option

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



x
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 or refresh, 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 or refresh:

    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 PDS 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 PDS 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 PDS library, change the Unit value to an appropriate DASD subpool name that defines a 3390 PDS 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