IBM Support

IT25029: RESTORE FROM INCREMENTAL BACKUP WITH MULTIPLE STREAMS - DB2 MAY ERROR SQL2032N THE "BUFFER_NUM" PARAMETER IS NOT VALID. SQLSTATE

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When running restore with multiple streams (Mostly when using
    incremental backups)
    
    Example
    
    restore database SAMPLE incremental from
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.001.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.002.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.003.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.004.db"
    dbpath on '/home/db2inst1' into SAMPLE1
    newlogpath '/home/db2inst1/db2restore/activeLogs/'
    replace history file replace existing redirect without prompting
    
    SQL2032N The "buffer_num" parameter is not valid. SQLSTATE=22531
    
    Diaglog:
    
    The number of buffer db2 automatically picked up for this
    incremental restore is 1 which is less than the number of pipe
    sessions (that is, 4).
    
    2018-05-05-20.45.20.669430-240 E1607877281E545      LEVEL: Info
    PID    : 154282              TID : 140732438406912 PROC :
    db2sysc 0
    INSTANCE: db2inst1            NODE : 000           DB  : SAMPLE1
    APPHDL : 0-530               APPID: *LOCAL.db2inst1.180506004520
    AUTHID : AUTH1               HOSTNAME: HOST1
    EDUID  : 206                 EDUNAME: db2agent (SAMPLE1) 0
    FUNCTION: DB2 UDB, database utilities, sqludTuneBuffers,
    probe:903
    DATA #1 : <preformatted>
    Autonomic restore - tuning enabled.
    Using buffer size = 2817, number = 1.
    
    2018-05-05-20.45.20.669489-240 E1607877827E602      LEVEL:
    Severe
    PID    : 154282              TID : 140732438406912 PROC :
    db2sysc 0
    INSTANCE: db2inst1            NODE : 000           DB  : SAMPLE1
    APPHDL : 0-530               APPID: *LOCAL.db2inst1.180506004520
    AUTHID : AUTH1               HOSTNAME: HOST1
    EDUID  : 206                 EDUNAME: db2agent (SAMPLE1) 0
    FUNCTION: DB2 UDB, database utilities, sqludSetUp2, probe:2768
    DATA #1 : Sqlcode, PD_TYPE_SQLCODE, 4 bytes
    -2032
    DATA #2 : Hexdump, 15 bytes
    0x00007FFF4D7048F0 : 10F8 FFFF 6275 6666 6572 5F6E 756D 00
    ....buffer_num.
    
    2018-05-05-20.45.20.669549-240 E1607878430E925      LEVEL:
    Severe
    PID    : 154282              TID : 140732438406912 PROC :
    db2sysc 0
    INSTANCE: db2inst1            NODE : 000           DB  : SAMPLE1
    APPHDL : 0-530               APPID: *LOCAL.db2inst1.180506004520
    AUTHID : AUTH1               HOSTNAME: HOST1
    EDUID  : 206                 EDUNAME: db2agent (SAMPLE1) 0
    FUNCTION: DB2 UDB, database utilities, sqludSetUp2, probe:2768
    MESSAGE : SQL2032N The "" parameter is not valid.
    DATA #1 : SQLCA, PD_DB2_TYPE_SQLCA, 136 bytes
    sqlcaid : SQLCA    sqlcabc: 136  sqlcode: -2032  sqlerrml: 10
    sqlerrmc: buffer_num
    sqlerrp : sqludSet
    sqlerrd : (1) 0x00000000     (2) 0x00000000     (3) 0x00000000
              (4) 0x00000000     (5) 0x00000000     (6) 0x00000000
    sqlwarn : (1)     (2)     (3)     (4)       (5)      (6)
              (7)     (8)     (9)     (10)       (11)
    sqlstate:?
    

Local fix

  • Local Fix - Provide "WITH 64 buffers buffer 4098"
    
    restore database SAMPLE incremental from
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.001.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.002.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.003.db",
    "/home/db2inst1/db2inst1.SAMPLE.NODE $N+1000
    .CATN0000.20180505020029.004.db"
    dbpath on '/home/db2inst1' into SAMPLE1
    newlogpath '/home/db2inst1/db2restore/activeLogs/'
    WITH 64 buffers buffer 4098
    replace history file replace existing redirect without prompting
    
    SQL1277W A redirected restore operation is being performed.
    During a table
    space restore, only table spaces being restored can have their
    paths
    reconfigured. During a database restore, storage group storage
    paths and DMS
    table space containers can be reconfigured.
    DB20000I The RESTORE DATABASE command completed successfully.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * ALL                                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See Error Description                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Upgrade to Db2 11.1 Mod 4 Fixpack 4 or higher                *
    ****************************************************************
    

Problem conclusion

  • First fixed in Db2 11.1 Mod 4 Fixpack 4
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT25029

  • Reported component name

    DB2 FOR LUW

  • Reported component ID

    DB2FORLUW

  • Reported release

    B10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-05-10

  • Closed date

    2018-11-27

  • Last modified date

    2018-11-27

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

    IT25024

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

Fix information

  • Fixed component name

    DB2 FOR LUW

  • Fixed component ID

    DB2FORLUW

Applicable component levels

  • RB10 PSN

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEPGG","label":"DB2 for Linux, UNIX and Windows"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.1","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
27 November 2018