Generating tailored installation, migration, or function level activation jobs by running the Db2 installation CLIST in interactive mode

The Db2 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.

To tailor Db2 12 installation and migration jobs, complete the following steps:

1. Make the Db2 ISPF libraries available to TSO by taking one of the following actions:
   • To prepare for running only the Db2 installation CLIST, issue the following commands:

     PROFILE WTP MSGID
     ALLOCATE DDNAME(SYSEXEC) DSN('prefix.SDSNCLST') SHR REUSE
     ALLOCATE DDNAME(ISPMLIB) DSN('prefix.SDSNSPFM' + 
         'ISP.SISPMENU') SHR REUSE
     ALLOCATE DDNAME(ISPPLIB) DSN('prefix.SDSNSPFP' + 
         'ISP.SISPPENU') SHR REUSE
     

   • To prepare for running the Db2 installation CLIST and the Db2 Interactive (DB2I) facility, issue the following commands. If you use Kanji DB2I panels, concatenate SDSNPFPK to ISPPLIB instead of SDSNPFPE.

     PROFILE WTP MSGID 
     ALLOCATE DDNAME(SYSPROC) DSN('prefix.SDSNCLST') SHR REUSE
     ALLOCATE DDNAME(ISPMLIB) DSN('prefix.SDSNSPFM' + 
         'ISP.SISPMENU') SHR REUSE 
     ALLOCATE DDNAME(ISPPLIB) DSN('prefix.SDSNSPFP' 'prefix.SDSNPFPE' + 
         'ISP.SISPPENU') SHR REUSE 
     ALLOCATE DDNAME(ISPSLIB) DSN('prefix.SDSNSPFS' + 
         'ISP.SISPSLIB' 'ISP.SISPSENU') SHR REUSE 
     

   The PROFILE command provides complete error messages.

   The ALLOCATE command uses the default names of the libraries that contain the ISPF panels. These ISPF library names might be different at your site. To concatenate or merge existing libraries with them, put the library names in the list of names in parentheses after DSN with the largest block size first. (If two or more libraries have the same block size, you can list either one first.)

2. If you are running the Db2 installation CLIST to migrate to Db2 12 update an existing Db2 12 subsystem, or install a new Db2 12 based on the settings of existing installation, configure and run job DSNTIJXZ to update the defaults input member. For details, see Updating the CLIST defaults input member: job DSNTIJXZ .
3. If your z/OS® system has multiple procedure libraries, ensure that the installation jobs access the appropriate set of procedures by specifying the order in which procedure libraries are searched. You can use the following JCLLIB statement to specify the order in which procedure libraries are searched.

   //ddname JCLLIB ORDER=(library[,library...])

   The JCLLIB statement must follow the JOB statement and precede the first EXEC statement in the job. You can have Db2 insert this statement in your JCL for you by entering the statement on installation panel DSNTIPY. For more information on the JCLLIB statement, see JCLLIB statement .
4. Establish system affinity to ensure that the installation jobs run on the z/OS system where the appropriate Db2 subsystem is running. The following methods are examples of several z/OS installation-specific methods for establishing system affinity:
   • For JES2 multi-access spool (MAS) systems, use the following JCL statement:

     /*JOBPARM SYSAFF=cccc

     Where cccc is the JES2 name. You can specify an asterisk (SYSAFF=*) to indicate that the job should run on the system from which it was submitted.

   • For JES3 systems, use the following JCL statement:

     //*MAIN SYSTEM=(main-name)

     The main-name is the JES3 name.

   You can edit the jobs manually, or you can enter the preceding statements on installation panel DSNTIPY and have Db2 insert these statements for you. For more information, see JES2 Control Statements (MVS JCL Reference) and JES3 Control Statements (MVS JCL Reference).

5. Invoke the CLIST:
   1. Check that your TSO logon region size is sufficient.
      Usually 2 MB is enough.
   2. Invoke ISPF.
   3. Select option 6 on the main ISPF panel.
   4. Run the Db2 installation CLIST by entering one of the following specifications:

      • EXEC 'prefix.SDSNCLST(DSNTINST)' 

      • If you want to receive the messages that trace the progress of the CLIST, use the following specification:

        EXEC 'prefix.SDSNCLST(DSNTINST)' 'CONTROL(LIST)'

      • If you want to use the CLIST but skip the verification of output data sets, use the following specification:

        EXEC 'prefix.SDSNCLST(DSNTINST)' 'CHKOUTDS(NO)'

        By default, the CLIST verifies the following information when installation panels DSNTIPT and DSNTIPA1 are displayed:
        • The CLIST verifies that the TEMP CLIST LIBRARY and SAMPLE LIBRARY that you specify on DSNTIPT can be allocated and opened for output.
        • If you specify a value for OUTPUT MEMBER NAME on DSNTIPA1, the CLIST verifies that the data set prefix.SDSNSAMP can be allocated and opened for output.
   The CLIST reads a set of default values and displays them on the panels. The values can be the original default values that are supplied by IBM®, values that you specified in a previous run of the CLIST, or values that were generated when you ran the DSNTXAZP tool.
6. Use the CLIST panels to verify or adjust the values in the panel fields.
   For instructions for working with CLIST panels and descriptions of the panels and fields, see The Db2 installation CLIST panel session.
7. On the last panel that displays, CLIST calculations (DSNTIPC1 for installation or DSNTIPC for migration), press Enter to complete the CLIST processing.
   A series of messages provide details about the CLIST processing:

   1. DSNT478I BEGINNING EDITED DATA SET OUTPUT
   2. If the CLIST detects a problem when it checks the parameter values that you entered, you receive an error or warning message indicating the name of the parameter and the type of problem.
      • If you receive an error message, the CLIST cannot edit the installation or migration jobs properly.
      • If you receive a warning message, check the conditions. A warning message can sometimes be issued even when the conditions are normal or acceptable.
      • If you specify several large numbers in the panels, the CLIST might send a message indicating an overflow in CLIST arithmetic.

      The CLIST displays the Main Panel again. You can proceed through the panels, rechecking or changing parameter values.

   3. If the CLIST does not find any errors, you receive messages on DSNTIPC1 that indicate the amount of required disk storage and virtual storage.
   4. You might also receive some other information messages. For example, if you specified an existing data set for the TEMP CLIST LIBRARY field or the SAMPLE LIBRARY field on panel DSNTIPT, the following message is displayed:

      WARNING(S) ISSUED

 DSNT489I CLIST EDITING dsname(member), explanation

IKJ52506I TEXT NOT FOUND