In this section: |
ISETUP provides three ways to refresh FOCUS:
A refresh updates the FOCUS libraries under the same high-level qualifier with which they were previously installed. Therefore, you must use the same high-level qualifier used when FOCUS was installed. If you change the FOCUS high-level qualifier on any of the ISETUP refresh panels, the data sets will not be updated.
Note: Make a backup of the FOCUS libraries prior to refreshing FOCUS. If you customized any FOCUS members (such as FOCPARM in the ERRNLS.DATA library) and want to preserve those customizations in the refreshed version of FOCUS, copy the affected members to the CONF.DATA library and then copy them back to their original libraries after the refresh.
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 F.HOME.DATA. This library and all other FOCUS libraries should be installed using the same high-level qualifier.
The following sections describe all of the refresh options. Each option builds and, optionally, executes the JCL needed to refresh 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.
In this section: |
This section describes how to refresh FOCUS by downloading the distribution files from an Information Builders FTP site.
Prior to executing this step, you must know the FTP site, user ID, password, and directory path to the refresh folder. Information Builders will send you an email with this information when you order the install or refresh.
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.
FTP ftpsitename
where:
Is the name of the FTP site provided to you by Information Builders in the download instructions email.
EZA1459I NAME (ftpsiteuserid):
EZA1701I >>> USER
where:
Is the user ID provided to you by Information Builders in the download instructions email.
Note:
The FTPSITE user ID will expire in 7 days.
The FTPSITE user ID is case-sensitive.
331 Password required for userid.
EZA1789I PASSWORD:
where:
Is the password provided to you by Information Builders in the download instructions email.
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:
CD /ftpsite_path_to_download_folder
BINARY
where:
Is the path to the download folder provided to you by Information Builders in the download instructions email.
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:
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:
GET HOME.DATA 'installed_hlq.HOME.DATA.RECV'
The high-level qualifier, installed_hlq, must be the same high-level qualifier under which FOCUS was previously installed.
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:
QUIT
The HOME.DATA.RECV file is on your system in compressed format. You must issue the RECEIVE command to convert it to a PDS.
RECEIVE INDATASET('installed_hlq.HOME.DATA.RECV')
where:
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' +
SPACE(10 1) CYLS DSNAME('installed_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.
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.
Now that the F.HOME.DATA data set resides on your system, you can run the ISETUP procedure to refresh FOCUS.
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 '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
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
The Input Source value will be filled in with default options. The Installation Userid field will contain your logon ID.
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 Refresh Binary FTP Download panel opens.
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FN Refresh Binary Please enter the following information for Mainframe FOCUS FTP download destination and user information Current installation HLQ (HOME) ===> INSTALLED_HLQ FTP Userid ===> ftpuserid@ibi.com FTP Password ===> ftppass Press Enter to continue, PF3 to return to previous menu
You can change the following input fields:
When you are finished, press Enter.
Press Enter again to proceed to the next panel.
The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
The Refresh Binary FTP Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FM Refresh Binary Please enter the following information for Mainframe FOCUS Using the following existing information HLQ of installation files ===> INSTALLED_HLQ Output Libraries Output Libraries Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_HLQ.CONF.DATA Preview output allocations ===> N (Y or N) Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL ===> N (Enter N, C or S) Press Enter to continue, PF3 to return to previous menu
Confirm the options that you entered on previous panels.
You can see what the refresh 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 refresh 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:
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 INSTALLED_HLQ.F.HOME.ETC HOME CREATE INSTALLED_HLQ.F.HOME.ACX HOME CREATE INSTALLED_HLQ.F.HOME.FEX HOME CREATE INSTALLED_HLQ.F.HOME.MAS HOME CREATE INSTALLED_HLQ.F.HOME.BIN HOME CREATE INSTALLED_HLQ.F.HOME.ERR HOME CREATE INSTALLED_HLQ.F.HOME.LOAD CONF CREATE INSTALLED_HLQ.CONF.CFG CONF CREATE INSTALLED_HLQ.CONF.ACX CONF CREATE INSTALLED_HLQ.CONF.MAS CONF CREATE INSTALLED_HLQ.CONF.PRF ALIAS CREATE INSTALLED_HLQ.ADABAS.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.ADABAS.LOAD RELATED --> INSTALLED_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 INSTALLED_HLQ.DATACOM.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.DATACOM.LOAD RELATED --> INSTALLED_HLQ.F.HOME.LOAD ALIAS CREATE INSTALLED_HLQ.ERRNLS.DATA RELATED --> INSTALLED_HLQ.F.HOME.ERR ALIAS CREATE INSTALLED_HLQ.ERRORS.DATA RELATED --> INSTALLED_HLQ.CONF.CFG ALIAS CREATE INSTALLED_HLQ.FOCCTL.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.FOCDBC.DATA
. . . ISETUP - Creating installation options file ISOPTS2 ISETUP - Creating main JCL ISETUPJ2 ISETUP - Submitting JCL, use SDSF (or site standard) to monitor job IKJ56250I JOB USERID1I(JOB17749) SUBMITTED ***
To register your choice, press Enter.
To execute the option you chose, press Enter again.
Execute the ISETUP CLIST from the ISPF command shell (option 6).
Assume your previously installed libraries are under the high-level qualifier INSTALLED_HLQ.F (where FOCUS was previously installed), that you downloaded the HOME.DATA library under this same high-level qualifier, and that your userid is FOCUSER1:
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
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) ===> 2 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 Enter Selection option to 2 (Refresh installation).
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 Refresh Binary FTP Download panel opens.
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FN Refresh Binary Please enter the following information for Mainframe FOCUS FTP download destination and user information Current installation HLQ (HOME) ===> INSTALLED_HLQ FTP Userid ===> FTPuserid@ibi.com FTP Password ===> FTPpassword Press Enter to continue, PF3 to return to previous menu
Change the following input fields:
When you are finished, press Enter.
Press Enter again to proceed to the next panel.
The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
The Refresh Binary FTP Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FM Refresh Binary Please enter the following information for Mainframe FOCUS Using the following existing information HLQ of installation files ===> INSTALLED_HLQ Output Libraries Output Libraries Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_HLQ.CONF.DATA Preview output allocations ===> N (Y or N) Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL ===> N (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 INSTALLED_HLQ.CONF.DATA data set.
Press Enter to execute this option.
In this section: |
This section describes how to refresh FOCUS by unloading the distribution files from a cartridge.
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.
Use the following JCL as a model for unloading the first data set (HOME.DATA) from the distribution cartridge. The new data set will have a high-level qualifier of your choice followed by another qualifier consistent 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=installed_hlq.F.HOME.DATA, // SPACE=(CYL,(10,1,15)),UNIT=SYSDA, // DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=27920) //SYSIN DD DUMMY //
where:
Is the high-level qualifier under which FOCUS was previously installed.
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.
Is a valid unit for the distribution cartridge.
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.
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.
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.
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 unloaded version of F.HOME.DATA and under which the FOCUS data sets were previously installed. You must execute this CLIST from the ISPF command shell (option 6).
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.
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
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) ===> 2 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 ===> // USERID1 JOB (PDSSERVE,PDS),NOTIFY=USERID1,REGION=4M__________________ ===> //*____________________________________________________________________ ===> //*____________________________________________________________________ Press Enter to continue, PF3 to END
The Input Source value and job card information will be filled in with default options, and the Installation Userid field will contain your logon ID.
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 Refresh Binary FOCUS Configuration Parameters panel opens. It displays the high-level qualifier for your previously installed version of FOCUS:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FG Refresh Binary Please enter the following information for Mainframe FOCUS Product Configuration Parameters Current installation HLQ (HOME) ===> INSTALLED_HLQ Press Enter to continue, PF3 to return to previous menu
The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
The Refresh Binary Tape Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FK Refresh Binary Please enter the following information for Mainframe FOCUS Input Media (Blank any field for default) Volume serial number ===> C99923 Unit type ===> 3590 Work unit type ===> SYSDA Output Libraries Output Libraries HLQ ===> INSTALLED_HLQ Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_HLQ.CONF.DATA Preview output allocations ===> N (Y or N) Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL ===> N (Enter N, C or S) Press Enter to continue, PF3 to return to previous menu
Verify the Volume serial number and unit type. The VOLSER of the tape contains the FOCUS release and gen numbers. ISETUP verifies that this is the appropriate refresh tape for your installed gen of FOCUS:
You can see what the refresh 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:
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 INSTALLED_HLQ.F.HOME.ETC HOME CREATE INSTALLED_HLQ.F.HOME.ACX HOME CREATE INSTALLED_HLQ.F.HOME.FEX HOME CREATE INSTALLED_HLQ.F.HOME.MAS HOME CREATE INSTALLED_HLQ.F.HOME.BIN HOME CREATE INSTALLED_HLQ.F.HOME.ERR HOME CREATE INSTALLED_HLQ.F.HOME.LOAD CONF CREATE INSTALLED_HLQ.CONF.CFG CONF CREATE INSTALLED_HLQ.CONF.ACX CONF CREATE INSTALLED_HLQ.CONF.MAS CONF CREATE INSTALLED_HLQ.CONF.PRF ALIAS CREATE INSTALLED_HLQ.ADABAS.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.ADABAS.LOAD RELATED --> INSTALLED_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 INSTALLED_HLQ.DATACOM.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.DATACOM.LOAD RELATED --> INSTALLED_HLQ.F.HOME.LOAD ALIAS CREATE INSTALLED_HLQ.ERRNLS.DATA RELATED --> INSTALLED_HLQ.F.HOME.ERR ALIAS CREATE INSTALLED_HLQ.ERRORS.DATA RELATED --> INSTALLED_HLQ.CONF.CFG ALIAS CREATE INSTALLED_HLQ.FOCCTL.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.FOCDBC.DATA
. . . ISETUP - Creating installation options file ISOPTS2 ISETUP - Creating main JCL ISETUPJ2 ISETUP - Submitting JCL, use SDSF (or site standard) to monitor job IKJ56250I JOB USERID1I(JOB18826) SUBMITTED ***
To register your choice, press Enter.
To execute the option you chose, press Enter again.
Assume you unloaded the HOME.DATA data set under high-level qualifier INSTALLED_HLQ.F.
Issue the following command 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
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 Enter selection option to 2 (Refresh installation).
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 Refresh Binary FOCUS Configuration Parameters panel opens.
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FG Refresh Binary Please enter the following information for Mainframe FOCUS Product Configuration Parameters Current installation HLQ (HOME) ===> INSTALLED_HLQ Press Enter to continue, PF3 to return to previous menu
Press Enter to continue.
The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
The Refresh Binary Tape Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FK Refresh Binary Please enter the following information for Mainframe FOCUS Input Media (Blank any field for default) Volume serial number ===> C99923 Unit type ===> 3590 Work unit type ===> SYSDA Output Libraries Output Libraries HLQ ===> INSTALLED_HLQ Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_HLQ.CONF.DATA Preview output allocations ===> N (Y or N) Continue ? (N)o, (C)reate JCL only, (S)ubmit JCL ===> N (Enter N, C or S) Press Enter to continue, PF3 to return to previous menu
When you have verified the information, enter C to create the installation JCL in member ISETUPJ1 in the INSTALLED_HLQ.CONF.DATA data set.
Press Enter to execute this option.
In this section: |
This section describes how to refresh FOCUS using distribution files already on your system (Option D).
Note: Option D can only be used if you have previously downloaded or unloaded HOME.DATA and run an install or refresh so that all of the FOCUS libraries already reside on your system. This option is used for installing additional copies of the previously environment.
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.
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.
Now you can invoke the ISETUP procedure to refresh FOCUS using your previously installed version of FOCUS.
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 installed version of FOCUS.
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.
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
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
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.
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 Refresh Binary FOCUS Configuration Parameters panel opens.
The Current installation HLQ will be the high-level qualifier used in your previous install or refresh:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FG Refresh Binary Please enter the following information for Mainframe FOCUS Product Configuration Parameters Current installation HLQ (HOME) ===> INSTALLED_HLQ Press Enter to continue, PF3 to return to previous menu
The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
The Refresh Binary Disk Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FM Refresh Binary Please enter the following information for Mainframe FOCUS Using the following existing information HLQ for downloaded files ===> INSTALLED_HLQ Output Libraries Output Libraries Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_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 continue, PF3 to return to previous menu
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:
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 INSTALLED_HLQ.F.HOME.ETC HOME CREATE INSTALLED_HLQ.F.HOME.ACX HOME CREATE INSTALLED_HLQ.F.HOME.FEX HOME CREATE INSTALLED_HLQ.F.HOME.MAS HOME CREATE INSTALLED_HLQ.F.HOME.BIN HOME CREATE INSTALLED_HLQ.F.HOME.ERR HOME CREATE INSTALLED_HLQ.F.HOME.LOAD CONF CREATE INSTALLED_HLQ.CONF.CFG CONF CREATE INSTALLED_HLQ.CONF.ACX CONF CREATE INSTALLED_HLQ.CONF.MAS CONF CREATE INSTALLED_HLQ.CONF.PRF ALIAS CREATE INSTALLED_HLQ.ADABAS.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.ADABAS.LOAD RELATED --> INSTALLED_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 INSTALLED_HLQ.DATACOM.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.DATACOM.LOAD RELATED --> INSTALLED_HLQ.F.HOME.LOAD ALIAS CREATE INSTALLED_HLQ.ERRNLS.DATA RELATED --> INSTALLED_HLQ.F.HOME.ERR ALIAS CREATE INSTALLED_HLQ.ERRORS.DATA RELATED --> INSTALLED_HLQ.CONF.CFG ALIAS CREATE INSTALLED_HLQ.FOCCTL.DATA RELATED --> INSTALLED_HLQ.F.HOME.DATA ALIAS CREATE INSTALLED_HLQ.FOCDBC.DATA
. . . 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) ***
ISETUP - Creating main JCL ISETUPJ ISETUP - Submitting JCL, use SDSF (or site standard) to monitor job IKJ56250I JOB USERID1I(JOB16257) SUBMITTED ***
To register your choice, press Enter.
To execute the option you chose, press Enter again.
Execute the ISETUP CLIST from the ISPF command shell (option 6).
Assume your installed high-level qualifier is INSTALLED_HLQ and your userid is FOCUSER1:
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
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 ===> 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 Enter Selection option to 2 (Refresh installation).
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 Refresh Binary FOCUS Configuration Parameters panel opens.
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FG Refresh Binary Please enter the following information for Mainframe FOCUS Product Configuration Parameters Current installation HLQ (HOME) ===> INSTALLED_HLQ Press Enter to continue, PF3 to return to previous menu
Press Enter. The following warning message displays:
Information - You are about to refresh the server release 7703 gen 557 with release 7703 gen 558 Press enter to continue.
Press Enter to confirm that you want to continue with the Refresh. The Refresh Binary Disk Confirmation panel opens:
Information Builders Installation and Configuration Mainframe FOCUS Command ===> FM Refresh Binary Please enter the following information for Mainframe FOCUS Using the following existing information HLQ for downloaded files ===> INSTALLED_HLQ Output Libraries Output Libraries Unit ===> 3390 Volume ===> Installation JCL Library ===> INSTALLED_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 continue, PF3 to return to previous menu
Enter C to create the installation JCL in member ISETUPJ1 in the NEW_HLQ.CONF.DATA data set.
When you are finished, press Enter.
Press Enter to execute this option.
Information Builders |