A fix is available
APAR status
Closed as new function.
Error description
ENHANCE DSNTXAZP WITH ADDITIONAL PARAMETERS TO BE PROCESSED
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Db2 13 for z/OS users of DSNTXAZP, the * * DSNTIDxx refresh tool. * **************************************************************** * PROBLEM DESCRIPTION: Enhance DSNTXAZP, the DSNTIDxx refresh * * tool, to set the value of more * * parameters specified in a CLIST * * defaults input member (DSNTIDxx). * **************************************************************** * RECOMMENDATION: Apply corrective PTF when available * **************************************************************** Currently, the DSNTXAZP tool sets the value of a subset of installation parameters specified in a CLIST defaults input member (DSNTIDxx), such as current subsystem parameter and buffer pool settings that are defined in a specified Db2 subsystem.
Problem conclusion
Temporary fix
Comments
This APAR enhances DSNTXAZP to update additional parameter settings in the CLIST defaults input member (DSNTIDxx) with their current settings. It also introduces new DSNTXAZP 'action' values to allow you to specify which of these additional parameters are to be updated by DSNTXAZP. The additional parameters that are updated by DSNTXAZP and their corresponding 'action' value are described in Table 1 below: Table 1. New DSNTXAZP ACTION |---------------|-------------------------------------------| | ACTION | Additional Parameters Updated by DSNTXAZP | |---------------|-------------------------------------------| | UPDATE | Default startup module: | | _APPL_DEF | o DSNHDECP (APPL DEFAULTS) | | | | | | This parameter is normally set in the | | | Db2 installation panel DSNTIPO3 | | | (DEFAULT STARTUP MODULES). | | | | | | Notes: | | | 1. The SYSOUT data sets of the Db2 | | | started task (ssidMSTR), where the | | | DSNHDECP module name is specified, | | | must be available. JOBCLASS(STC) | | | OUTPUT must be set to YES and | | | OUTCLASS(x) OUTPUT must be set to | | | PRINT or PUNCH, where x is the | | | JOBCLASS(STC) MSGCLASS value. | | | 2. The user ID who submitted the job | | | which executes DSNTXAZP must have | | | at least READ access to the JES | | | SPOOL JESMSGLG data set of the Db2 | | | started task (ssidMSTR). | | | 3. The DSNTXAZP module must reside in an | | | APF-authorized library. | | | | |---------------|-------------------------------------------| | UPDATE | Authorization ID preferences for | | _AUTH_INSTALL | migration jobs: | | | o INSSQLID (INSTALL SQL ID) | | | o INSPKOWN (INSTALL PKG OWNER) | | | o INSGRLST (INSTALL GRANTEE(S)) | | | | | | These parameters are normally set in the | | | Db2 installation panel DSNTIPG | | | (INSTALLATION PREFERENCES). | | | | |---------------|-------------------------------------------| | UPDATE | Authorization ID preferences for | | _AUTH_IVP | IVP jobs: | | | o IVPSQLID (IVP SQL ID) | | | o IVPPKOWN (IVP PKG OWNER) | | | o IVPGRLST (IVP GRANTEE(S)) | | | | | | These parameters are normally set in the | | | Db2 installation panel DSNTIPG | | | (INSTALLATION PREFERENCES). | | | | |---------------|-------------------------------------------| | UPDATE | Catalog sizes parameters: | | _CATALOG_SIZE | o NUMDATAB (DATABASES) | | | o NUMTABLE (TABLES) | | | o NUMCOLUM (COLUMNS) | | | o NUMVIEWS (VIEWS) | | | o NUMTABSP (TABLE SPACES) | | | o NUMPLANS (PLANS) | | | o NUMPKGS (PACKAGES) | | | o NUMPKSTS (PACKAGE STATEMENTS) | | | o NUMPLPL (PACKAGE LISTS) | | | | | | These parameters are normally set in the | | | Db2 installation panel DSNTIPD (SIZES). | | | | |---------------|-------------------------------------------| | UPDATE_ | Data parameters: | | _DATA_PARM | a. Attributes of storage groups created | | | by installation and IVP jobs DSNTEJ1, | | | DSNTEJ2A, DSNTIJSG, and DSNTIJTM: | | | o VOLSDAT3 (VOL/SER) | | | o DATACLS3 (SMS DATA CLASS) | | | o MGMTCLS3 (SMS MGMT CLASS) | | | o STORCLS3 (SMS STOR CLASS) | | | | | | These parameters are normally set in | | | the Db2 installation panel DSNTIPA3 | | | (DATA PARAMETERS PANEL). | | | | | | b. Prefix for COPY data sets created by | | | installation and IVP jobs: | | | o INSICPRE (INSTALL IC PREFIX) | | | | | | This parameter is normally set in the | | | Db2 installation panel DSNTIPG1 | | | (INSTALLATION PREFERENCES PANEL 2). | | | | |---------------|-------------------------------------------| | UPDATE_DDF | DDF (Distributed Data Facility) | | | parameters: | | | o DDLOC (DB2 LOCATION NAME) | | | o DDLUNAM (DB2 VTAM LUNAME) | | | o GENLUNM (DB2 GENERIC LUNAME) | | | o IPNAME (DB2 TCP/IP IPNAME) | | | o TCPPORT (TCP/IP PORT) | | | o SECPORT (SECURE PORT) | | | o RESYNPRT (RESYNC PORT) | | | | | | These parameters are normally set in the | | | Db2 installation panel DSNTIPR | | | (DISTRIBUTED DATA FACILITY). | | | | |---------------|-------------------------------------------| | UPDATE | IRLM startup procedure parameters: | | _IRLM | o IRLMTRAC (START IRLM CTRACE) | | | o IRLMPGPR (PAGE PROTECT) | | | o IRLMMLTU (MAX LOCK STORAGE UNIT) | | | o IRLMMLMT (MAX STORAGE FOR LOCKS) | | | o IRLMIDEN (MEMBER IDENTIFIER) | | | o IRLMGRPN (IRLM XCF GROUP NAME) | | | o IRLMLKSZ (LOCK ENTRY SIZE) | | | o IRLMLTE (NUMBER OF LOCK ENTRIES) | | | o IRLMDISC (DISCONNECT IRLM) | | | | | | These parameters are normally set in the | | | Db2 installation panels DSNTIPI | | | (IRLM PANEL 1) and DSNTIPJ | | | (IRLM PANEL 2). | | | | | | Notes: | | | 1. The SYSOUT data sets of the IRLM | | | started task (IRLMPROC), where the | | | IRLM startup options are specified, | | | must be available. JOBCLASS(STC) | | | OUTPUT must be set to YES and | | | OUTCLASS(x) OUTPUT must be set to | | | PRINT or PUNCH, where x is the | | | JOBCLASS(STC) MSGCLASS value. | | | 2. The user ID who submitted the job | | | which executes DSNTXAZP must have | | | at least READ access to the JES | | | SPOOL JESJCL data set of the IRLM | | | started task (IRLMPROC). | | | 3. The DSNTXAZP module must reside in an | | | APF-authorized library. | | | | |---------------|-------------------------------------------| | UPDATE_LOG | BSDS and active logs parameters: | | | o BSDSNAM1 (BSDS COPY 1 NAME) | | | o BSDSNAM2 (BSDS COPY 2 NAME) | | | o LOGSPRE1 (COPY 1 PREFIX) | | | o LOGSPRE2 (COPY 2 PREFIX) | | | o VBSDSLOG (BSDS AND ACTIVE LOG | | | ICF CATALOG ALIAS) | | | o LOG COPY 1, BSDS 2: | | | o VOLSDAT6 (VOL/SER) | | | o DATACLS6 (SMS DATA CLASS) | | | o MGMTCLS6 (SMS MGMT CLASS) | | | o STORCLS6 (SMS STOR CLASS) | | | o LOG COPY 2, BSDS 1: | | | o VOLSDAT7 (VOL/SER) | | | o DATACLS7 (SMS DATA CLASS) | | | o MGMTCLS7 (SMS MGMT CLASS) | | | o STORCLS7 (SMS STOR CLASS) | | | o LOGSNUM (NUMBER OF LOGS) | | | | | | These parameters are normally set in | | | the Db2 installation panels DSNTIPH | | | (SYSTEM RESOURCE DATA SET NAMES), | | | DSNTIPA4 (BSDS AND ACTIVE LOG), | | | DSNTIPL (ACTIVE LOG DATA SET | | | PARAMETERS) | | | | | | Notes: | | | 1. The SYSOUT data sets of the Db2 | | | started task (ssidMSTR), where the | | | BSDS names are specified, must be | | | available. JOBCLASS(STC) OUTPUT must | | | must be set to YES and OUTCLASS(x) | | | OUTPUT must be set to PRINT or PUNCH, | | | where x is the JOBCLASS(STC) MSGCLASS | | | value. | | | 2. The user ID who submitted the job | | | which executes DSNTXAZP must have | | | at least READ access to the JES | | | SPOOL JESJCL data set of the Db2 | | | started task (ssidMSTR). | | | 3. The DSNTXAZP module must reside in an | | | APF-authorized library. | | | | |---------------|-------------------------------------------| | UPDATE | MVS parmlib and data sharing group | | _MVS_PARMLIB | parameters: | | | a. MVS PARMLIB parameters: | | | o MVSSPREF (COMMAND PREFIX) | | | | | | This parameter is normally set in | | | the Db2 installation panel DSNTIPM | | | (MVS PARMLIB UPDATES). | | | | | | b. Data sharing group parameters: | | | o SGRPATNM (SUBGRP ATTACH) | | | | | | This parameter is normally set in | | | the Db2 installation panel DSNTIPK | | | (DEFINE GROUP OR MEMBER). | | | | |---------------|-------------------------------------------| | UPDATE | Db2-supplied routines parameters: | | _ROUTINE | a. Authorization ID preferences: | | | o AUTHID (ROUTINES CREATOR) | | | o SECDEFID (SEC DEF CREATOR) | | | | | | These parameters are normally set in | | | the Db2 installation panel DSNTIPG | | | (INSTALLATION PREFERENCES). | | | | | | b. Default WLM environment names: | | | o WLMENVG (FOR MOST DB2 ROUTINES) | | | o WLMENVP (FOR ROUTINES IDENTIFIED | | | TO PROGRAM CONTROL) | | | o WLMENV1 (FOR SERIALIZED ROUTINES) | | | o WLMENVU (FOR DB2 UTILITIES ROUTINES) | | | o WLMENVX (FOR DB2 XML PROCESSING | | | ROUTINES) | | | o WLMENVJ (FOR DB2 JAVA ROUTINES) | | | o WLMENVR (FOR DB2 REXX ROUTINES) | | | o WLMENVD (FOR UNIFIED DEBUGGER | | | ROUTINES) | | | o WLMENVC (FOR THE DB2 CICS ROUTINE) | | | o WLMENVM (FOR DB2 MQSERIES ROUTINES) | | | o WLMENVW (FOR DB2 WEB SERVICES | | | ROUTINES) | | | | | | These parameters are normally set in | | | the Db2 installation panel DSNTIPR1 | | | (PARAMETERS FOR DB2-SUPPLIED ROUTINES).| | | | | | c. Access control list, Package owner, | | | WLM application environment: | | | o RTxnnWLM (WLM ENV NAME) | | | o RTxnnACL (GRANT EXECUTE) | | | o RTxnnPKO (PACKAGE OWNER) | | | | | | where x=B, C, D, E, F, G, H, I, J, | | | K, L, M, N, O, P, or Q | | | and nn=01 to 44 | | | | | | These parameters are normally set in | | | the Db2 installation panels | | | DSNTIPRB - DSNTIPRQ (DB2 ROUTINES: | | | ADVANCED CONFIGURATION OPTIONS). | | | | | | d. DSNTIJRT/DSNTRIN optional | | | configuration preferences: | | | o STGIJRT (INDEX STORAGE GROUP) | | | o STOGJRT (DATABASE AND TABLESPACE | | | STORAGE GROUP) | | | | | | These parameters are normally set in | | | the Db2 installation panel DSNTIPG1 | | | (INSTALLATION PREFERENCES PANEL 2). | | | | |---------------|-------------------------------------------| | UPDATE | Work file database and table spaces | | _WKFL_DB | parameters: | | | o WKDBNAME (WORK FILE DB) | | | o S4KNOTS (4K SORT WORK TS'S) | | | o S4KSGSZ (4K SORT WORK SEG SIZE) | | | o S32KNOTS (32K SORT WORK TS'S) | | | o S32KSGSZ (32K SORT WORK SEG SIZE) | | | o T4KNOTS (4K TEMP WORK TS'S) | | | o T4KSGSZ (4K TEMP WORK SEG SIZE) | | | o T32KNOTS (32K TEMP WORK TS'S) | | | o T32KSGSZ (32K TEMP WORK SEG SIZE) | | | | | | These parameters are normally set in the | | | Db2 installation panels DSNTIPK | | | (DEFINE GROUP OR MEMBER) and DSNTIP9 | | | (WORK FILE DATABASE). | | | | |---------------|-------------------------------------------| Currently, the DSNTXAZP 'action' UPDATE_ALL updates the subsystem parameter and buffer pool settings in the CLIST defaults input member (DSNTIDxx). With this enhancement, the DSNTXAZP 'action' UPDATE_ALL updates the subsystem parameter and buffer pool settings as well as all the additional parameters listed in Table 1 above. The online product documentation for Db2 13 for z/OS is updated for the new function in this APAR. To find the changes and related information, search on "PH63793" or the following keywords: - DSNTXAZP - DSNT060I
APAR Information
APAR number
PH63793
Reported component name
DB2 OS/390 & Z/
Reported component ID
5740XYR00
Reported release
D10
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2024-10-21
Closed date
2025-03-27
Last modified date
2025-05-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UO02605
Modules/Macros
DSN@XAZP DSNADMJ4 DSNTIJXZ DSNTXAZC DSNTXAZP
Fix information
Fixed component name
DB2 OS/390 & Z/
Fixed component ID
5740XYR00
Applicable component levels
RD10 PSY UO02605
UP25/04/04 P F504
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEPEK","label":"DB2 for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"D10","Line of Business":{"code":"LOB76","label":"Data Platform"}}]
Document Information
Modified date:
05 May 2025