Updating the CLIST defaults input member: job DSNTIJXZ

Before you run the CLIST to migrate to Db2 13, update an existing Db2 13 subsystem, or install Db2 13 using the settings of an existing Db2 13 subsystem, update your defaults input member.

Before you begin

Ensure that you have configured Resource Recovery Services (RRS).

Before running this job, you might need to bind or refresh the package and plan for the DSNTXAZP program. The necessary bind commands are in installation job DSNTIJSG.

If the DSNTXAZP job action to be used is UPDATE_APPL_DEF, UPDATE_IRLM, UPDATE_LOG, or UPDATE_ALL, ensure that the following requirements are met:

  • SYSOUT data sets for started tasks are available:
    • JOBCLASS(STC) OUTPUT must be set to YES
    • OUTCLASS(x) OUTPUT must be set to PRINT or PUNCH, where x is the JOBCLASS(STC) MSGCLASS value
  • The load library with the enhanced DSNTXAZP module resides in an APF-authorized library.

For the following DSNTXAZP job actions, ensure that each user ID who executes DSNTXAZP has, at a minimum, the following access to JES SPOOL data sets:

  • UPDATE_APPL_DEF: READ access to the JES SPOOL JESMSGLG data set of the Db2 started task (ssidMSTR) where the DSNHDECP module name is specified.
  • UPDATE_IRLM: READ access to the JES SPOOL JESJCL data set of the IRLM started task (IRLMPROC - the IRLM startup procedure name) where the IRLM startup options are specified.
  • UPDATE_LOG: READ access to the JES SPOOL JESJCL data set of the Db2 started task (ssidMSTR) where the BSDS names are specified.
  • UPDATE_ALL: READ access to the JES SPOOL data sets listed above for the UPDATE_APPL_DEF, UPDATE_IRLM, and UPDATE_LOG actions.

About this task

The DSNTIDxx defaults input member contains, the subsystem parameter settings, buffer pool settings, and other settings from an existing subsystem. It is used as input during your migration, update, or installation.

You can use job DSNTIJXZ to create an updated defaults input member, DSNTIDxx, which contains most of the settings from your current subsystem. Running this job reduces the effort of manually comparing settings in your current DSNTIJUZ job with the values that are defined in the defaults input member.

Procedure

To update the CLIST defaults input member:

  1. Obtain the correct version of the DSNTIJXZ job.
    • If you are preparing to migrate to Db2 13, use the Db2 12 DSNTIJXZ job on Db2 12 to create an updated migration input member for the Db2 13 installation CLIST.
    • If you are preparing to update an existing Db2 13 subsystem or install Db2 13 using the settings of an existing Db2 13 subsystem, use the Db2 13 DSNTIJXZ job to create an updated input member.
  2. Configure and run job DSNTIJXZ.
    • If you are preparing to migrate to Db2 13, specify as input your existing Db2 12 DSNTIDxx member. This member is the one that was created when you installed or migrated to Db2 12. If you do not have this member, specify as input the Db2 12 DSNTIDXA member, or the DSNTIDXB member if you use SAP.

      For Db2 data sharing, verify that job DSNTIJXZ runs on the data sharing member that you are preparing to migrate and that the input to job DSNTIJXZ is the DSNTIDxx member for that data sharing member.

    • If you are preparing to update an existing Db2 13 subsystem or install Db2 13 using the settings of an existing Db2 13 subsystem, specify as input your existing Db2 13 DSNTIDxx member. This member is the one that was created when you installed or migrated to Db2 13. If you do not have this member, specify as input the Db2 13 DSNTIDXA member, or the DSNTIDXB member if you use SAP.
    Job DSNTIJXZ uses the DSNTXAZP tool to create a copy of the specified DSNTIDxx member and update it with the current subsystem parameter settings, buffer pool settings, and other installation settings. For more information, see DSNTXAZP tool.
    Important: The DSNTXAZP tool does not update the DSNTIDxx CLIST input member with current settings for the following parameters or panel fields. Update the values as you complete the CLIST, or modify the values directly in the DSNTIDxx member:
    Table 1. Settings not updated by the DSNTXAZP tool in Db2 13
    CLIST Panel Field Name (DSNTIDxx entry)
    DSNTIPA2 The following fields:
    • DEFINE CATALOG (VCATSTAT)
    DSNTIPA3 All fields:
    • PERMANENT UNIT NAME (VOLSDEVT)
    • TEMPORARY UNIT NAME (TVOLSDEVT)
    • CLIST ALLOCATION: VOL/SER (VOLSDAT1)
    • CLIST ALLOCATION: DATA CLASS (DATACLS1)
    • CLIST ALLOCATION: MGMT CLASS (MGMTCLS1)
    • CLIST ALLOCATION: STOR CLASS (STORCLS1)
    • NON-VSAM DATA: VOL/SER (VOLSDAT2)
    • NON-VSAM DATA: DATA CLASS (DATACLS2)
    • NON-VSAM DATA: MGMT CLASS (MGMTCLS2)
    • NON-VSAM DATA: STOR CLASS (STORCLS2)
    DSNTIPG1 All fields:
    • INSTALL DS PREFIX (INSDSPRE)
    • IC DATA SET UNIT NAME (ICDSDEV)
    • IC TEMPLATE EXPRESSION (ICDSTPLT)
    • IC TEMPLATE DATA CLASS (ICDSDC)
    • IC TEMPLATE MGMT CLASS (ICDSMC)
    • IC TEMPLATE STOR CLASS (ICDSSC)
    • PKG APPLCOMPAT (JRTAPCO)
    • PKG PLANMGMT (JRTPMGMT)
    • MQ ADMIN ID(S) (JRTMQADM)
    DSNTIPT All fields:
    • TEMP CLIST LIBRARY (NEWCL)
    • SAMPLE LIBRARY (NEWSAMP)
    • CLIST LIBRARY (OUTCL)
    • APPLICATION DBRM (DBRMLIB)
    • APPLICATION LOAD (RUNLIB)
    • DECLARATION LIBRARY (SRCLIB)
    • LINK LIST LIBRARY (DSNLINK)
    • LOAD LIBRARY (DSNLOAD)
    • JDBC AND SQLJ DLLS (DSNLOD2)
    • MACRO LIBRARY (DSNMACS)
    • EXIT LIBRARY (DSNEXIT)
    • DBRM LIBRARY (DSNDBRM)
    • IRLM LOAD LIBRARY (DSNIRLM)
    • IVP DATA LIBRARY (DSNIVPD)
    • INCLUDE LIBRARY (DSNCHDRS)
    DSNTIPU All fields:
    • IBM® LE RUNTIME LIBRARY (LERUN)
    • IBM LE RUNTIME LIBRARY 2 (LERUN2)
    • IBM LE LINK EDIT LIB (LELKED)
    • IBM LE PRELINK MSG LIB (LEPLMSGL)
    • HIGH LEVEL ASSEMBLER LIB (ASMLIB)
    • C/CPP COMPILER MODULE (CPROG)
    • C/CPP COMPILER LIBRARY (CCOMP)
    • C/CPP HEADER LIBRARY (CHDRS)
    • C/370 COMPILER MESSAGES (CMSGS)
    • C LE PRELINKER PHASE (CPRLK)
    • CPP LE PRELINKER PHASE (CPPPRLK)
    • CPP CLASS LIB HEADERS (CPPHDRS)
    • CPP AUTO CALL LIBRARY (CPPAUTCL)
    • CPP CLASS LIBRARY (CPPCLASS)
    • CPP PROCEDURE LIBRARY (CPPPROC)
    DSNTIPU1 All fields:
    • COBOL COMPILER LIBRARY (ICOBCOMP)
    • COBOL LE PRELINKER PHASE (ICOBPRLK)
    • FORTRAN COMPILER LIBRARY (FORTCOMP)
    • FORTRAN LINK EDIT LIB (FORTLINK)
    • PL/I COMPILER LIBRARY (PLICOMP)
    • PL/I LE PRELINKER PHASE (PLIPRLK)
    DSNTIPW All fields:
    • SYSTEM MACLIB (MACLIB)
    • SYSTEM PROCEDURES (PROCLIB)
    • SORT LIBRARY (SORTLIB)
    • IMS RESLIB (RESLIB)
    • ISPF ISPLINK MODULE (ISPLOAD)
    • GDDM MACLIB (GDDMMACS)
    • GDDM LOAD MODULES (GDDMLOAD)
    • CICS® LOAD LIBRARY (CICSMOD)
    • CICS MACRO LIBRARY (CICSMAC)
    • CICS COBOL LIBRARY (CICSCOB)
    • CICS PL/I LIBRARY (CICSPLI)
    • CICS EXCI LIBRARY (CICSEXCI)
    DSNTIPD All fields:
    • EXECUTED STMTS (NUMSTMTE)
    • TABLES IN STMT (NUMSTMTL)
    DSNTIP9 All fields:
    • 4K SORT PRIMARY SPACE (S4KSPAC)
    • 32K SORT PRIMARY SPACE (S32KSPAC)
    • 4K TEMP PRIMARY SPACE (T4KSPAC )
    • 32K TEMP PRIMARY SPACE (T32KSPAC)
    DSNTIPE
    • DATABASES (NUMCONDB)
    DSNTIPI: IRLM panel 1
    • INSTALL IRLM (IRLMINST)
    DSNTIPM
    • SUBSYSTEM MEMBER (MVSSMEMB)
    • SUBSYSTEM SEQUENCE(MVSSSEQN)
    • AUTH MEMBER (MVSAMEMB)
    • AUTH SEQUENCE (MVSASEQN)
    • LINK LIST ENTRY (MVSLMEMB)
    • LINK LIST SEQUENCE (MVSLSEQN)
    • COMMAND SCOPE (MVSCMSC)
    DSNTIPL
    • ARCHIVE LOG FREQ (NUMHRARC)
    • UPDATE RATE (NUMCOMHR)
    DSNTIPR The following fields:
    • DB2 VTAM PASSWORD (DDPASS)
    DSNTIPX The following fields:
    • WLM PROC NAME (STORWLM)
    • NUMBER OF TCBS (STORTCBS)
    DSNTIPX1
    • SDK HOME DIR (JAVAHOME)
    • JAVA CLASSES (CLASPATH)
    • JAVA RUNTIME (LIBPATH)
    • JDBC/SQLJ ENV VAR DIR (JCCHOME)
    • JDBC/SQLJ INSTALL ID (JCCSID)
    • DB2 BASE JAVA DIR (DB2BASE)
    • JAVA ENV DATA SET (JAVAENV)
    • JAVA ENV VAR FILE (JAVAENVV)
    • JVM PROPERTIES FILE (JVMPROPS)
    • JVM ADDRESSING MODE (JVMAMODE)
    • INIT JAVA HEAP SIZE (JVMHEAP)
    • MAX APPL HEAP SIZE (JVMAPPH)
       
    DSNTIPY
    • REMOTE LOCATION (DDSAMPL)
    • All numbered job card information fields.
    DSNTIPM1
    • PATH FOR Z/OSMF ARTIFACTS (ZARTPATH)
    • PRIOR RELEASE SDSNLOAD LIBRARY (OLDZPARM)
    • PRIOR RELEASE SDSNEXIT LIBRARY (OLDEXIT)
  3. When you run the CLIST, specify the DSNTIDxx member that is created by this job during instillation or migration:
    • For migration, specify the DSNTIDxx member that is created by this job in the DATA SET(MEMBER) NAME field on panel DSNTIPA1.
    • During installation, or for updates, specify the DSNTIDxx member that is created by this job in the INPUT MEMBER NAME field on panel DSNTIPA1.