PI49738: DB2 ADMIN TOOL X'0E' INTERPRETED AS SHIFT-IN IN FOR BIT DATA RETRIEVING CAT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When migrate DB2 CATALOG information, executing the SQLs
  generated saw the following error:
  
      INSERT INTO SYSIBM.SYSCOLDISTSTATS
           (FREQUENCY, STATSTIME, IBMREQD,
           PARTITION, TBOWNER, TBNAME,
            NAME, COLVALUE, TYPE,
            CARDF, COLGROUPCOLNO, NUMCOLUMNS,
            FREQUENCYF,
           LOWVALUE, HIGHVALUE)
         VALUES
           (-1, '2015-09-08-18.07.53.759728', 'N',
             1, 'CCBCNK', 'TBASASS0',
             'CBASASS0_MULTI_TENANCY_ID','', 'C',
             0.000000000000000E+00, '    ',  2,
            -1.000000000000000E+00,
            '',
            '') ;
  SQLERROR ON   INSERT    COMMAND, PREPARE   FUNCTION
  RESULT OF SQL STATEMENT:
  
  DSNT408I SQLCODE = -330, ERROR: A STRING CANNOT BE USED BECAUSE
    IT CANNOT BE PROCESSED. REASON 16, CHARACTER  , HOST VARIABLE
  
  DSNT418I SQLSTATE = 22021 SQLSTATE RETURN CODE
  DSNT415I SQLERRP  = DSNXEDP SQL PROCEDURE DETECTING ERROR
  DSNT416I SQLERRD  = -109  0  0  -1  0  0 SQL DIAGNOSTIC INFO
  DSNT416I SQLERRD  = X'FFFFFF93' X'00000000' X'00000000'
    X'FFFFFFFF' X'00000000'  X'00000000' SQL DIAGNOSTIC INFO
  
  Found the value in COLGROUPCOLNO was X'000100020003000E0004'.
  DB2 interpreted the x'0E' as shift-in symbol of double-byte
  charactors and because no X'0F' shift-out, DB2 treated as
  an error.  This data should not be consider for conversion,
  shift-in/shift-on.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the DB2 Administration Tool for     *
  *                 z/OS who use the Generate (GEN) and          *
  *                 Migrate (MIG) functions.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using the GEN or MIG functions to  *
  *                      generate DML (INSERT, UPDATE, DELETE)   *
  *                      for the statistics catalog tables,      *
  *                      the INSERT statement against the        *
  *                      statistics catalog table                *
  *                      SYSIBM.SYSCOLDISTSTATS uses string      *
  *                      data format as the value of column      *
  *                      COLGROUPCOLNO instead of HEX            *
  *                      format, which may cause a SQLCODE=      *
  *                      -330 / SQLCODEN330 while the INSERT     *
  *                      statement is executed.                  *
  *                                                              *
  *                      For example, in the following INSERT    *
  *                      statement, the value of column          *
  *                      COLGROUPCOLNO contains character X'0E'  *
  *                      in the string. In a DBCS environment,   *
  *                      DB2 interprets the X'0E' as a shift-in  *
  *                      symbol of double-byte characters. As    *
  *                      there is no shift-out character X'0F'   *
  *                      in the string, DB2 issues a             *
  *                      SQLCODE=-330 / SQLCODEN330 error:       *
  *                                                              *
  *                      INSERT INTO SYSIBM.SYSCOLDISTSTATS      *
  *                         (FREQUENCY, STATSTIME, IBMREQD,      *
  *                          PARTITION, TBOWNER, TBNAME,         *
  *                          NAME, COLVALUE, TYPE,               *
  *                          CARDF, COLGROUPCOLNO, NUMCOLUMNS,   *
  *                          FREQUENCYF,                         *
  *                          LOWVALUE, HIGHVALUE)                *
  *                           VALUES                             *
  *                          (-1, '2015-09-08-18.07.53.759728',  *
  *                             'N', 1, 'XXXXXX', 'XXXXXXXX',    *
  *                             'XXXXXXXX_XXXXX_XXXXXXX_XX','',  *
  *                             'C', 0.000000000000000E+00, '    *
  *                             ', 2, -1.000000000000000E+00,    *
  *                              '',                             *
  *                             '') ;                            *
  *                      SQLERROR ON   INSERT    COMMAND,        *
  *                      PREPARE  FUNCTION RESULT OF SQL         *
  *                      STATEMENT:                              *
  *                                                              *
  *                      DSNT408I SQLCODE = -330, ERROR:         *
  *                      A STRING CANNOT BE USED BECAUSE IT      *
  *                      CANNOT BE PROCESSED. REASON 16          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When using the GEN or MIG functions to generate DML (INSERT,
  UPDATE,DELETE) for the statistics catalog tables, the INSERT
  statement against the statistics catalog table
  SYSIBM.SYSCOLDISTSTATS uses string data format as the value
  of column COLGROUPCOLNO instead of HEX format, which may
  cause a SQLCODE=-330 / SQLCODEN330 error while the INSERT
  statement is executed.
  

Problem conclusion

• The problem has been resolved.  The HEX data format is now
  used in the INSERT statement for the value of column
  COLGROUPCOLNO.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI33083 UI33084 UI33085

Modules/Macros

•    ADB2RES
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RA20 PSY UI33083

     UP15/11/20 P F511

• RB10 PSY UI33084

     UP15/11/20 P F511

• RB20 PSY UI33085

     UP15/11/20 P F511

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.