The Db2 installation CLIST panel session

The installation CLIST displays a series of ISPF panels that prompt you to supply parameter values or accept the supplied default values. In most cases, the fields on the ISPF panels correspond with Db2 subsystem parameters.

For instructions for invoking the Db2 installation and migration CLIST, see Generating tailored installation, migration, or function level activation jobs by running the Db2 installation CLIST in interactive mode.

In general, you can change the default values to match the needs of your organization. However, some values cannot be changed, depending on the INSTALL TYPE value that you specify on panel DSNTIPA1, and whether you are installing the first or subsequent members of a data sharing group.

Navigating in the CLIST panel session

All panel sequences begin with the Main Panel, DSNTIPA1.

Start of change
Figure 1. Main panel: DSNTIPA1
 DSNTIPA1  DB2 VERSION 12 INSTALL, UPDATE, MIGRATE AND PROVISION - MAIN PANEL       
 ===>                                                                           
 Will the installation/migration be performed with z/OSMF?                      
     USE Z/OSMF WORKFLOW   ===> NO       Yes or No (Yes for Provision)          
                                                                                
 Check parameters and reenter to change:                                        
   1 INSTALL TYPE          ===> INSTALL    Install, Migrate, Activate, Update   
                                           or Provision                         
   2 DATA SHARING          ===> NO        Yes or No (blank for Activate, Update)
 For migration only: Enter the data set and member name with the settings from  
 the previous Installation/Migration:                                           
   3 DATA SET(MEMBER) NAME ===>                                                 
 For DB2 SMP/E libraries (SDSNLOAD, SDSNMACS, SDSNSAMP, SDSNCLST, etc.), enter: 
   4 LIBRARY NAME PREFIX   ===> DSN1210                                         
   5 LIBRARY NAME SUFFIX   ===>                                                 
 For install data sets (NEW.SDSNSAMP, NEW.SDSNCLST, RUNLIB.LOAD, etc.), enter:  
   6 DATA SET NAME PREFIX  ===> DSN1210                                         
   7 DATA SET NAME SUFFIX  ===>                                                 
 Enter to set or save panel values (by reading or writing the named members):   
   8 INPUT MEMBER NAME     ===> DSNTIDXA  Default parameter values              
   9 OUTPUT MEMBER NAME    ===>           Save new values entered on panels     
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information         
End of change

You can use the following approaches to navigate in the CLIST panel session:

  • To display the panel identifiers, enter the following command in any panel: PANELID ON.
  • Enter your choices on a panel in the space that is marked by an arrow (===>). Begin your entry in the second position to the right of the arrow. The first position is protected and you cannot write in it.
  • To validate entries in the current panel and display the next panel, press Enter.
  • Panel fields that are marked with asterisks contain values that are primed on the basis of values from a previous panel. The following message is found on these panels:
    DSNT444I SCROLLING BACKWARD MAY CHANGE FIELDS MARKED WITH ASTERISKS

    If you scroll back to the panel that has the original value, the values on the succeeding panels are refreshed only if the original value is changed. If the values are changed, the following message is displayed:

    DSNT443I VALUES MARKED WITH AN ASTERISK HAVE BEEN UPDATED

    For example, panel DSNTIPH has fields that are marked with asterisks indicating values that are primed on the basis of the CATALOG ALIAS value on installation panel DSNTIPA2.

  • To scroll back to the previous panels to review or change values press the End key (usually PF3).
  • To save your changes at any point during the panel session, enter the following command in any installation panel: SAVE Then select option 1 in panel DSNTIPSV.
    +---------------------------------+
    |DSNTIPSV                         |
    | Save changes in progress:       |
    |                                 |
    | Select one.                     |
    |   S 1. Save and continue        |
    |     2. Save and exit            |
    |     3. Continue without saving  |
    |                                 |
    | PRESS: ENTER to continue        |
    | RETURN to exit                  |
    +---------------------------------+

    The changes are saved in the output member that is specified in the OUTPUT MEMBER NAME field on panel DSNTIPA1.

  • To exit completely from the installation process, press the Return key (usually PF4).

The CLIST session completes when you press Enter from the last panel: DSNTIPC1 for installation or DSNTIPC for migration. For the more information about complete ting the CLIST panel session, see step 7 in Generating tailored Db2 12 installation, migration, or function level activation jobs.

CLIST panel and field descriptions

The CLIST panel field descriptions following information:

Acceptable values
This part of a panel field description indicates the range or list of allowable values for an installation panel field. The acceptable values apply to the installation panel field, but not necessarily to the subsystem parameter that is associated with that field. Differences might occur if a panel field is used to determine the value of the associated subsystem parameter and the values do not correspond exactly.

In most cases, if a maximum supported panel field value is large enough, you can specify the following multipliers:

  • valueK for value multiplied by 1024
  • valueM for value multiplied by 1,048,576
  • valueG for values greater than 1024 MB
  • valueT for values greater than 1024 GB

The maximum acceptable values might be too large for smaller systems; therefore, ensure that the values that you enter are valid for the size of your system.

Default values
The default values that documentation shows are the original values that are supplied by IBM®. If you previously ran the CLIST and saved the updated panel values in a DSNTIDxx input data set, the previously entered values appear as default values on the panels.
Tip: You can capture most settings of an existing Db2 subsystem by running the DSNTIJXZ job, which invokes the DSNTXAZP tool. Running this job reduces the effort to manually compare settings in the current DSNTIJUZ job with the values that are defined in the defaults input member. For details, see Updating the CLIST defaults input member: job DSNTIJXZ and DSNTXAZP tool.
Panel values that are modified outside of the installation process are not saved in the DSNTIDxx data set and are not reflected on the panels.
Update
This information identifies a corresponding field on the Update Selection Panel (DSNTIPB) or refers to information that provides instructions for updating the field value. For more information, see DSNTIPB: Update selection menu panel .
dsnhdecp
These are the names of the parameters in the application defaults load module dsnhdecp. For more information, see Application defaults parameters.
DSNZPxxx
These are the names of the parameters in the data-only load module DSNZPxxx.

Some Db2 subsystem parameters do not appear on CLIST panels. For details, see Subsystem parameters that are not on installation panels.