Using ISETUP

The following steps build and execute the JCL needed to upgrade or refresh your current production version of FOCUS.

The person running ISETUP must have write privileges to the production FOCUS libraries for verification purposes. No current data is changed by the procedure.

Unload or Download ISETUP.DATA

In this section:

The first step is to unload or download the ISETUP.DATA file. If you are:

Unloading the files from a cartridge, see Unload ISETUP.DATA From the Distribution Cartridge.
Downloading the files from an FTP site, see Download ISETUP.DATA.BIN or ISETUP.DATA.INTL.BIN and RECEIVE it to a PDS.

Top of page

Unload ISETUP.DATA From the Distribution Cartridge

If you are downloading the files from an Information Builders FTP site, not unloading them from a distribution tape, skip this step and continue with Download ISETUP.DATA.BIN or ISETUP.DATA.INTL.BIN and RECEIVE it to a PDS.

Use the following JCL as a model for unloading the first data set (ISETUP.DATA) from the distribution cartridge.

//job card goes here
//* unload isetup data from first file on the volume 1 cartridge
//ISETUNLD EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//SYSUT1   DD DISP=OLD,DSN=ISETUP.DATA,
//            UNIT=unit,LABEL=(1,SL),VOL=SER=volser 
//SYSUT2   DD DISP=(NEW,CATLG),DSN=newhlq.ISETUP.DATA,
//            SPACE=(TRK,(180,5,44)),UNIT=SYSALLDA,
//            DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=1600)
//SYSIN    DD DUMMY
//

where:

newhlq: Must be 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, if you received a single cartridge. If you received multiple cartridges, it is the volume serial number of the first 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.

Continue with Specify Non-Standard Data Set Names.

Top of page

Download ISETUP.DATA.BIN or ISETUP.DATA.INTL.BIN and RECEIVE it to a PDS

If you are unloading the files from a cartridge, you should have followed the instructions in Unload or Download ISETUP.DATA. Skip this step, and continue with Specify Non-Standard Data Set Names.

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

There are separate domestic and international download sites for ISETUP. If you are downloading from:

The domestic download site, you must download the file named ISETUP.DATA.BIN.
The international download site, you must download the file named ISETUP.DATA.INTL.BIN.

Top of page

Procedure: How to FTP the ISETUP.DATA.BIN or ISETUP.DATA.INTL.BIN File to Your System

Issue the following command from the ISPF Command Shell (option 6) to FTP the ISETUP.DATA file:
```
FTP ftpsitename 
```
where:
ftpsitename
Is the name of the FTP site provided to you by Information Builders in the download instructions email.
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 email.
Note:
The FTPSITE user ID will expire in 7 days.
The FTPSITE user ID is case sensitive.
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 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:          
```
Change directories to the folder that contains the service pack or upgrade and establish binary mode transfer:
```
CD /ftpsite_path_to_service_pack_folder 
BINARY
```
where:
ftpsite_path_to_service_pack_folder
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:   
```
Set the space and DCB parameters for the ISETUP.DATA flat file to be transferred:
```
LOCSITE RECFM=FB LRECL=80 BLKSIZE=1600 PRIMARY=150 SECONDARY=15 TRACKS
```
The following message indicates that FTP is waiting for another command:
```
EZA1460I Command:
```

Transfer ISETUP.DATA.BIN (from the domestic download site) or ISETUP.DATA.INTL.BIN (from the international download site) to your system as a flat file:

GET ISETUP.DATA.BIN 'newhlq.ISETUP.DATA.RECV'

GET ISETUP.DATA.INTL.BIN 'newhlq.ISETUP.DATA.RECV'

The high level qualifier, newhlq, is the high level qualifier under which ISETUP will create the upgraded or refreshed version of FOCUS.

The following messages indicate that the transfer was successful:

150 Opening BINARY mode data connection for ISETUP.DATA.BIN(1991120 
bytes).    
226 Transfer complete.
EZA1617I 1991120 bytes transferred in 0.440 seconds.  Transfer rate 
4525.27 Kbytes/sec.
EZA1460I Command:

Exit the FTP session:
```
QUIT
```

Top of page

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

The ISETUP.DATA.RECV file is on your system as a flat file in TSO RECEIVE format. You must issue the RECEIVE command to convert it to a PDS.

Issue the following command from the ISPF Command Shell (option 6) to RECEIVE the ISETUP.DATA.RECV file:
```
RECEIVE INDATASET('newhlq.ISETUP.DATA.RECV')
```
where:
'newhlq.ISETUP.DATA.RECV'
Is the file you transferred to your system in How to FTP the ISETUP.DATA.BIN or ISETUP.DATA.INTL.BIN File to Your System.
The following messages display indicating the data set name of the PDS that is being created from the flat file:
```
INMR901I Dataset userid.DDNAME.XMITIN from userid on lpar  
INMR906A Enter restore parameters or 'DELETE' or 'END' + 
```
Enter the following space parameters:
```
SPACE(150 15) TRACKS DSNAME('newhlq.ISETUP.DATA')
```
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.

Specify Non-Standard Data Set Names

ISETUP asks you for the high level qualifier for your current production version of FOCUS. Based on this qualifier and a list of all of the standard data set names (low level qualifiers), ISETUP determines which features to process. The list of low level qualifiers ISETUP uses is in member FOCSNAME in the ISETUP.DATA data set:

If you use non-standard low level qualifiers for your FOCUS data sets, you must edit this file. Once you have done this, ISETUP will use these qualifiers for future installs or maintenance refresh procedures as well as the current one.
If you use multiple prefixes for your FOCUS data sets, you can edit this file to specify the correct data set names.

Important: The FOCSNAME file changed as of FOCUS 7.2.10 and 7.3.4. You must use the new version of FOCSNAME provided on the current distribution tape, not the version from a previous service pack. You can verify that you are using the current version of FOCSNAME by checking for the following comment lines in its header:

//* ===================================================================  
//* FOCSNAME                                                          *  
//*                                                                   *  
//* Purpose: To Allow the customizing of product dataset names.       *  
//*                                                                   *  
//* ===================================================================  
//* DO NOT CHANGE THE FOLLOWING ENTRIES, WHICH ARE USED BY ISETUP        
//*                                                                      
// SET ISETVOL1=T00000                       Input volume 1              
// SET ISETVOL2=U00000                       Input volume 2              
//*                                                                      
// SET ISETPRD=WIBFOC.PROD                   Production HLQ              
// SET ISETNEW=WIBFOC.TEST                   New HLQ                     
// SET ISETRCV=WIBFOC.RECV                   FTP HLQ                     
//*                                                                      
//* DO NOT CHANGE THE PRECEDING ENTRIES, WHICH ARE USED BY ISETUP        
//* ===================================================================

If you use only the standard FOCUS data set names, you do not have to perform this step. Proceed to Invoke ISETUP.

Note: FOCUS still uses DSNTAB for non-standard data set names; only ISETUP uses FOCSNAME. Therefore, if you use customized data set names, you must make the changes in both DSNTAB and FOCSNAME the first time you execute ISETUP.

To edit FOCSNAME, open member FOCSNAME in the ISETUP.DATA data set and follow the instructions entered as comments at the top of the file.

The following is a partial listing of the FOCSNAME member:

//* =================================================================== 
//* FOCSNAME                                                          * 
//*                                                                   * 
//* Purpose: To Allow the customizing of product dataset names.       * 
//*                                                                   * 
//* =================================================================== 
//* DO NOT CHANGE THE FOLLOWING ENTRIES, WHICH ARE USED BY ISETUP       
//*                                                                     
// SET ISETVOL1=T00000                       Input volume 1             
// SET ISETVOL2=U00000                       Input volume 2             
//*                                                                     
// SET ISETPRD=WIBFOC.PROD                   Production HLQ             
// SET ISETNEW=WIBFOC.TEST                   New HLQ                    
// SET ISETRCV=WIBFOC.RECV                   FTP HLQ                    
//*                                                                     
//* DO NOT CHANGE THE PRECEDING ENTRIES, WHICH ARE USED BY ISETUP       
//* =================================================================== 
//*                                                                     
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
//*                                                                   *
//* The set variable symbols below are used to specify the dataset    *
//* names of all the product files used by ISETUP.                    *
//*                                                                   *
//* The variable symbols begin with P for production, N for new,      *
//* or R for FTP receive files.  The remainder of the symbol must     *
//* match the ISETPARM and IDATADEF tag values in ISETUP.             *
//*                                                                   *
//* DO NOT change set variable symbols on the left of the equal sign. *
//*                                                                   *

//* DO NOT change the &ISETPRD, &ISETNEW, or &ISETRCV prefix variable *
//*        symbol of the dataset names unless a dataset cannot be     *
//*        specified using the prefix values entered on the ISETUP    *
//*        panel.  Not changing this prefix allows the customization  *
//*        data here to be reused with future product upgrades or     *
//*        refreshes without having to change this file each time.    *
//*                                                                   *
//* Change the remainder of the dataset names after the prefix        *
//* variable symbol only if your site cannot support using the        *
//* standardized product dataset names documented for the product     *
//* and already entered below.  Note that the double period is needed *
//* to allow a single period to be appended to the symbol value so    *
//* the dataset name is valid after variable substitution.            *
//*                                                                   *
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//*

// SET PADABASD=&ISETPRD..ADABAS.DATA        Prod ADABAS               
// SET NADABASD=&ISETNEW..ADABAS.DATA        New ADABAS                
// SET RADABASD=&ISETRCV..ADABAS.DATA        FTP ADABAS                
// SET PADABASL=&ISETPRD..ADABAS.LOAD        Prod ADABAS               
// SET NADABASL=&ISETNEW..ADABAS.LOAD        New ADABAS                
// SET RADABASL=&ISETRCV..ADABAS.LOAD        FTP ADABAS                
// SET PADMCFOR=&ISETPRD..ADMCFORM           Prod                      
// SET NADMCFOR=&ISETNEW..ADMCFORM           New                       
// SET RADMCFOR=&ISETRCV..ADMCFORM           FTP                       
// SET PCONFIGD=&ISETPRD..CONFIG.DATA        Prod installation

As described, where necessary overwrite each standard name with your non-standard name.

For example, if you use the name INSTALL.DATA for your production installation library, change the following line:

// SET PCONFIGD=&ISETPRD..CONFIG.DATA        Prod installation

It should now say:

// SET PCONFIGD=&ISETPRD..INSTALL.DATA       Prod installation

Invoke ISETUP

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.

Invoke ISETUP by executing the CLIST contained in member ISETUP of the newhlq.ISETUP.DATA data set, where newhlq is the high level qualifier for the unloaded or downloaded version of ISETUP.DATA and the new FOCUS data sets it will create. You must execute this CLIST from the ISPF command shell (option 6).

Issue the following command to execute ISETUP if you unloaded ISETUP from a cartridge:

EXEC 'newhlq.ISETUP.DATA(ISETUP)' ['procoption [carttype]']

Issue the following command to execute ISETUP if you downloaded it from an FTP site:

EXEC 'newhlq.ISETUP.DATA(ISETUP)' ['procoption FTP']

where:

newhlq

Is the prefix to which you unloaded or downloaded the ISETUP.DATA data set.

procoption

Specifies the type of processing ISETUP will perform. Valid values follow:

REFRESH specifies maintenance refresh processing. REFRESH is the default processing option that will be performed if you omit the processing option from the command. Use this option to apply a service pack to an existing version of FOCUS.

UPGRADE specifies upgrade processing. Use this option to upgrade to a new version of FOCUS.

carttype

Specifies the type of cartridge that is mounted. Acceptable values for carttype are 3480 3490, or 3590. The default is 3490; for example the following syntax is valid if you want to perform a maintenance refresh using 3490 media:

EXEC 'newhlq.ISETUP.DATA(ISETUP)'

FTP: Specifies that the files will not be loaded from a tape but transferred using FTP/RECEIVE.

If you requested 3480 or 3590 media, you must specify the cartridge type in the command. For example, issue the following command from the ISPF command shell to perform a maintenance refresh using a 3480 cartridge:

Menu List Mode Functions Utilities Help ___________________________________________________________________ ISPF Command Shell Enter TSO or Workstation commands below: ===> EXEC 'newhlq.ISETUP.DATA(ISETUP)' 'REFRESH 3480'

--------------- Information Builders FOCUS UPGRADE       ------------ 01.07.13 
Command ===> _________________________________________________________________ 
       Enter GO to continue, CANcel to exit                                    
     FOCUS Processing mode...... UPGRADE                                       
     Using tape files: Tape type => 3480  Labels... T7610A U7610A              
   Current FOCUS files prefix => 'oldhlq.PRDFOCUS'_________ UPGRADE REFERENCE  
       New FOCUS files prefix => 'newhlq.TSTFOCUS'_________ OUTPUT OF UPGRADE  
       File for generated job => 'newhlq.ISETUP.CNTL'_________________________ 
                                                                               
---------- Processing steps in effect for the UPGRADE                          
 DO Process installed optional features for the UPGRADE                        
 DO Use new files for the UPGRADE                                              
----------Selectable processing steps (Yes or No)                  (1-1 of 1)  
 YES Submit the work after generating the processor for the UPGRADE            
                                                                               
---------- Data Definition overrides for the FOCUS UPGRADE                     
Disk... DATACLAS= NONE******  MGMTCLAS= NONE******      STORCLAS= NONE******   
            UNIT= SYSALLDA     VOL=SER= NONE*********__                        
Tape....... UNIT= TAPE____       EXPDT= NONE****           RETPD= NONE         
---------- Jobcards, make necessary changes for the FOCUS UPGRADE              
 //T7600BAP JOB (T7600B),'MAINTENANCE UPGRADE',_________________________       
 //   MSGLEVEL=(1,1),MSGCLASS=X,CLASS=S_________________________________

A screen similar to the following displays for UPGRADE if you are downloading the files from an FTP site. Note that the REFRESH screen is the same except for the word REFRESH in place of UPGRADE:

--------------- Information Builders FOCUS UPGRADE       ------------ 01.07.13 
 Command ===> _________________________________________________________________ 
        Enter GO to continue, CANcel to exit                                    
      FOCUS Processing mode...... UPGRADE                                       
 Use FTP site files- Userid =>                          Password => *********** 
    Current FOCUS files prefix => 'oldhlq.PRDFOCUS'_________ UPGRADE REFERENCE  
        New FOCUS files prefix => 'newhlq.TSTFOCUS'_________ OUTPUT OF UPGRADE  
        File for generated job => 'userid.ISETUP.CNTL'_________________________ 
        FTP FOCUS files prefix => 'ftphlq.RECV'_____________ UPGRADE RECEIVE    
 ---------- Processing steps in effect for the UPGRADE                          
  DO Process installed optional features for the UPGRADE                        
  DO Use new files for the UPGRADE                                              
 ----------Selectable processing steps (Yes or No)                  (1-2 of 2)  
  YES Get IBI files from the FTP site first for the UPGRADE                     
  YES Submit the work after generating the processor for the UPGRADE            
 ---------- Data Definition overrides for the FOCUS UPGRADE                     
 Disk... DATACLAS= NONE******  MGMTCLAS= NONE******      STORCLAS= NONE******   
             UNIT= SYSALLDA     VOL=SER= NONE*********__                        
                                                                                
 ---------- Jobcards, make necessary changes for the FOCUS UPGRADE              
  //jobname JOB jobcardoptions___________________________________________       
  //   MSGLEVEL=(1,1),MSGCLASS=X,CLASS=S_________________________________

You must supply the following information:

If you are downloading from an FTP site, the user ID and password to log onto the FTP site (if ISETUP will do the transfer). Note: Information Builders will send you an email with the FTP site, user ID, and password when you order the service pack or upgrade.
If you do not supply an FTP password, and you select the option (described below) to have ISETUP download the files from the FTP site, the following message displays:
```
FTP PASSword missing      
```
The high level qualifiers for your current production version of FOCUS enclosed in single quotation marks.
The new high level qualifiers for the updated version of FOCUS enclosed in single quotation marks. ISETUP initially creates a default prefix consisting of the connected user ID as the first qualifier and TEST as the second; however, you can change those qualifiers. The new prefix must be different from the prefix for your production version of FOCUS and should be the prefix to which you unloaded or downloaded ISETUP.DATA.
A complete data set name for the generated job (JCL) if you do not want to accept the default name: userid.ISETUP.CNTL. The data set must be DSORG PS.
By default, the job will be submitted automatically by ISETUP. If you do not want the job to be submitted automatically, enter NO instead of YES on the line that says:
```
Submit the work after generating the processor for the REFRESH 
```
If you change this to NO, you must submit the job (JCL) manually.

If you are downloading from an FTP site, whether you want ISETUP to use FTP GET to transfer the service pack or upgrade to your system.
By default, ISETUP will transfer the service pack to your system with FTP GET. If you do not want ISETUP to do this, enter NO instead of YES on the line that says:
```
Get IBI files from the FTP site first for the UPGRADE
```
If you change this to NO, you must transfer the service pack manually. The initial ISETUP panel replaces the line that requires your ID and password for the FTP site with the following:
```
Using FTP site files- * FTP download required before processing the UPGRADE * 
```
Some sites require specific DASD unit types. You can specify overrides for the defaults on the screen.
If you are unloading from a cartridge, some tape management products require specific expiration date or retention period values to process tapes. You can add any required values on the line labeled Tape in the Data Definition overrides section of the screen. Note: Do not enter 98000 for EXPDT unless you have a tape management system that can intercept that value. If you do not have such a tape management system and you want to enter an EXPDT value of 98000, you can edit the generated JCL to add the DCB parameter LABEL=EXPDT=98000.
Some sites require specific SMS parameters for DASD. You can add any required values on the line labeled Disk in the Data Definition overrides section of the screen.
A valid JOB card. Note that the screen initially displays a typical default job card.

If you are unloading from a cartridge, the distribution cartridge volume serial number(s) and media type display automatically. If they do not correspond to the distribution cartridge you want to process, you are not executing the correct ISETUP.DATA file. You must use the ISETUP.DATA file that was unloaded from the cartridge you want to process.

When you have entered the appropriate information, type one of the following commands on the command line and press Enter:

GO to continue ISETUP processing.
CANCEL or CAN to exit without processing.

If you enter GO, the following message displays as ISETUP updates your data definitions:

 EssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssN
 e --------------- Information Builders ISETUP processing ------------------  e
 e                                                                            e
 e     -----------------------------------------------------------------      e
 e    |       MVSISETDPNL updating data definitions...                  |     e
 e    |                    Please wait...                               |     e
 e     -----------------------------------------------------------------      e
 DssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssM

Next, the following message displays as ISETUP analyzes your currently installed features:

EssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssN
e --------------- Information builders ISETUP processing ------------------  e
e                                                                            e
e              ----------------------------------------------                e
e              |  MVSISETFPNL analyzing current features..  |                e
e              |               Please wait...               |                e
e              ----------------------------------------------                e
DssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssM

Select Optional Features for Upgrade

If your processing mode is UPGRADE, the following panel enables you to select features to be processed. All of your previously installed features are indicated by an X in the input column. Features that were not previously installed have a blank in the input column. The Processing column indicates the type of processing that will be done for the associated feature:

SKIP indicates that the feature will be skipped. No files will be unloaded.
INSTALL indicates that ISETUP will install the feature. For a list of features that ISETUP can install, see Customized Settings That Are Reapplied.
LOADONLY indicates that the data sets will be unloaded from the distribution tape, but that ISETUP will not install these features. You can install them by following the instructions in the relevant Installation Guide.

Note: This panel does not appear for REFRESH mode. In REFRESH mode, ISETUP processes the same features you had prior to the maintenance refresh.

You can select a feature by entering X in the input column or deselect a feature by deleting the X in the input column:

 -------------- Available Optional Feature Install Selection  Row 1 to 12 of 27 
 Command ===> _________________________________________________________________ 
        Enter GO to continue, CANcel to exit                                    
                                                                                
                                                                                
 +--  X Selects a feature for processing                                        
 |      (blank) Skips processing a feature                                      
 |                                                                              
 |  LOADONLY processing only loads the feature files from the tape to disk,     
 |           no feature installation is run, refer to the feature documentation 
 |                                                                              
 V Processing  Feature     Description                                          
    SKIP       ACE         Application Control Environment                      
    SKIP       ADABAS      Adapter for ADABAS                                   
    SKIP       DATACOM     Adapter for DATACOM                                  
 X  LOADONLY   DB2         Relational data adapters                             
    SKIP       FOCCALC     FOCCALC                                              
 X  LOADONLY   FOCMENU     FOCUS Menu                                           
    SKIP       FRENCH      French Translation menus                             
    SKIP       ICU         FOCUS ICU Interface                                  
    SKIP       IDMS        IDMS/DB Data Adapter                                 
 X  LOADONLY   IDMS_SQL    Relational data adapters                             
    SKIP       IMS_DB      IMS/DB Data Adapter                                  
    SKIP       IMS_DC      IMS/DB Data Adapter

The list of features continues on two more panels. Note that the previous and following screens indicate that features DB2, FOCUS Menu, IDMS_SQL, MSO, NLS, Oracle, StyleSheets, Teradata, and FOCUS Toolkit will be unloaded. Some may be upgraded by ISETUP as well.

If ISETUP will unload the feature but not upgrade it, the message in the Processing column will change to LOADONLY. If ISETUP will both unload and upgrade the feature, the message in the Processing column will change to UPGRADE:

 -------------- Available Optional Feature Install Selection Row 13 to 24 of 27 
 Command ===> _________________________________________________________________ 
        Enter GO to continue, CANcel to exit                                    
                                                                                
                                                                                
 +--  X Selects a feature for processing                                        
 |      (blank) Skips processing a feature                                      
 |                                                                              
 |  LOADONLY processing only loads the feature files from the tape to disk,     
 |           no feature installation is run, refer to the feature documentation 
 |                                                                              
 V Processing  Feature     Description                                          
    SKIP       JAVA        JAVA Applets                                         
    SKIP       MNTPAINT    Maintain                                             
    SKIP       MNTPANELS   Maintain                                             
    SKIP       MODEL204    Model 204 Data Adapter                               
 X  LOADONLY   MSO         Multi-Session Option                                 
 X  LOADONLY   NLS         National Language Support                            
 X  LOADONLY   ORACLE      Relational data adapters                             
    SKIP       SAP         SAP Adapter                                          
 X  LOADONLY   STYLESHEET  Style Sheets                                         
    SKIP       S2000       System 2000 Data Adapter                             
 X  LOADONLY   TERADATA    Teradata Adapter                                     
 X  LOADONLY   TOOLKIT     FOCUS Windows

-------------- Available Optional Feature Install Selection Row 25 to 27 of 27 
Command ===> _________________________________________________________________ 
       Enter GO to continue, CANcel to exit                                    
                                                                               
                                                                               
+--  X Selects a feature for processing                                        
|      (blank) Skips processing a feature                                      
|                                                                              
|  LOADONLY processing only loads the feature files from the tape to disk,     
|           no feature installation is run, refer to the feature documentation 
|                                                                              
V Processing  Feature     Description                                          
   SKIP       TOTAL       TOTAL Data Adapter                                   
   SKIP       WEBGIF      Web Graphics                                         
   SKIP       WEBHTML     Web Documents

The following panel indicates that while ISETUP will unload the Toolkit, it will both unload and upgrade the adapter (Interface) for Teradata:

 -------------- Available Optional Feature Install Selection Row 23 to 27 of 27 
 Command ===> _________________________________________________________________ 
        Enter GO to continue, CANcel to exit                                    
                                                                                
                                                                                
 +--  X Selects a feature for processing                                        
 |      (blank) Skips processing a feature                                      
 |                                                                              
 |  LOADONLY processing only loads the feature files from the tape to disk,     
 |           no feature installation is run, refer to the feature documentation 
 |                                                                              
 V Processing  Feature     Description                                          
 X  UPGRADE    TERADATA    Teradata Adapter                                     
 X  LOADONLY   TOOLKIT     FOCUS Windows                                        
    SKIP       TOTAL       TOTAL Data Adapter                                   
    SKIP       WEBGIF      Web Graphics                                         
    SKIP       WEBHTML     Web Documents

When you have finished making your selections, enter:

GO to continue processing.
CANcel to exit.

Review the Data Set Names and Start Processing

ISETUP displays a confirmation screen that summarizes the information you have supplied and that it will use to create the maintenance refresh or upgrade job.

The confirmation screen looks similar to the following if you are unloading the files from a cartridge:

+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+
|                   - - ISETUP Processing Confirmation - -                    |
|        - - Generating UPGRADE with tape T7610A U7610A - - 01.07.13          |
|                                                                             |
|             ISETUP data: 'newhlq.ISETUP.DATA'                               |
|Current libraries prefix: 'oldhlq.PRDFOCUS' -------------- UPGRADE reference |
|    New libraries prefix: 'newhlq.TSTFOCUS' -------------- OUTPUT of UPGRADE |
|       Saved job library: 'newhlq.ISETUP.CNTL'                               |
|......................... Data definition overrides .........................|
| Disk: DATACLAS=,(none)    MGMTCLAS=,(none)    STORCLAS=,(none)              |
|           UNIT=SYSDA       VOL=SER=,(none)                                  |
| Tape:     UNIT=3480          EXPDT=,(none)       RETPD=,(none)              |
|......................... Optional Processing Steps .........................|
| DO     Process installed optional features for the UPGRADE                  |
| DO     Use new files for the UPGRADE                                        |
| DO     Submit the work after generating the processor for the UPGRADE       |
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+
                                                                               
*ISETUP enter Yes to process T7610A U7610A, REdo to change, Quit to exit now...

The confirmation screen looks similar to the following if you are downloading the files from an FTP site:

 +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+
 |                   - - ISETUP Processing Confirmation - -                    |
 |           - - Generating UPGRADE from the FTP SITE - - 01.07.13             |
 |                                                                             |
 |             ISETUP data: 'newhlq.TSTFOCUS.ISETUP.DATA'                      |
 |Current libraries prefix: 'oldhlq.PRDFOCUS' -------------- UPGRADE reference |
 |    New libraries prefix: 'newhlq.TSTFOCUS' -------------- OUTPUT of UPGRADE |
 |FTP receive files prefix: 'ftphlq.RECV' --------------------- FTP site files |
 |       Saved job library: 'userid.ISETUP.CNTL'                               |
 |......................... Data definition overrides .........................|
 | Disk: DATACLAS=,(none)    MGMTCLAS=,(none)    STORCLAS=WIBTEST              |
 |           UNIT=SYSDA       VOL=SER=,(none)                                  |
 |......................... Optional Processing Steps .........................|
 | DO     Process installed optional features for the UPGRADE                  |
 | DO     Get IBI files from the FTP site first for the UPGRADE                |
 | DO     Use new files for the UPGRADE                                        |
 | DO     Submit the work after generating the processor for the UPGRADE       |
 +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+
                                                                               
 *ISETUP enter Yes to process FTPSITE, REdo to change, Quit to exit now...

Enter one of the following commands:

YES (or Y) to start processing. When you enter this command, ISETUP builds the JCL. This generated JCL is saved; however, it is recreated each time you run the ISETUP procedure.
REDO (or RE) to return to the main screen and make changes.
QUIT (or Q) to exit.

Review the Processing Messages

Reference:

Acceptable Non-Zero Return Codes

Be sure to review ISETUP messages that begin with three question marks (???), which indicate features that will not be processed, or three @ signs (@@@), which indicate unexpected errors.

If you unloaded the files from a cartridge, you will see processing messages similar to the following:

+ISETUP initializing processing...  
                                    
+ISETUP ANALYZE processing begins...
+ISETUP ANALYZE processing original jcl...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE  674 original jcl read in...
+ISETUP ANALYZE  674 UPGRADE T7610A U7610A out...
+ISETUP ANALYZE evaluating jcl steps...
+ISETUP ANALYZE   48 jcl steps...
+ISETUP ANALYZE evaluating jcl datasets...
+ISETUP ANALYZE   96 jcl datasets...
+ISETUP ANALYZE    0 changed datasets...
+ISETUP ANALYZE    0 input datasets...
+ISETUP ANALYZE    1 output datasets...
+ISETUP ANALYZE    0 input tag variables...
+ISETUP ANALYZE   47 output tag variables...
+ISETUP ANALYZE   10 pending allocations...
+ISETUP ANALYZE   10 allocation datasets
+ISETUP ANALYZE processing completed...
+ISETUP UPGRADE T7610A U7610A user modification processing...
+ISETUP UPGRADE 12 user modification processes completed...
+ISETUP FEATURES UPGRADE T7610A U7610A optional feature processing...
+ISETUP FEATURES UPGRADE no optional features processed...
+ISETUP UPGRADE T7610A U7610A job creation started

+ISETUP ADDJOBCARDS adding job cards...
+ISETUP ADDJOBCARDS   26 job cards and comments added... 
 
+ISETUP ADDSNAMECARDS adding set cards...                             
+ISETUP ADDSNAMECARDS  198 set cards added...                         
+ISETUP UPGRADE T7610A U7610A configuring validation                  
+ISETUP UPGRADEPTFVR adding PTFVR jcl...                              
+ISETUP UPGRADEPTFVR 8 PTFVR jcl added...                             
+ISETUP ALLOCNEW adding delete step...                                
+ISETUP ALLOCNEW adding delete jcl...                                 
+ISETUP ALLOCNEW adding allocate step...                              
+ISETUP ALLOCNEW adding allocate jcl...                               
+ISETUP ALLOCNEW   95 allocate jcl added...                           
+ISETUP COPYPROD no copy step required...                             
                                                                      
+ISETUP FINALPASS adding UPGRADE T7610A U7610A jcl...                 
+ISETUP FINALPASS UPGRADE T7610A U7610A continues...                  
                                                                      
+ISETUP FINALPASS  255 UPGRADE jcl and comments included...           
                                                                      
+ISETUP UPGRADE T7610A U7610A job creation completed 
 
+ISETUP UPGRADE T7610A U7610A  531 jcl and comments skipped... 
 
+ISETUP UPGRADE T7610A U7610A  250 UPGRADE jcl and comments added... 
 
+ISETUP UPGRADE T7610A U7610A  834 total jcl and comments generated...

+ISETUP UPGRADE T7610A U7610A   15 JCL operand changes made... 
 
+ISETUP UPGRADE T7610A U7610A   25 optional features skipped 
------------------------------------------------ 
ACE
ADABAS
DATACOM
DB2
FOCCALC
FRENCH
ICU
IDMS
IDMS_SQL
IMS_DB
IMS_DC
***
JAVA
 MNTPAINT
 MNTPANELS
 MODEL204
 MSO
 ORACLE
 SAP
 STYLESHEETS
 S2000
 TERADATA 
 TOOLKIT
 TOTAL 
 WEBGIF
 WEBHTML

 ------------------------------------------------                            
 +ISETUP WRITEJOB UPGRADE T7610A U7610A job saved as QCSJLD.ISETUP.CNTL
 IKJ56250I JOB QCSJLDED(JOB24722) SUBMITTED 
                        
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 +ISETUP UPGRADE T7610A U7610A job submitted...   
 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
- +ISETUP UPGRADE T7610A U7610A processing completed...
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

If you downloaded the files from an FTP site, you will see processing messages similar to the following:

+ISETUP ANALYZE processing begins.
+ISETUP ANALYZE processing original jcl...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE processing original jcl continues...
+ISETUP ANALYZE 1393 original jcl read in...
+ISETUP ANALYZE 1393 UPGRADE out...
+ISETUP ANALYZE evaluating jcl steps...
+ISETUP ANALYZE   96 jcl steps...
+ISETUP ANALYZE evaluating jcl datasets
+ISETUP ANALYZE   96 jcl datasets...
+ISETUP ANALYZE    0 changed datasets... 
+ISETUP ANALYZE    0 input datasets...
+ISETUP ANALYZE    1 output datasets...
+ISETUP ANALYZE   47 input tag variables
+ISETUP ANALYZE   94 output tag variables...
+ISETUP ANALYZE   28 pending allocations...
+ISETUP ANALYZE   28 allocation datasets
+ISETUP ANALYZE processing completed... 
+ISETUP UPGRADE FTPSITE user modification processing...
+ISETUP UPGRADE 11 user modification processes completed...
+ISETUP FEATURES UPGRADE FTPSITE optional feature processing...
***
+ISETUP FEATURES UPGRADE no optional features processed...

+ISETUP UPGRADE job creation started 
 
+ISETUP ADDJOBCARDS adding job cards...
+ISETUP ADDJOBCARDS   27 job cards and comments added...
 +ISETUP ADDSNAMECARDS adding set cards.
 +ISETUP ADDSNAMECARDS  198 set cards added...
 +ISETUP UPGRADE configuring validation
 +ISETUP UPGRADEPTFVR adding PTFVR jcl...
 +ISETUP UPGRADEPTFVR 8 PTFVR jcl added...
 +ISETUP ALLOCNEW adding delete step...
 +ISETUP ALLOCNEW adding delete jcl...
 +ISETUP ALLOCNEW adding allocate step...
 +ISETUP ALLOCNEW adding allocate jcl...
 +ISETUP ALLOCNEW  257 allocate jcl added...
 +ISETUP COPYPROD no copy step required...

 +ISETUP FINALPASS adding UPGRADE jcl...
 +ISETUP FINALPASS UPGRADE continues...
 +ISETUP FINALPASS  541 UPGRADE jcl and comments included...
 ***                                                                         
+ISETUP UPGRADE job creation completed                                
                                                                       
 +ISETUP UPGRADE  986 jcl and comments skipped...                      
                                                                       
 +ISETUP UPGRADE  237 UPGRADE jcl and comments added...                
                                                                       
 +ISETUP UPGRADE 1270 total jcl and comments generated...              
                                                                       
 +ISETUP UPGRADE    5 JCL operand changes made...                      
                                                                       
 +ISETUP UPGRADE   21 optional features skipped                        
 ------------------------------------------------                      
 ACE                                                                   
 ADABAS                                                                
 DATACOM                                                               
 FOCCALC                                                               
 FOCMENU                                                               
 FRENCH                                                                
 ICU                                                                   
 JAVA                                                                  
 MNTPAINT                                                              
 MNTPANELS                                                             
 ***                                                                   
MODEL204                                                                
 MSO                                                                     
 NLS                                                                     
 SAP                                                                     
 STYLESHEETS                                                             
 S2000                                                                   
 TERADATA                                                                
 TOOLKIT                                                                 
 TOTAL                                                                   
 WEBGIF                                                                  
 WEBHTML                                                                 
 ------------------------------------------------                        
                                                                         
 +ISETUP WRITEJOB UPGRADE job saved as QCSJLD.ISETUP.CNTL                
 IKJ56250I JOB QCSJLDED(JOB07397) SUBMITTED                              
                                                                         
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -     
 +ISETUP UPGRADE job submitted...                                        
                                                                         
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -     
 +ISETUP UPGRADE processing completed...                                 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

The following is an example of a warning message generated when ISETUP cannot locate a file needed for a feature. You can skip that feature and continue processing without it by entering SKIP, or halt processing by entering anything else:

???ISETUP WARNING cannot locate feature file 'oldhlq.MSO.LOAD'    
*ISETUP SKIPCHK Enter "SKIP" to skip the MSO feature that uses this file
*ISETUP SKIPCHK Enter anything else to halt processing
*ISETUP SKIPCHK and correct this condition

The preceding sample output shows the messages that display when you choose YES to automatically submit the generated job (JCL). If you choose NO, the job is not submitted and the following message displays:

------------------------------------------------    
+ISETUP UPGRADE T7600B job NOT submitted...

------------------------------------------------    
+ISETUP REFRESH FTPSITE job NOT submitted...

Top of page

Reference: Acceptable Non-Zero Return Codes

Most steps in the job should end with a return code of zero. The following is an exception:

The steps named RELINKnn may end with a return code of 4, which is acceptable and can be ignored.