A fix is available
APAR status
Closed as program error.
Error description
MIG FUNCTION IN ADMIN TOOL DOES NOT GENERATE DD FOR UNLOAD, AND PUNCHDDN HAS UNRESOLVED TSNAME USING &SN
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of the DB2 Administration Tool for * * z/OS who use the Migrate (MIG) function * * to migrate objects using a user defined * * PUNCHDDN template which contains the * * symbolic &SN or is a GDG. * **************************************************************** * PROBLEM DESCRIPTION: The DB2 Administration Tool for z/OS * * MIG function generates a PUNCHDDN * * which resolves the symbolic variable * * &SN to the string SN instead of the * * expected table space name when using * * a user defined PUNCHDDN template. * **************************************************************** * RECOMMENDATION: * **************************************************************** The DB2 Administration Tool for z/OS MIG function generates a PUNCHDDN which resolves the symbolic variable &SN to the string SN instead of the expected table space name when using a user defined PUNCHDDN template.
Problem conclusion
The program has been modified to resolve the symbolic variable &SN to the table space name for a user defined PUNCHDDN template. The DB2 Administration Tool User's Guide has also been updated to reflect this change. Additionally, Chapter 11 - 'Using LISTDEFs and TEMPLATEs in the DB2 Administration Tool User's Guide describes how PUNCHDDN is handled. The paragraph description is only for the Work Statement List (WSL) path. However, it should be also applied to the JCL path. The DB2 Administration Tool User's Guide has been updated to add the description for the JCL path. When users use a GDG attribute (+1) to define the templates PUNCHDDN, MICTLOV or MICTLOU for DB2 Unload, the template MICTLIU, MIDTVNP or MICTLOU for HPU Unload, and then use them in MIG, the MIG JCL will result in a JCL ERROR due to the non-existence of the GDG base for these template DD statements. In this case, a confirmation panel ADB2CONF 'Warning ON Template Usage' will be displayed to show the following warning messages: The warning message for DB2 Unload in MIG: The GDG base of the data set defined in template PUNCHDDN, MICTLOV or MICTLOU does not exist. Migrate job will fail due to a JCL ERROR after submitting. The warning message for HPU Unload in MIG: The GDG base of the data set defined in template MICTLIU, MIDTVNP or MICTLOU does not exist. Migrate job will fail due to a JCL ERROR after submitting. On panel ADB2CONF, users can choose CONTINUE to generate MIG jobs and then define the GDG base for above templates DD statements before submitting the JCL to avoid a JCL ERROR. Users can also choose CANCEL to stop generating MIG jobs and go back to panel ADB28M 'Migrate Parameters'. In the DB2 Administration Tool Version 10.1 and Version 7.2 User's Guide Chapter 11 'Using LISTDEFs and TEMPLATEs', the section named 'Substitution variables in utility templates for PUNCHDDN when using a WSL' has been changed to 'Substitution variables in utility templates for PUNCHDDN' to describe how PUNCHDDN is handled both for the WSL and JCL path. Under this section, replacement value for symbolic variable &SN used in template PUNCHDDN has also been changed from 'SN' to 'The table space'.
Temporary fix
Comments
APAR Information
APAR number
PM52417
Reported component name
DB2 ADMIN TOOL
Reported component ID
568851500
Reported release
A10
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-11-16
Closed date
2012-04-26
Last modified date
2012-05-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK78296 UK78297
Modules/Macros
ADBH5TD ADB2DSN ADB28M
Fix information
Fixed component name
DB2 ADMIN TOOL
Fixed component ID
568851500
Applicable component levels
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":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSCVQTD","label":"IBM Db2 Administration Tool for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Document Information
Modified date:
02 May 2012